RikkaHub 开发实践:Claude Managed Agents 多智能体会话(Multiagent Sessions)完整指南

发布时间:2026/11/17 17:35:18

RikkaHub 开发实践:Claude Managed Agents 多智能体会话(Multiagent Sessions)完整指南 人工智能大模型AI 应用移动开发交互助手【免费下载链接】rikkahubRikkaHub is an Android APP that supports for multiple LLM providers.项目地址https://gitcode.com/gh_mirrors/ri/rikkahub点击查看免费下载本文以 Anthropic Claude Managed Agents 的 Multiagent Sessions 机制为核心系统讲解如何在单个会话Session内由一个协调者CoordinatorAgent 向多个子 AgentSubagent进行委托协作——包括 roster 花名册的声明方式、线程Thread模型与状态语义、会话流上的多智能体事件、跨线程工具确认与自定义工具结果的回传以及最容易踩中的三个陷阱。阅读本文后你将掌握multiagent: {type: coordinator, agents: [...]}的完整配置与编程模式能够为 RikkaHub 这类多 LLM 提供者客户端设计并实现一个协调者 多个专家子代理的协作式 Agent 工作流。文中所有代码示例与概念均可对照本仓库.agents/skills/claude-api/下的官方技能文档与各语言 SDK 绑定验证。多智能体会话的核心模型共享容器、独立线程在 Managed Agents 体系下多智能体协作的最小单位是一个Session。一个协调者coordinatorAgent 可以在同一个 Session 内把任务委托给其他 Agent而无需启动多个独立会话。其底层模型可以用三条规则概括共享容器与文件系统所有参与协作的 Agent 共用同一个 Session 对应的容器Container与文件系统。容器是 Agent 工具bash、文件操作、代码执行运行的隔离工作区而 Agent 主循环运行在 Anthropic 的编排层orchestration layer上通过工具调用作用于容器。详细架构可参考 managed-agents-core.md。独立线程Thread每个 Agent 运行在各自的线程中。线程是一条上下文隔离的事件流拥有自己独立的对话历史、模型、系统提示词、工具、MCP 服务器与技能Skills这些均来自该 Agent 自身的配置而非协调者的配置。线程持久化线程是持久存在的。协调者可以给早前调用过的子 Agent 发送后续消息follow-up该子 Agent 会保留此前轮次的对话记忆继续工作——这意味着你可以先让子 Agent 完成第一阶段任务再基于其结果追加第二阶段指令。关于 beta 头SDK 会在所有client.beta.{agents,sessions}.*调用上自动附加managed-agents-2026-04-01beta 头使用多智能体功能无需额外手动添加任何头部。这个头同时启用 Agents、Environments、Sessions、Events、Session Resources、Session Threads、Outcomes、Multiagent、Vaults、Credentials、Memory Stores、Deployments 等整组能力详见 managed-agents-overview.md。在协调者上声明 roster 花名册位置Agent 顶层字段不是 tools 条目multiagent是agents.create()/agents.update()上的一个顶层字段不是tools[]数组里的一个条目。agents字段用于列出 1–20 个 roster 条目。sessions.create()上不需要做任何改动——roster 在创建会话时从协调者的配置中解析得出。这也是 Managed Agents Agent 先行的铁律在协作场景下的延续先创建 Agent一次再让 Session 引用它每次运行。关于该生命周期模式的完整论述见 managed-agents-core.md 的 Agents 一节。orchestrator client.beta.agents.create( nameEngineering Lead, modelclaude-opus-4-8, systemYou coordinate engineering work. Delegate code review to the reviewer and test writing to the test agent., tools[{type: agent_toolset_20260401}], multiagent{ type: coordinator, agents: [ reviewer.id, # bare string — latest version {type: agent, id: test_writer.id, version: 4}, # pinned version {type: self}, # the coordinator itself ], }, ) session client.beta.sessions.create(agentorchestrator.id, environment_idenv.id)roster 条目的三种形状Roster 条目形状说明字符串简写agent_abc123引用某个已存储 Agent 的最新版本。Agent 引用{type: agent, id, version?}省略version表示在协调者保存时锁定其当时的最新版本。自身{type: self}协调者可以派生出自己的副本copies。覆盖规则与限制如果 Session 是通过agent_with_overrides创建的会话级 Agent 配置覆盖见 managed-agents-core.md 的 Override agent configuration for a session 一节这些覆盖只作用于协调者及其{type: self}副本。通过 ID 引用的 roster Agent始终使用自己创建时的配置——会话级覆盖不会传播到它们身上。roster 最多20 个唯一 Agent协调者可以为每个 Agent派生多个副本multiple copies。仅允许一层委托One level of delegation only子 Agent 若再声明自己的multiagentroster深度 1 的层级会被直接忽略不会级联。线程模型主线程与每线程端点Session 级的事件流是primary thread主线程——它展示协调者的完整轨迹trace外加子 Agent 活动的压缩视图线程状态转换和跨线程消息不包含子 Agent 的每一次工具调用。如果你需要深入某个子 Agent 的具体活动需要使用下面的每线程端点per-thread endpoints操作HTTPSDKclient.beta.sessions.threads.*列出线程GET /v1/sessions/{sid}/threads.list(session_id)检索单个线程GET /v1/sessions/{sid}/threads/{tid}.retrieve(thread_id, session_id...)归档线程POST /v1/sessions/{sid}/threads/{tid}/archive.archive(thread_id, session_id...)列出线程事件GET /v1/sessions/{sid}/threads/{tid}/events.events.list(thread_id, session_id...)流式线程事件GET /v1/sessions/{sid}/threads/{tid}/stream.events.stream(thread_id, session_id...)SessionThread 对象字段每个SessionThread携带以下字段id线程 ID。statusrunning|idle|rescheduling|terminated。agent该线程所运行 Agent 配置的解析快照resolved snapshot——包含id、name、model、system、tools、skills、mcp_servers、version。注意这是快照即使之后 Agent 对象被更新线程仍保持创建时的配置。parent_thread_id父线程 ID主线程primary thread该项为null主线程也会出现在线程列表中。archived_at归档时间戳。可选的stats/usage字段。状态聚合语义Session 状态聚合线程状态只要有任何线程处于runningsession.status就是running。并发上限最多25 个并发线程Max 25 concurrent threads。排空每线程流的正确退出条件在排空draining某个每线程事件流时应在session.thread_status_idle事件处 break并且像处理 Session 级 idle 一样检查其stop_reason。关于线程状态与 Session 生命周期状态的对应关系可对照 managed-agents-events.md 中rescheduling → running ↔ idle → terminated的状态机说明理解。多智能体事件会话流上协调者主线程的 Session 事件流上会浮现以下多智能体专属事件用于感知子线程的生命周期与跨线程消息事件载荷要点含义session.thread_createdsession_thread_id、agent_name一个新的线程被创建。session.thread_status_runningsession_thread_id、agent_name线程开始活动。session.thread_status_idlesession_thread_id、agent_name、stop_reason线程正在等待输入。检查stop_reason与session.status_idle.stop_reason形状相同。session.thread_status_rescheduledsession_thread_id、agent_name线程在可重试错误后重新调度。session.thread_status_terminatedsession_thread_id、agent_name线程被归档或遇到终端错误。agent.thread_message_sentto_session_thread_id、to_agent_name、content协调者向另一个线程发送了后续消息。agent.thread_message_receivedfrom_session_thread_id、from_agent_name、content某个 Agent 将其结果投递给协调者。这些事件与普通事件一样遵循{domain}.{action}的命名约定并与session.status_*系列事件并存于同一条流上完整的事件命名空间对照可参见 managed-agents-events.md 的 Event Types (Received) 一节。子 Agent 线程上的工具权限与自定义工具结果回传这是多智能体协作中最容易写错的交互点当一个子 Agent 需要你的客户端介入时触发了一个always_ask策略的工具确认或产生了一个自定义工具调用结果该请求会被跨帖cross-post到主线程并携带session_thread_id标识来源线程——因此你只需要监听 Session 事件流即可无需订阅每条每线程流。你需要回发user.tool_confirmation携带tool_use_id或user.custom_tool_result携带custom_tool_use_id并且回显echo来源事件中的session_thread_id。官方文档指出SDK 的参数类型与 docstring 期望该字段服务器也会按 tool-use ID 路由因此回显属于双保险belt-and-suspenders而非决定性因素——但务必包含它。for event_id in stop.event_ids: pending events_by_id[event_id] confirmation { type: user.tool_confirmation, tool_use_id: event_id, result: allow, } if pending.session_thread_id is not None: confirmation[session_thread_id] pending.session_thread_id client.beta.sessions.events.send(session.id, events[confirmation])同样的模式适用于user.custom_tool_result——为自定义工具回传结果时同样携带session_thread_id。这里可以对照普通非多智能体场景下的工具确认回环来理解差异在单线程场景中agent.tool_use事件携带evaluated_permission ask且 Session 进入 idle 等待决策客户端用tool_use_id即事件自身的id形如sevt_...不是toolu_...ID回发user.tool_confirmation多智能体场景在此基础上额外要求回显session_thread_id以指明确认属于哪个子线程。完整的单线程工具确认 round-trip 模式见 managed-agents-client-patterns.md 的 Pattern 4。常见陷阱Pitfalls官方文档明确列出了多智能体模式下最容易踩的三个坑逐条对照自己的实现不要把 roster 放在sessions.create()上或tools[]里。multiagent是 Agent 的顶层字段正确的做法是先更新协调者 Agentagents.update()再启动一个引用该协调者的 Session。这与 Managed Agents 全局性的 Agent一次→ Session每次运行 强制流程一致见 managed-agents-overview.md。不要假设共享上下文。线程之间共享文件系统但不共享对话历史或工具。如果协调者需要某个子 Agent 基于某项信息行动它必须在委托消息delegated message里显式说清楚或者把信息写入磁盘写入共享容器文件系统供子 Agent 读取。这是共享容器模型的正确用法——文件系统是跨线程的通信媒介对话历史不是。深度 1 的委托被忽略。子 Agent 自己声明的multiagentroster如果有不会级联生效——只有 Session 的协调者拥有委托权。设计协作拓扑时请保持协调者 → 子 Agent的单层结构。此外归档archive语义在多智能体场景同样生效归档线程或归档 Agent 都是不可逆操作归档后的 Agent 无法被新 Session 引用详见 managed-agents-api-reference.md 中关于 Archive 的说明。各语言绑定与端点速查本文示例以 Python SDK 为主client.beta.agents.create/client.beta.sessions.create/client.beta.sessions.threads.*/client.beta.sessions.events.sendPython 与 TypeScript 的 SDK 方法名完全一致Go 对应client.Beta.Agents/client.Beta.Sessions.Threads.*等命名空间。完整的跨语言方法对照表见 managed-agents-api-reference.mdPython 完整入门流程见 Python Managed Agents README。对于 Python 之外的语言绑定官方文档建议 WebFetchhttps://platform.claude.com/docs/en/managed-agents/multi-agent.md对应本仓库的 live-sources.md获取最新的各语言 SDK 示例切勿从 cURL 形状或其他语言的 SDK 反推未经验证的 API 签名。多智能体涉及的 Session Threads 端点GET /v1/sessions/{sid}/threads系列与 Events 端点GET /v1/sessions/{sid}/events/events/stream均为managed-agents-2026-04-01beta 组的一部分SDK 会自动附加该头无需手动传递。赞分享人工智能大模型AI 应用移动开发交互助手【免费下载链接】rikkahubRikkaHub is an Android APP that supports for multiple LLM providers.项目地址https://gitcode.com/gh_mirrors/ri/rikkahub点击查看免费下载相关推荐RikkaHub 智能体技能库使用 Python SDK 开发 Claude Managed Agents 完整实战指南RikkaHub 智能体技能库使用 Python SDK 开发 Claude Managed Agents 完整实战指南 本文是 RikkaHub 开源仓库中人工智能大模型AI 应用移动开发交互助手LunaTranslator 的 PS3 游戏文本挂钩支持基于 RPCS3 的视觉小说翻译实战清单与底层原理LunaTranslator 的 PS3 游戏文本挂钩支持基于 RPCS3 的视觉小说翻译实战清单与底层原理 LunaTranslator 作为一款视觉小说翻人工智能大模型AI 应用移动开发交互助手RikkaHub 项目实践Anthropic Managed Agents 客户端模式与事件流驱动会话开发指南RikkaHub 项目实践Anthropic Managed Agents 客户端模式与事件流驱动会话开发指南 本指南以仓库内 managed agents人工智能大模型AI 应用移动开发交互助手上一篇Video2X 免费视频超分辨率与插帧完整指南把老视频拉到 4K 还能更顺滑下一篇Freqtrade 加密交易机器人从克隆到回测的完整教程创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/17 5:56:27

温州论坛703源码避坑指南:保姆级建站教程揭秘

温州论坛703源码避坑指南:保姆级建站教程揭秘 别被那些花里胡哨的模板网站骗了,看着挺像回事,用起来全是坑,尤其是像【温州论坛703】这种带特定地域属性或特定板块结构的旧源码,很多新手直接拿去改,结果上线才发现样式错乱、后台权限混乱,简直比…

2026/11/17 5:54:28

网站建设mingxinsh避坑指南:看懂建站报价才敢开工

网站建设mingxinsh避坑指南:看懂建站报价才敢开工 网站做好了没人访问,这是很多老板做网站后最头疼的事。你花了大几千甚至几万块钱,网站上线了,每天后台看流量只有个位数,心里直打鼓:这钱是不是打水漂了?别急,这通常不是技术问题,而是你在…

2026/11/17 17:33:08

40岁电工证怎么考才不白花钱 电子证书到底值不值

40岁电工证怎么考才不白花钱 电子证书到底值不值 怕考不过白交培训费,这事儿我懂。我朋友老王,40多岁从工厂转岗,想干电工,结果被培训机构套路了,交了5000块培训费,考试挂了,说补考还得再交钱。我问他为啥不早问清楚?他摇摇头说:“这年头,…

2026/11/17 17:33:08

电工证自学备考到期换证流程,良心建议别走弯路

电工证自学备考到期换证流程,良心建议别走弯路 之前考的证在外省能不能转过来?这可能是很多电工从业者心头最大的一块石头。尤其对于在郑州金水区从事劳务班组的负责人来说,证书的合规性与可迁移性直接关系到团队作业的资质和安全性。今天就从一个老电工的…

2026/11/17 17:33:08

三明市低压电工证培训怎么考?含金量高不高?看完这篇就够了

三明市低压电工证培训怎么考?含金量高不高?看完这篇就够了 你是不是正在找工作,但因为没有低压电工证被拒?或者你已经有一份工作,但想要晋升,却发现没有这个证就卡住了?别急,三明市低压电工证培训就是你的突破口。这个证的 含金量…

2026/11/17 17:33:08

考电工证需要任职证明保姆级教程:外省证书能转吗?全流程详解

考电工证需要任职证明保姆级教程:外省证书能转吗?全流程详解 之前考的证在外省能不能转过来?这是很多电工朋友的共同疑问,特别是那些已经持有证书但因工作变动、搬家或想在新城市发展的电工,更关心证书是否能跨省使用。其实,电工证属于全国通用证书,…

2026/11/17 17:33:08

福清电工证培训机构在哪考?证书过期了不知道怎么复审延期

福清电工证培训机构在哪考?证书过期了不知道怎么复审延期 你是不是也遇到过这种情况:手里拿着电工证,结果一不小心就过期了,想着去复审,结果发现不知道在哪考,流程也一头雾水?其实这不光是你一个人的问题,很多特种作业人员在证书管理上都容易踩坑。尤…

2026/11/17 17:28:07

武汉建筑特种工培训通过率揭秘:怎么避开中介陷阱

武汉建筑特种工培训通过率揭秘:怎么避开中介陷阱 不知道去哪报名怕被中介坑?现在武汉建筑特种工培训项目越来越多,但真假难辨,很多学员在选择培训机构时都遇到过类似问题。武汉本地的培训机构鱼龙混杂,有些打着“包过”“包证”的旗号,实则资质不全、课…

2026/11/17 17:09:16

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/17 0:02:41

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期 证书过期了不知道怎么复审延期,这种情况在电工圈里太常见了。我有个同事,去年刚把低压电工证给弄丢了,直到单位查岗才发现证书已经过期,差点被停工处理。今天就用我真实经历给你讲讲电工证操作…

2026/11/17 0:02:41

机修需不需要电工证 在哪考最靠谱 这些细节必须知道

机修需不需要电工证 在哪考最靠谱 这些细节必须知道 之前考的证在外省能不能转过来?这个问题几乎每个特种作业从业者都问过。特别是像你这样,之前在外省考了证,现在想在本地扎根,或者想换证、换岗的机修人员,最关心的就是【机修需不需要电工证】和【在…

2026/11/17 0:02:41

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么 工地太忙根本没时间复习考试,我理解你。作为一名刚从焦作工程类院校毕业的学生,我也经历过这种困扰。电工证年检步骤是什么,听起来简单,但实际操作中,很多人因为流程不清楚、资料准备不…

2026/11/17 0:49:41

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑