归档智能体
post /v1/agents/{agent_id}/archive
归档智能体
路径参数
agent_id: string
请求头参数
-
"anthropic-beta": optional array of AnthropicBeta可选的请求头，用于指定要使用的 beta 版本。
-
string -
"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more-
"message-batches-2024-09-24" -
"prompt-caching-2024-07-31" -
"computer-use-2024-10-22" -
"computer-use-2025-01-24" -
"pdfs-2024-09-25" -
"token-counting-2024-11-01" -
"token-efficient-tools-2025-02-19" -
"output-128k-2025-02-19" -
"files-api-2025-04-14" -
"mcp-client-2025-04-04" -
"mcp-client-2025-11-20" -
"dev-full-thinking-2025-05-14" -
"interleaved-thinking-2025-05-14" -
"code-execution-2025-05-22" -
"extended-cache-ttl-2025-04-11" -
"context-1m-2025-08-07" -
"context-management-2025-06-27" -
"model-context-window-exceeded-2025-08-26" -
"skills-2025-10-02" -
"fast-mode-2026-02-01" -
"output-300k-2026-03-24" -
"user-profiles-2026-03-24" -
"advisor-tool-2026-03-01" -
"managed-agents-2026-04-01" -
"cache-diagnosis-2026-04-07"
-
-
返回值
-
BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }托管智能体
agent。-
id: string -
archived_at: stringRFC 3339 格式的时间戳
-
created_at: stringRFC 3339 格式的时间戳
-
description: string -
mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition-
name: string -
type: "url""url"
-
url: string
-
-
metadata: map[string] -
model: BetaManagedAgentsModelConfig模型标识符和配置。
-
id: BetaManagedAgentsModel驱动智能体的模型。
参阅 models 了解更多详情和选项。
-
"claude-opus-4-7" or "claude-opus-4-6" or "claude-sonnet-4-6" or 6 more驱动智能体的模型。
参阅 models 了解更多详情和选项。
-
"claude-opus-4-7"面向长时间运行智能体和编程的前沿智能
-
"claude-opus-4-6"用于构建智能体和编程的最智能模型
-
"claude-sonnet-4-6"速度与智能的最佳组合
-
"claude-haiku-4-5"具有接近前沿智能的最快模型
-
"claude-haiku-4-5-20251001"具有接近前沿智能的最快模型
-
"claude-opus-4-5"将最大智能与实用性能相结合的高级模型
-
"claude-opus-4-5-20251101"将最大智能与实用性能相结合的高级模型
-
"claude-sonnet-4-5"用于智能体和编程的高性能模型
-
"claude-sonnet-4-5-20250929"用于智能体和编程的高性能模型
-
-
string
-
-
speed: optional "standard" or "fast"推理速度模式。
fast以高级定价提供显著更快的输出 token 生成速度。并非所有模型都支持fast；无效的组合会在创建时被拒绝。-
"standard" -
"fast"
-
-
-
multiagent: BetaManagedAgentsMultiagent已解析的协调器拓扑，包含具体的智能体列表。
-
agents: array of BetaManagedAgentsAgentReference协调器可以作为会话线程生成的智能体，每个都解析到特定版本。
-
id: string -
type: "agent""agent"
-
version: number
-
-
type: "coordinator""coordinator"
-
-
name: string -
skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill-
BetaManagedAgentsAnthropicSkill object { skill_id, type, version }已解析的 Anthropic 托管技能。
-
skill_id: string -
type: "anthropic""anthropic"
-
version: string
-
-
BetaManagedAgentsCustomSkill object { skill_id, type, version }已解析的用户创建的自定义技能。
-
skill_id: string -
type: "custom""custom"
-
version: string
-
-
-
system: string -
tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool-
BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }-
configs: array of BetaManagedAgentsAgentToolConfig-
enabled: boolean -
name: "bash" or "edit" or "read" or 5 more内置智能体工具标识符。
-
"bash" -
"edit" -
"read" -
"write" -
"glob" -
"grep" -
"web_fetch" -
"web_search"
-
-
permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy工具执行的权限策略。
-
BetaManagedAgentsAlwaysAllowPolicy object { type }工具调用自动批准，无需用户确认。
-
type: "always_allow""always_allow"
-
-
BetaManagedAgentsAlwaysAskPolicy object { type }工具调用在执行前需要用户确认。
-
type: "always_ask""always_ask"
-
-
-
-
default_config: BetaManagedAgentsAgentToolsetDefaultConfig已解析的智能体工具默认配置。
-
enabled: boolean -
permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy工具执行的权限策略。
-
BetaManagedAgentsAlwaysAllowPolicy object { type }工具调用自动批准，无需用户确认。
-
BetaManagedAgentsAlwaysAskPolicy object { type }工具调用在执行前需要用户确认。
-
-
-
type: "agent_toolset_20260401""agent_toolset_20260401"
-
-
BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }-
configs: array of BetaManagedAgentsMCPToolConfig-
enabled: boolean -
name: string -
permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy工具执行的权限策略。
-
BetaManagedAgentsAlwaysAllowPolicy object { type }工具调用自动批准，无需用户确认。
-
BetaManagedAgentsAlwaysAskPolicy object { type }工具调用在执行前需要用户确认。
-
-
-
default_config: BetaManagedAgentsMCPToolsetDefaultConfig已解析的 MCP 服务器所有工具的默认配置。
-
enabled: boolean -
permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy工具执行的权限策略。
-
BetaManagedAgentsAlwaysAllowPolicy object { type }工具调用自动批准，无需用户确认。
-
BetaManagedAgentsAlwaysAskPolicy object { type }工具调用在执行前需要用户确认。
-
-
-
mcp_server_name: string -
type: "mcp_toolset""mcp_toolset"
-
-
BetaManagedAgentsCustomTool object { description, input_schema, name, type }API 响应中返回的自定义工具。
-
description: string -
input_schema: BetaManagedAgentsCustomToolInputSchema自定义工具输入参数的 JSON Schema。
-
properties: optional map[unknown]定义工具输入参数的 JSON Schema 属性。
-
required: optional array of string必需属性名称列表。
-
type: optional "object"工具输入 schema 必须为 'object'。
"object"
-
-
name: string -
type: "custom""custom"
-
-
-
type: "agent""agent"
-
updated_at: stringRFC 3339 格式的时间戳
-
version: number智能体的当前版本。从 1 开始，修改智能体时递增。
-
示例
curl https://api.anthropic.com/v1/agents/$AGENT_ID/archive \
-X POST \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: managed-agents-2026-04-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
响应
{
"id": "agent_011CZkYpogX7uDKUyvBTophP",
"archived_at": null,
"created_at": "2026-03-15T10:00:00Z",
"description": "A general-purpose starter agent.",
"mcp_servers": [
{
"name": "example-mcp",
"type": "url",
"url": "https://example-server.modelcontextprotocol.io/sse"
}
],
"metadata": {
"foo": "bar"
},
"model": {
"id": "claude-sonnet-4-6",
"speed": "standard"
},
"multiagent": {
"agents": [
{
"id": "agent_011CZkYqphY8vELVzwCUpqiQ",
"type": "agent",
"version": 1
}
],
"type": "coordinator"
},
"name": "My First Agent",
"skills": [
{
"skill_id": "xlsx",
"type": "anthropic",
"version": "1"
},
{
"skill_id": "skill_011CZkZFNu9hAbo3jZPRgTlx",
"type": "custom",
"version": "2"
}
],
"system": "You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user's task end to end.",
"tools": [
{
"configs": [
{
"enabled": true,
"name": "bash",
"permission_policy": {
"type": "always_allow"
}
}
],
"default_config": {
"enabled": true,
"permission_policy": {
"type": "always_ask"
}
},
"type": "agent_toolset_20260401"
}
],
"type": "agent",
"updated_at": "2026-03-15T10:00:00Z",
"version": 1
}