判断现有 Anthropic Managed Agents 客户端能否接入 Awaken

请在修改现有 Anthropic Managed Agents 客户端前使用本页。先列出客户端所用的 SDK 版本和资源族，再从下面四种结果中选择一项。请求能够到达服务器，不等于整个客户端已经兼容。

先做兼容性判断

当前验证记录覆盖 @anthropic-ai/sdk 0.122.0 与 Python anthropic 1.2.0， 两者在审阅范围内都暴露 127 个生成操作。TypeScript 矩阵还覆盖 0.121.0、0.117.1 和 0.105.0；Python 矩阵覆盖从 0.92.0 到 1.2.0 的全部已选变更点。这些是已测试版本， 不是依赖要求。请按自己的依赖治理选择版本，再用本页判断哪些行为确实经过测试。在 Awaken revision 50d5035c68456c9106626f748cf4c169c2057beb，operation manifest 把当前 SDK 的 127 个方法和 12 条已审阅但 SDK 未生成的文档路由映射到具名可执行场景。兼容范围只包括 本页具名的路径、方法、DTO、错误、helper 与约束。

连接官方 SDK

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  baseURL: 'http://localhost:8080',
  apiKey: process.env.AWAKEN_API_KEY ?? 'local',
});

const session = await client.beta.sessions.create({
  agent: process.env.AWAKEN_AGENT_ID,
  environment_id: process.env.AWAKEN_ENVIRONMENT_ID,
});
await client.beta.sessions.events.send(session.id, {
  events: [{
    type: 'user.message',
    content: [{ type: 'text', text: 'Summarize RFC 8259.' }],
  }],
});

只修改 base URL 还不够，还要配置 Awaken 认证。官方 Managed 资源方法会加入所需 beta selector；原始 HTTP 客户端需要自行发送。Awaken 接受 x-api-key: <token> 或 Authorization: Bearer <token>。

在迁移整个应用前：

1. 记录所选 SDK 版本，列出客户端调用的全部资源族。
2. 配置 baseURL 与 Awaken 认证，并确认 SDK 方法加入预期 beta selector。
3. 创建一个 Session，发送一个事件，并检查返回的 error envelope。
4. 落实应用会遇到的全部约束，再验证 retry 与 archive 路径。

如何使用设计引用

本页是兼容与差异声明的唯一公开权威页面。 Managed Agents 协议页只解释该 wire 如何进入 runtime。下文每项有意义的约束都会链接到对应设计页，用于解释所有权、状态变化、 失败处理和部署责任。设计页回答“为什么这样工作”，兼容性判断仍以本页为准。

SDK 验证矩阵

需要公开这张矩阵，因为“SDK 兼容”可能在多个位置失效。即使路由存在，生成方法、helper、 重试规则、stream decoder 或响应 DTO 仍可能不同。本表说明测试了哪种客户端和行为；下方资源 矩阵则回答应用可以使用哪些 API 资源族。

上游契约请以 Anthropic 的 Managed Agents 总览、 Session operations，以及官方 TypeScript 和 Python SDK 仓库为准。本页记录 Awaken 经过测试的投影与差异，不替代这些上游来源。

Beta header 决策表

服务器会解析逗号分隔和重复的 anthropic-beta header。缺少必需 beta 时返回 Managed invalid_request_error。

Dreams SDK 方法会自动加入 dreaming beta。Awaken 接受该生成请求，不再要求 /v1/dreams 同时携带 Managed beta。

兼容矩阵

“兼容”只适用于具名 wire contract。模型可用性、凭据、Sandbox capacity 与 backend placement 属于 Awaken 配置，即使 request 合法也可能明确失败。

已知差异与约束

Awaken 扩展

扩展与兼容面共用同一批受治理对象，但不属于 Anthropic baseline。大多数使用独立路由族：

少量扩展有意位于兼容形状旁边或内部，因此严格客户端必须显式处理：

这些字段和路由都是扩展；只需要 baseline 行为的客户端不应发送或依赖它们。公共路由族的 唯一索引是 API 参考。

执行扩展：Native、ACP 与 A2A

兼容 wire 不固定执行 backend。不可变的已发布 model binding 会选择：

• Native 进程内 backend；
• Claude Code、Codex、Gemini、OpenCode 或 Hermes 等受支持 ACP CLI backend；
• 远程 A2A endpoint。

ACP runtime 选择与 Sandbox placement（local、namespace、docker、podman 或 k8s）是两个独立维度。不同 ACP 实现的精确模型选择、credential delivery 与 session persistence 并不相同。API selector 与发布边界见 通过 API 选择模型与 ACP runtime， 逐 runtime 差异见 ACP runtime 矩阵。