连接 Anthropic Managed Agents 客户端｜Awaken Agents 文档

如果应用已经使用官方 Anthropic SDK，并希望在团队自己运行的基础设施上创建和继续 Agent 与 Session，就选择这个协议。

如果是新应用，先完成 运行第一个 Awaken Session。这是从 SDK 配置到 Session 回到 idle 的最短已测试路径。本页解释这条路径之下的边界。

哪些会改变，哪些保持不变

应用需要改变	应用可以保留
SDK base URL、部署认证与适用的 beta opt-in	已测试兼容边界内的官方 SDK request 与 response 类型
服务的部署与运维方式	Agent 与 Session 的资源标识
API 背后的 provider、Worker、Environment、Sandbox 与存储配置	通过 Managed wire 读取 Session event、history 并继续 Session 的方式

已测试 SDK 版本、所需 beta header、支持的资源族、已知差异与 Awaken 扩展只有一个权威页面： Anthropic SDK 兼容性。迁移已有客户端前先阅读该页。兼容经过测试的 wire 表面，不代表 Awaken 实现了每一个 Anthropic API，也不代表两者提供相同的托管服务。

静态结构：一个 wire adapter，一套 runtime

awaken-protocol-managed 是 Anthropic 词汇进入 Awaken 的反腐层。它拥有 wire DTO、请求校验、响应投影与 HTTP router；它调用已有 Session runtime，不构造第二套 runtime，也不保存第二份 Agent 或 Session 数据。

flowchart LR
  SDK[官方 Anthropic SDK] --> Adapter[Managed Agents adapter]
  Adapter --> Objects[已发布 Agent · Session · resources]
  Objects --> Runtime[Awaken execution and persistence]
  Runtime --> Adapter
  Adapter --> SDK

同一个已发布 Agent、Session identity、permission decision 与 committed event 也可由 Console 和其他协议 adapter 观察。

动态行为：从请求到已提交事件

Adapter 校验认证、路由族的 beta opt-in 与 Managed Agents request shape。
它通过已有 application 与 persistence port 解析已发布 Agent 和 Session。
Worker 执行选定的 Native、ACP 或 A2A backend。
Runtime 先提交事件，adapter 再将其投影为 event history 与 SSE。
校验、placement 与执行失败使用 Managed Agents error envelope；不支持的 backend 不会被静默替换。

增加功能前先验证一条连接

用容易辨认的输入创建一个 Session，保留其 id，持续读取 event，直到 Session 回到 idle；再确认 Console 显示同一个 id、Agent、status 与 committed history。这能证明客户端与自托管 runtime 正在观察同一个 Session，但不能证明更大范围的 SDK 兼容性；后者应以兼容性页面为准。

继续完成 运行第一个 Awaken Session。

参考

Anthropic SDK 兼容性：已测试版本、beta header、差异与扩展
公共 HTTP API：公共路由族的唯一索引
Session 与事件：Session 生命周期与已提交事件模型