多智能体协作
分身、群聊与子智能体团队。
多智能体协作
需要多个身份一起干活时才看本页。产品主路径是 Near 群聊和 Studio 子智能体。脚本里连续两次 AgentExecutor.run 只是两个串行任务,不算团队。
三条真实路径
| 表面 | 何时 | 机制 |
|---|---|---|
| Near 群聊 | 人和多个分身在一个房间说话 | group_router:用户 @ 或 Meta 兜底 |
| 真委派 | 已注册分身必须亲自执行 | delegate_to_avatar 跑在该分身真实 session |
| 临时团队 | 无名并行工人 | AgentTeamManager.spawn_subagent |
AgentTeamManager 不是 AgentTeamManager(agents=[...])。它需要 llm_factory 和 StudioSession(base_session),以及可选的 owner_session_id、max_concurrent_subagents(默认 4)。
Near 群聊
- 新建群聊默认隐式包含 Meta。
@名字路由到该成员。未 @ 时由 Meta 兜底,除非正文明显指向某成员职责。- 「已接收 / 正在调用工具 / 工具完成」应聚合成该分身一张可折叠卡,不要每个工具一条气泡。
委派 vs spawn
Meta 工具在 agenticx/runtime/meta_tools.py:
delegate_to_avatar(avatar_id, task)— 查找或创建分身会话并在那里执行,继承taskspaces/context_filesspawn_subagent(...)— 团队管理器工人;名字已是注册分身时会被拦截chat_with_avatar— 内部问答,不开完整执行会话
每轮 Meta 系统提示都会注入活跃子智能体快照(_build_active_subagents_context)。
A2A(库协议)
agenticx.protocols.client.A2AClient 对接远程 A2A 服务。构造时传入目标 AgentCard,再创建并轮询协作任务。不是 A2AClient(); client.invoke_skill(...)。Near 群聊不走 A2A。
会话隔离
团队运行按 owner_session_id 隔离。分身历史留在该分身的 session。自动化会话(automation:<task_id>)不得串进 Meta 历史。