用途：Managed Agents API 让 Anthropic 在服务端运行智能体循环。你只需 POST 一条用户消息，服务端负责执行工具循环、管理上下文并流式返回结果，以牺牲部分控制权换取简单性与持久性。
主要能力：核心对象包括 Agent（/v1/agents，模板：名称、系统提示、工具、模型）、Session（/v1/sessions，绑定智能体的实时会话）和 Message（加入会话并触发运行）。Agent 可版本化，更新不影响在线会话。会话持久，可跨天恢复；服务端自动压缩上下文，无需自行管理历史。支持按 metadata 过滤、列出会话，用于用户、租户或工作流隔离与审计。
工具执行：工具在 Agent 上声明，由 Managed 执行，包括内置工具（code_execution、web_search、computer、memory）、MCP 服务器，以及自定义 URL 端点工具（Managed 以工具输入 POST 到你的 URL，需返回工具结果 JSON，重试与循环由 Managed 处理）。
使用方式：创建 Agent 后创建 Session，再以流式方式发送消息，监听 text、tool_use、done 等事件；恢复会话时向同一 session 再发消息即可。可通过 events.list 查看 tool_use、tool_result、thinking、compaction 等循环事件，便于审计、回放与调试。
适用场景：不想运维基础设施的生产智能体、跨小时或跨天的长时智能体、Web/移动/CLI 多客户端共享会话、需要弹性扩展的场景。
限制：工具必须可声明（MCP 或 URL），无法运行任意 Node.js 工具；客户端上下文（本地文件、IDE 状态）不适用，应改用 SDK；无法细粒度控制循环，压缩与重试时机由 Managed 决定。
成本：Token 成本与直接调用 API 相同，基础设施成本已包含，MCP/URL 工具调用需自付服务器成本，会话存储按保留设置计费，通常比自托管智能体贵 5-15%。
最佳实践：面向客户、重视可用性多于控制的智能体用 Managed；开发工具、IDE 集成、本地自动化用 SDK；工具放在 MCP 或 URL 端点以便复用；用会话 metadata 做租户隔离与审计；显式设置保留策略；监控会话事件流以发现异常长循环或重复工具失败。
迁移：可增量进行——先创建声明现有工具的对应 Agent，新用户路由到 Managed，已有 SDK 会话跑完，全部流量迁移后再弃用 SDK；关键流程也可并行运行做 A/B 测试。