SuperAPI AI 工具集

subagents

智能体与模型

查看项目

更新于 10-15 21:35

技能介绍

该技能用于把任务委派给其他智能体,并通过两个代码模式工具完成调度与结果回收:call_subagent 负责派发,wait_for_subagents 负责收集后台运行结果,需在 run_sdk_snippet 中通过 sdk.tool.call(...) 执行。Agent 是通用技术术语,Crew 指市场上以数字员工形式呈现的自定义智能体;内置 Agent 不应称为 Crew。

适用场景:任务足够大、需要隔离执行上下文;多个独立任务可并行;需要专用类型(只读探索、偏 shell 的工作)。不适合:任务很小可直接完成;需要持续访问当前对话状态;多个子智能体无合并方案却写同一文件;无法把完整上下文压缩成自包含提示。深度限制:子智能体不能再调用 call_subagent,只有根智能体可以派发。

选择目标:用户给出内置名、本地 .agent 名或 SMA-... 代码时直接调用;目标未知或需按能力选择时用 find_agents 搜索。内置类型包括 magic(通用、全工具)、explore(只读)、shell(命令)、search(网络研究)等,内置无需发现。find_agents 的 keywords 应预先构建完整召回列表一次提交,通常两到四个高信息量词,按用户语言;query 为用户完整需求;limit 默认 5,有效 1 到 20。浏览全部列表时传 keywords=[]、query=None,读取 has_more 与 next_page 翻页,不要为看全目录而消耗上下文;关键词搜索不支持翻页。

call_subagent 参数:agent_name(必填,fork=True 时用 "" 继承当前 Agent)、agent_id(新会话为基名,恢复时为精确最终 ID)、task_label(用户语言标签)、prompt(必填)、model_id 可选、background 默认 False、fork 默认 False、resume 默认 False。新会话会追加序号并返回最终 ID,须以返回值为准。会话生命周期:新空白=fork/resume 均 False;继承上下文=fork=True;继续已有=resume=True;fork=True 且 resume=True 无效。prompt 在非 fork 时须自包含:任务、输出格式、路径或标识、约束、成功标准。

background=False 同步阻塞,仅适合秒级任务;True 立即返回,须再调 wait_for_subagents。wait_for_subagents 参数:agent_ids、timeout(默认 30,-1 无限等待上限 60 分钟,0 立即快照)、kill、pattern。timeout 超时不代表失败而是仍在运行,须继续等待或 kill;running 状态不可忽略,否则无限消耗资源。结果状态含 done、error、interrupted、running、not_found、ambiguous。分派前应确定输出目标,可采用共享容器、单文件或独立输出三种模式,禁止多个子智能体并发写同一文件。向用户汇报时把路径转为 [@file_path:path] 以便前端渲染为可点击链接。具体收费、价格与平台范围暂未提供。