30 秒看懂整体
用户
→
主智能体（编排）
→
检索（找能力）
→
主智能体
→
执行（跑能力）
→
主智能体
→
用户
核心约束：主智能体没有任何工具；
能力抽象 = Skills（本地技能） | 外部 SubAgent API（HTTP 调用）。
STEP 01
有哪些智能体
三个 AgentScope 智能体 + 一层能力资源。先分清「谁在协作」和「谁是被调用的能力」。
BOUNDARY
职责边界对照
用一张表看清「负责什么 / 不负责什么 / 有没有工具」，避免三个智能体职责混在一起。
| 智能体 |
负责什么 |
不负责什么 |
工具 |
| 主智能体 |
理解任务、调度检索/执行、汇总回复用户 |
自己去查库或调用 Skills / HTTP |
无 |
| 能力检索智能体 |
按任务语义找适合能力，把能力描述写入提示词 |
真正执行能力、直接回复用户 |
数据库查询 |
| 能力执行智能体 |
按检索结果选择并执行能力，回传结果 |
决定整体协作策略、维护能力库 |
Skills 调用
外部 SubAgent HTTP |
STEP 02
它们怎么协作
从用户任务到最终回复的完整步骤。注意：检索结果会先回到主智能体，再交给执行智能体。
STEP 03
一次任务的消息时序
用时序图看「谁在什么时候跟谁说话」。适合核对协作协议与工具调用时机。
EXAMPLE
最小例子：总结一份 PDF
把抽象链路落到一个具体任务上，帮助快速建立直觉。
若检索到的是外部能力，执行阶段会走「HTTP SubAgent」而不是 Skills；主链路不变，只换执行工具。