托管智能体将工作委派给您的智能体

会话操作

检索、列出、更新、归档和删除 Claude 托管智能体会话。

会话创建后，您可以使用这些操作来读取、更新、归档或删除它。有关创建会话并向其发送任务的信息，请参阅启动会话。

所有 Managed Agents API 请求都需要 managed-agents-2026-04-01 beta 标头。SDK 会自动设置该 beta 标头。

会话状态

会话会经历以下状态。有关会话生命周期的信息，请参阅启动会话。

状态	描述
`idle`	智能体正在等待输入，包括用户消息或工具确认。会话以 `idle` 状态启动。
`running`	智能体正在主动执行。
`rescheduling`	发生了暂时性错误，正在自动重试。
`terminated`	会话因不可恢复的错误而结束。

您可以在会话进行中更新会话的 agent.tools 和 agent.mcp_servers（包括权限策略），而无需创建新的智能体版本。更新仅限于当前会话，不会传播回底层智能体。

更新的语义是完全替换：提供的数组即为新值。如需保留现有条目，请先通过 GET 获取会话，修改数组后再通过 POST 提交回去。

会话必须处于 idle 状态才能更新智能体。如果您需要在智能体运行时更新它，请先中断会话。

归档会话可以阻止发送新事件，同时保留其历史记录。处于 running 状态的会话无法归档；如果您需要立即归档，请发送中断事件。

删除会话将永久移除其记录、事件和关联的沙箱。处于 running 状态的会话无法删除；如果您需要立即删除，请发送中断事件。

文件、内存存储、保管库、技能、环境和智能体是独立的资源，不受会话删除的影响。

Was this page helpful?