managed-agents-api-reference

# 托管智能体 — 端点参考 所有端点都需要 `x-api-key` 和 `anthropic-version: 2023-06-01` 请求头。托管智能体端点还需要额外的 `anthropic-beta` 请求头。 ## Beta 请求头 anthropic-beta: managed-agents-2026-04-01 SDK 会自动为所有 `client.beta.{agents,environments,sessions,vaults,memory_stores}.*` 调用添加此请求头。技能端点使用 `skills-2025-10-02`；文件端点使用 `files-api-2025-04-14`。 --- ## SDK 方法参考 所有资源均位于 `beta` 命名空间下。Python 和 TypeScript 共享相同的方法名称。 | 资源 | Python / TypeScript (`client.beta.*`) | Go (`client.Beta.*`) | | --- | --- | --- | | 智能体 (Agents) | `agents.create` / `retrieve` / `update` / `list` / `archive` | `Agents.New` / `Get` / `Update` / `List` / `Archive` | | 智能体版本 | `agents.versions.list` | `Agents.Versions.List` | | 环境 (Environments) | `environments.create` / `retrieve` / `update` / `list` / `delete` / `archive` | `Environments.New` / `Get` / `Update` / `List` / `Delete` / `Archive` | | 会话 (Sessions) | `sessions.create` / `retrieve` / `update` / `list` / `delete` / `archive` | `Sessions.New` / `Get` / `Update` / `List` / `Delete` / `Archive` | | 会话事件 | `sessions.events.list` / `send` / `stream` | `Sessions.Events.List` / `Send` / `StreamEvents` | | 会话资源 | `sessions.resources.add` / `retrieve` / `update` / `list` / `delete` | `Sessions.Resources.Add` / `Get` / `Update` / `List` / `Delete` | | 存储库 (Vaults) | `vaults.create` / `retrieve` / `update` / `list` / `delete` / `archive` | `Vaults.New` / `Get` / `Update` / `List` / `Delete` / `Archive` | | 凭据 | `vaults.credentials.create` / `retrieve` / `update` / `list` / `delete` / `archive` | `Vaults.Credentials.New` / `Get` / `Update` / `List` / `Delete` / `Archive` | | 记忆存储 (Memory Stores) | `memory_stores.create` / `retrieve` / `update` / `list` / `delete` / `archive` | `MemoryStores.New` / `Get` / `Update` / `List` / `Delete` / `Archive` | | 记忆 | `memory_stores.memories.create` / `retrieve` / `update` / `list` / `delete` | `MemoryStores.Memories.New` / `Get` / `Update` / `List` / `Delete` | | 记忆版本 | `memory_stores.memory_versions.list` / `retrieve` / `redact` | `MemoryStores.MemoryVersions.List` / `Get` / `Redact` | **需要注意的命名特性：** - 智能体**没有删除**功能 — 只有 `archive`（归档）。归档是**永久性的**：智能体变为只读，新会话无法引用它，且无法取消归档。请确认