การลงทะเบียนและการจัดการเอเจนต์ย่อย
การลงทะเบียนและการจัดการเอเจนต์ย่อย
ภาพรวม
หน้าการจัดการเอเจนต์ย่อยใช้สำหรับลงทะเบียนล่วงหน้าเอเจนต์ย่อยที่มีการกำหนดค่าเฉพาะ เอเจนต์ย่อยที่ลงทะเบียนล่วงหน้าจะถูกฉีดเข้าไปในระบบพรอมป์ของ Agent หลักโดยอัตโนมัติ และ Agent จะเลือกเรียกใช้โดยอัตโนมัติเมื่อพบงานที่ตรงกัน
การกำหนดค่าเอเจนต์ย่อยแบบลงทะเบียนล่วงหน้า
การกำหนดค่าพื้นฐาน
| พารามิเตอร์ | คำอธิบาย | จำเป็น |
|---|---|---|
name |
ชื่อเอเจนต์ย่อย | ใช่ |
description |
คำอธิบายความสามารถ (ฉีดเข้าไปในระบบพรอมป์ของ Agent แม่) | ใช่ |
systemPrompt |
นิยามตัวตน/บทบาท | ใช่ |
การกำหนดค่าเครื่องมือ
| พารามิเตอร์ | คำอธิบาย |
|---|---|
tools |
รายการอนุญาตเครื่องมือ (หากละไว้จะสืบทอดเครื่องมือทั้งหมดจากระดับแม่) |
disallowedTools |
รายการห้ามเครื่องมือ (ยกเว้นบนพื้นฐานที่สืบทอดมา) |
skills |
รายการ ID ทักษะที่ใช้ได้ |
mcpServers |
รายการชื่อเซิร์ฟเวอร์ MCP ที่ใช้ได้ |
การกำหนดค่าการทำงาน
| พารามิเตอร์ | คำอธิบาย | ค่าเริ่มต้น |
|---|---|---|
model |
แทนที่โมเดล LLM ของระดับแม่ | สืบทอดจากระดับแม่ |
maxTurns |
จำนวนรอบลูปสูงสุด | 50 |
canSpawn |
สามารถสร้างเอเจนต์ย่อยระดับล่างได้หรือไม่ | false |
maxSpawnDepth |
ความลึกซ้อนสูงสุด (1-3) | 1 |
การดำเนินการจัดการ
| การดำเนินการ | คำอธิบาย |
|---|---|
| เพิ่ม | สร้างเอเจนต์ย่อยแบบลงทะเบียนล่วงหน้าใหม่ |
| แก้ไข | แก้ไขการกำหนดค่าเอเจนต์ย่อยที่มีอยู่ |
| ลบ | นำเอเจนต์ย่อยแบบลงทะเบียนล่วงหน้าออก |
| จัดเรียง | ปรับลำดับของเอเจนต์ย่อยในรายการ |
การเชื่อมโยงกับบทสนทนา Work
เอเจนต์ย่อยแบบลงทะเบียนล่วงหน้าเชื่อมโยงกับบทสนทนา Work ผ่านวิธีการดังต่อไปนี้:
- การฉีดระบบพรอมป์:
nameและdescriptionของเอเจนต์ย่อยจะถูกแสดงอยู่ในระบบพรอมป์ของ Agent หลัก - การจับคู่อัตโนมัติ: LLM เลือกเอเจนต์ย่อยที่เหมาะสมโดยอัตโนมัติตามความหมายของข้อความผู้ใช้
- การเรียกใช้ด้วยตนเอง: ผู้ใช้สามารถระบุให้ใช้เอเจนต์ย่อยตัวใดตัวหนึ่งในบทสนทนาได้
ตัวอย่างสถานการณ์การใช้งาน
| ชื่อเอเจนต์ย่อย | คำอธิบาย | เครื่องมือความเชี่ยวชาญ |
|---|---|---|
| ผู้ตรวจสอบโค้ด | รับผิดชอบการตรวจสอบโค้ดและการวิเคราะห์คุณภาพ | Read File, Search Files, Glob |
| ผู้เขียนเอกสาร | รับผิดชอบการเขียนและจัดรูปแบบเอกสาร | Write File, Edit, Web Fetch |
| ผู้ช่วยวิจัย | รับผิดชอบการค้นหาข้อมูลและรวบรวมข้อมูล | Web Fetch, Search Files |
| นักวิเคราะห์ข้อมูล | รับผิดชอบการประมวลผลและวิเคราะห์ข้อมูล | Bash, Read File, Write File |
คู่มือการดำเนินการ: สร้างเอเจนต์ย่อยแบบลงทะเบียนล่วงหน้า
ขั้นตอน
- เปิด APP → การตั้งค่า → เอเจนต์ย่อย
- คลิก เพิ่มเอเจนต์ย่อย
- กรอกข้อมูลพื้นฐาน:
- ชื่อ: เช่น "ผู้ตรวจสอบโค้ด"
- คำอธิบาย: เช่น "รับผิดชอบการตรวจสอบคุณภาพโค้ด ค้นหา bug ที่อาจเกิดขึ้นและข้อเสนอแนะในการปรับปรุง" (คำอธิบายนี้จะถูกฉีดเข้าไปในระบบพรอมป์ของ Agent หลัก เพื่อช่วยให้ Agent ตัดสินใจว่าเมื่อใดควรเรียกใช้)
- ระบบพรอมป์: เช่น "คุณคือผู้เชี่ยวชาญตรวจสอบโค้ดระดับอาวุโส ให้ความสำคัญกับคุณภาพโค้ด ประสิทธิภาพ ความปลอดภัย และความสามารถในการบำรุงรักษา..."
- (ทางเลือก) กำหนดค่ารายการอนุญาต/ห้ามเครื่องมือ
- (ทางเลือก) แทนที่โมเดลหรือปรับ maxTurns
- บันทึก
ตัวอย่างการกำหนดค่า: เอเจนต์ย่อย "ผู้ตรวจสอบโค้ด"
名称: 代码审查员
描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。
系统提示: 你是一位资深代码审查专家。你的职责是：
1. 分析代码质量和可维护性
2. 发现潜在的 bug 和安全漏洞
3. 提供具体的优化建议
请对每个问题给出严重等级（低/中/高）和修复建议。
工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改）
模型: Claude Sonnet 4（推理能力强）
maxTurns: 30
canSpawn: false（不需要再委派）
名称: 代码审查员
描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。
系统提示: 你是一位资深代码审查专家。你的职责是：
1. 分析代码质量和可维护性
2. 发现潜在的 bug 和安全漏洞
3. 提供具体的优化建议
请对每个问题给出严重等级（低/中/高）和修复建议。
工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改）
模型: Claude Sonnet 4（推理能力强）
maxTurns: 30
canSpawn: false（不需要再委派）
บล็อกโค้ดนี้ในหน้าต่างลอย
ผลกระทบที่แท้จริงของ maxSpawnDepth
| การตั้งค่า | ความหมาย | สถานการณ์ที่เหมาะสม | ผลกระทบต่อค่าใช้จ่าย |
|---|---|---|---|
| 1（ค่าเริ่มต้น） | เอเจนต์ย่อยไม่สามารถสร้างเอเจนต์ย่อยระดับล่างได้อีก | งานเฉพาะทางที่เรียบง่าย | ต่ำ |
| 2 | เอเจนต์ย่อยสามารถสร้างเอเจนต์ย่อยได้อีกหนึ่งชั้น | งานที่ซับซ้อนปานกลาง ต้องการการแยกย่อยครั้งที่สอง | ปานกลาง |
| 3 | ความลึกซ้อนสูงสุด อนุญาตการมอบหมายสามระดับ | งานหลายขั้นตอนที่ซับซ้อนสูง | สูง (เอเจนต์ย่อยแต่ละระดับใช้ token อย่างอิสระ) |
หมายเหตุ: เอเจนต์ย่อยทุกระดับจะเริ่ม Agent Loop ที่เป็นอิสระ (ค่าเริ่มต้น 50 รอบ) และใช้ token ของ LLM อย่างอิสระ ความลึก 3 หมายความว่าอาจมี Agent มากถึง 4 ตัวทำงานพร้อมกัน (หลัก + เอเจนต์ย่อย 3 ระดับ) ค่าใช้จ่ายอาจเป็นหลายเท่าของ Agent เดียว
ลงทะเบียนล่วงหน้า vs สร้างอัตโนมัติ: เลือกอย่างไร?
| การเปรียบเทียบ | ลงทะเบียนล่วงหน้า (dispatch_sub_agent) | สร้างอัตโนมัติ (create_local_sub_agent) |
|---|---|---|
| การกำหนดค่า | กำหนดค่าไว้ล่วงหน้า ทำครั้งเดียวใช้ได้ตลอด | Agent สร้างชั่วคราวตามความต้องการทุกครั้ง |
| ความสม่ำเสมอ | ใช้การกำหนดค่าเดิมทุกครั้ง ผลลัพธ์เสถียร | Agent อาจให้ตัวตนและเครื่องมือที่ต่างกันทุกครั้ง |
| สถานการณ์ที่เหมาะสม | บทบาทเฉพาะทางที่ใช้ซ้ำบ่อยครั้ง | การแยกย่อยงานชั่วคราวแบบครั้งเดียว |
| ระบบพรอมป์ | ฉีดเข้า Agent หลักโดยอัตโนมัติ Agent รู้ว่าสามารถใช้ได้ | Agent ตัดสินใจเองว่าจะสร้างหรือไม่ |
คำแนะนำ: หากคุณต้องการงานบางประเภทบ่อยครั้ง (เช่น การตรวจสอบโค้ด การเขียนเอกสาร การวิเคราะห์ข้อมูล) ให้สร้างเอเจนต์ย่อยแบบลงทะเบียนล่วงหน้า สำหรับการแยกย่อยงานชั่วคราวเป็นครั้งคราว ให้ Agent สร้างอัตโนมัติก็เพียงพอ
เอกสารที่เกี่ยวข้อง
- ระบบเอเจนต์ย่อย — การใช้งานเอเจนต์ย่อยใน Work
- การจัดการเครื่องมือ — เครื่องมือที่เอเจนต์ย่อยใช้ได้
- เอนจินลูป Agent — Agent Loop ที่เอเจนต์ย่อยใช้