AI Agents: เพิ่มความปลอดภัยในการเปลี่ยนแปลงโปรเจกต์

นี่คือซีรีส์ 10 ตอนที่แบ่งปันว่า Apidog พัฒนา Apidog CLI ซึ่งเป็นเครื่องมือบรรทัดคำสั่งสำหรับการทดสอบ API และการจัดการวงจรชีวิต API ได้อย่างไร อ่านตามลำดับหรือข้ามไปยังโพสต์ใดก็ได้ที่คุณสนใจ:

เมื่อ Agent แก้ไขทรัพยากรโปรเจกต์ ความปลอดภัยและการตรวจสอบเป็นสิ่งสำคัญ AI Branch มอบสภาพแวดล้อมการแก้ไขที่แยกจากกัน โดยการเปลี่ยนแปลงจะเข้าสู่สาขาเป้าหมายก็ต่อเมื่อได้รับการยืนยันจากมนุษย์แล้วเท่านั้น

ความท้าทายด้านความปลอดภัย

เมื่อ AI Agents เข้าร่วมในการพัฒนาและทดสอบ API พวกเขาสามารถสร้าง อัปเดต และลบทรัพยากรโปรเจกต์ผ่านคำสั่ง CLI ได้

อำนาจนี้มาพร้อมกับความเสี่ยง

คุณจะให้ Agent ทำงานในโปรเจกต์จริงได้อย่างไรโดยไม่เสี่ยงต่อสาขาหลัก?

AI Branch: ชั้นความปลอดภัย

AI Branch เป็น Sprint Branch ประเภทพิเศษที่ออกแบบมาโดยเฉพาะสำหรับการทำงานของ AI ภายนอกและ CLI

แนวคิดหลัก:

การดำเนินการแก้ไขทั้งหมดที่เริ่มต้นจาก Apidog CLI จะถูกถือว่าเริ่มต้นโดย AI / AI Agents โดยค่าเริ่มต้น

AI Branch มอบ สาขาการแก้ไขที่แยกจากกัน ให้กับ AI Agents การเปลี่ยนแปลงจะยังคงอยู่ใน AI Branch จนกว่ามนุษย์จะตรวจสอบและรวมเข้าด้วยกัน

Agent ทำการเปลี่ยนแปลงผ่าน CLI
        ↓
การเปลี่ยนแปลงถูกเก็บไว้ใน AI Branch (แยก)
        ↓
ผู้ใช้ตรวจสอบความแตกต่าง
        ↓
ผู้ใช้ยืนยันขอบเขตของทรัพยากร
        ↓
รวมไปยังสาขาเป้าหมาย (โดยตรงหรือคำขอรวม)

สาขาหลักจะไม่ถูกแตะต้องจนกว่าคุณจะอนุมัติ

ทำไมต้องมี AI Branch

การแก้ไขที่เริ่มต้นโดย AI อาจคาดเดาไม่ได้ Apidog CLI มีความสามารถในการแก้ไขที่หลากหลาย เช่น endpoints, schemas, test scenarios, test suites และอื่นๆ

AI Branch ได้รับการออกแบบมาสำหรับการดำเนินการแก้ไขที่เริ่มต้นโดย AI ที่มีความเสี่ยงสูงเหล่านี้

ช่วยให้ AI Agents แก้ไขทรัพยากรโปรเจกต์ภายในขอบเขตที่ควบคุมได้:

AI Branch คืออะไร?

AI Branch เป็น sprint branch พิเศษ ที่มีลักษณะเฉพาะ:

คุณสมบัติหลัก

วิธีการทำงาน

การแก้ไขภายใน client โดยผู้ใช้ปกติยังคงปฏิบัติตามสิทธิ์ของสมาชิกโปรเจกต์และกฎการป้องกันสาขา

กรณีการใช้งาน

AI Branch เหมาะสมเมื่อ AI ต้องเข้าร่วมในการบำรุงรักษาโปรเจกต์ ในขณะที่ยังคงรักษาการแยกสาขาและการยืนยันโดยมนุษย์

เวิร์กโฟลว์พื้นฐาน

เวิร์กโฟลว์ AI Branch ทั่วไป:

┌─────────────────────────────────────────────────────────────────┐
│                     เวิร์กโฟลว์ AI BRANCH                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ขั้นตอนที่ 1: สร้าง AI Branch                                        │
│  ┌───────────────────────────────────────────┐                  │
│  │ apidog branch create --type ai             │                  │
│  │ --name "ai/20260312-from-main-feature"     │                  │
│  │ --from main                                │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  ขั้นตอนที่ 2: นำเข้าหรือสร้างทรัพยากร                              │
│  ┌───────────────────────────────────────────┐                  │
│  │ apidog branch pick-to (นำเข้าที่มีอยู่)    │                  │
│  │ หรือ                                         │                  │
│  │ apidog endpoint create (สร้างใหม่)        │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  ขั้นตอนที่ 3: AI แก้ไขทรัพยากร                                   │
│  ┌───────────────────────────────────────────┐                  │
│  │ Agent ใช้ CLI เพื่ออัปเดต endpoints,       │                  │
│  │ schemas, test scenarios ฯลฯ             │                  │
│  │ (พารามิเตอร์ --branch ระบุ AI Branch)  │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  ขั้นตอนที่ 4: ผู้ใช้ตรวจสอบความแตกต่าง                                │
│  ┌───────────────────────────────────────────┐                  │
│  │ apidog merge-request preview              │                  │
│  │ หรือ                                         │                  │
│  │ ดูใน Apidog client                     │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  ขั้นตอนที่ 5: รวมไปยังสาขาเป้าหมาย                                  │
│  ┌───────────────────────────────────────────┐                  │
│  │ การรวมโดยตรง (สาขาที่ไม่ได้ป้องกัน)         │                  │
│  │ หรือ                                         │                  │
│  │ คำขอรวม (สาขาที่ป้องกัน)          │                  │
│  └───────────────────────────────────────────┘                  │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

สร้าง AI Branch

ใช้ branch create --type ai:

apidog branch create \
  --project 123456 \
  --type ai \
  --name "ai/20260312-from-main-userRegister" \
  --from main

คำแนะนำในการตั้งชื่อ: ai/YYYYMMDD-from-sourceBranch-featureOrModule

แก้ไขทรัพยากรใน AI Branch

เมื่อ CLI เขียนทรัพยากรโปรเจกต์ ให้ใช้พารามิเตอร์ --branch เพื่อเขียนลงใน AI Branch:

เวิร์กโฟลว์ที่แนะนำ:

# 1. รับ schema
apidog cli-schema get endpoint-create

# 2. ตรวจสอบความถูกต้องก่อนเขียน
apidog cli-schema validate endpoint-create --file ./endpoint.json

# 3. เขียนไปยัง AI Branch (ไม่ใช่ main)
apidog endpoint create \
  --project 123456 \
  --branch "ai/20260312-from-main-userRegister" \
  --file ./endpoint.json

นำเข้าทรัพยากรที่มีอยู่

หากต้องการแก้ไขทรัพยากรที่มีอยู่ ให้นำเข้าจากสาขาต้นทางก่อน:

apidog branch pick-to \
  --project 123456 \
  --from main \
  --to "ai/20260312-from-main-userRegister" \
  --endpoint-ids 1001,1002

สิ่งนี้ช่วยให้มั่นใจว่า AI ทำงานกับเวอร์ชันฐานที่ถูกต้อง

ตรวจสอบการเปลี่ยนแปลงก่อนการรวม

ก่อนการรวม ให้ดูตัวอย่างความแตกต่าง:

apidog merge-request preview \
  --project 123456 \
  --from "ai/20260312-from-main-userRegister" \
  --to main

หรือดูความแตกต่างฉบับเต็มใน Apidog client

รวม AI Branch

หลังจากตรวจสอบแล้ว ให้รวมการเปลี่ยนแปลง:

การรวมโดยตรง (สาขาที่ไม่ได้ป้องกัน)

apidog branch merge \
  --project 123456 \
  --from "ai/20260312-from-main-userRegister" \
  --to main \
  --endpoint-ids 1001,1002

คำขอรวม (สาขาที่ป้องกัน)

apidog merge-request create \
  --project 123456 \
  --from "ai/20260312-from-main-userRegister" \
  --to main \
  --reviewer-ids 20001,20002 \
  --endpoint-ids 1001,1002

สำคัญ: คำสั่ง Merge จะประมวลผลเฉพาะรายการทรัพยากรที่ระบุไว้อย่างชัดเจนเท่านั้น ยืนยันการพึ่งพากัน (ไดเรกทอรี, โมเดล, คอมโพเนนต์การตอบกลับ, การทดสอบ) ก่อนการรวม

การเก็บถาวรและการลบ

หลังจากที่การเปลี่ยนแปลงถูกรวมหรือไม่จำเป็นอีกต่อไป:

# เก็บถาวร
apidog branch archive "ai/20260312-from-main-userRegister" \
  --project 123456 --type ai

# ลบ (หลังจากเก็บถาวร)
apidog branch delete "ai/20260312-from-main-userRegister" \
  --project 123456 --type ai

สิทธิ์การแก้ไขของ AI ภายนอก

โดยค่าเริ่มต้น CLI จะเขียนลงใน AI Branch ซึ่งจะทำให้การเปลี่ยนแปลงที่สร้างโดย AI ถูกแยกไว้จนกว่าผู้ใช้จะยืนยัน

หากต้องการเปิดใช้งานการแก้ไขสาขาหลักโดยตรง:

การตั้งค่าโปรเจกต์ (Project Settings) → การตั้งค่าคุณสมบัติ (Feature Settings) → การตั้งค่าคุณสมบัติ AI (AI Feature Settings) → สิทธิ์การแก้ไขของ AI ภายนอก (External AI Edit Permissions)

คำแนะนำ: ให้คงการแยก AI Branch ไว้ เปิดใช้งานการแก้ไขโดยตรงเฉพาะเมื่อเวิร์กโฟลว์อัตโนมัติจำเป็นต้องใช้จริงๆ เท่านั้น

แนวทางปฏิบัติที่ดีที่สุด

AI Branch ในเวิร์กโฟลว์ CLI + SKILL

AI Branch ทำงานร่วมกับ CLI + SKILL ได้อย่างเป็นธรรมชาติ:

ทุกการเขียนจะผ่าน AI Branch → การตรวจสอบโดยมนุษย์ → การรวม

สรุปความปลอดภัย

ชั้นเหล่านี้รวมกันสร้างวงจรที่ปลอดภัยยิ่งขึ้นสำหรับการเปลี่ยนแปลงโปรเจกต์ที่ขับเคลื่อนโดย Agent

อะไรต่อไป

เมื่อ AI Branch มอบชั้นความปลอดภัยแล้ว ทุกส่วนก็พร้อมใช้งาน:

• MCP สำหรับการเชื่อมต่อเครื่องมือ (ส่วนที่ 1)
• CLI + SKILL สำหรับการดำเนินการเวิร์กโฟลว์ (ส่วนที่ 2-5)
• ผลลัพธ์การตรวจสอบ (ส่วนที่ 6)
• เวิร์กโฟลว์เชิงปฏิบัติ (ส่วนที่ 7)
• รากฐาน CI/CD (ส่วนที่ 8)
• AI Branch เพื่อความปลอดภัย (ส่วนที่ 9)

ตอนนี้ถึงเวลาสำหรับวิสัยทัศน์แล้ว

ในส่วนที่ 10 Spec-First เป็นเรื่องของเมื่อวาน ยินดีต้อนรับสู่ Skill-First. เราจะสรุปว่าการพัฒนา API จะพัฒนาไปพร้อมกับ AI Agents ได้อย่างไร—และสิ่งที่ทีมควรทำต่อไป

ประเด็นสำคัญ

• AI Branch ให้การแก้ไขที่แยกจากกันสำหรับการดำเนินการของ AI/CLI
• การเปลี่ยนแปลงจะไม่ส่งผลกระทบต่อสาขาหลักจนกว่าจะได้รับการยืนยันจากมนุษย์
• สร้างด้วย branch create --type ai, เขียนด้วยพารามิเตอร์ --branch
• นำเข้าทรัพยากรที่มีอยู่ด้วย branch pick-to ก่อนแก้ไข
• ดูตัวอย่างด้วย merge-request preview จากนั้นรวมหรือสร้างคำขอรวม
• สิทธิ์การแก้ไขโดยตรงสามารถข้าม AI Branch ได้—ใช้ด้วยความระมัดระวัง
• แนวทางปฏิบัติที่ดีที่สุด: หนึ่ง AI Branch ต่องาน, ตรวจสอบความถูกต้องก่อนเขียน, ตรวจสอบก่อนรวม

ดาวน์โหลด Apidog เพื่อ ออกแบบ, จำลอง, ทดสอบ, และ จัดทำเอกสาร API ในพื้นที่ทำงานเดียว เรียนรู้เพิ่มเติมเกี่ยวกับ Apidog CLI สำหรับการทดสอบ API ผ่านบรรทัดคำสั่ง, การทำงานอัตโนมัติ CI, และเวิร์กโฟลว์ AI Agent