定义您的智能体

技能

为您的代理附加可重用的基于文件系统的专业知识，用于特定领域的工作流程。

技能是可重用的、基于文件系统的资源，为您的代理提供特定领域的专业知识：工作流程、上下文和最佳实践，将通用代理转变为专家。与提示（用于一次性任务的对话级指令）不同，技能按需加载，仅在需要时影响上下文窗口。

支持两种类型的技能。两者的工作方式相同：您的代理在与任务相关时会自动调用它们。

预构建的 Anthropic 技能： 常见的文档任务，例如 PowerPoint、Excel、Word 和 PDF 处理。
自定义技能： 您创建并上传到您的组织的技能。

要了解如何创建自定义技能，请参阅代理技能概述和最佳实践。本页假设您已在组织中拥有可用的技能或正在使用 Anthropic 预构建技能。

所有 Managed Agents API 请求都需要 managed-agents-2026-04-01 beta 标头。SDK 会自动设置 beta 标头。

在会话上启用技能

在创建代理时附加技能。每个会话最多支持 20 个技能 - 这包括会话中所有代理的技能，如果您正在使用多个代理。

agent=$(curl -sS https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  --json @- <<'EOF'
{
  "name": "Financial Analyst",
  "model": "claude-sonnet-4-6",
  "system": "You are a financial analysis agent.",
  "skills": [
    {"type": "anthropic", "skill_id": "xlsx"},
    {"type": "custom", "skill_id": "skill_abc123", "version": "latest"}
  ]
}
EOF
)

技能类型

字段	描述
`type`	预构建技能为 `anthropic`，或组织创建的技能为 `custom`。
`skill_id`	技能标识符。对于 Anthropic 技能，使用短名称（例如 `xlsx`）。对于自定义技能，使用创建时返回的 `skill_*` ID。
`version`	仅限自定义技能。固定到特定版本或使用 `latest`。

Was this page helpful?

定义您的智能体

技能

为您的代理附加可重用的基于文件系统的专业知识，用于特定领域的工作流程。

支持两种类型的技能。两者的工作方式相同：您的代理在与任务相关时会自动调用它们。

预构建的 Anthropic 技能： 常见的文档任务，例如 PowerPoint、Excel、Word 和 PDF 处理。
自定义技能： 您创建并上传到您的组织的技能。

要了解如何创建自定义技能，请参阅代理技能概述和最佳实践。本页假设您已在组织中拥有可用的技能或正在使用 Anthropic 预构建技能。

所有 Managed Agents API 请求都需要 managed-agents-2026-04-01 beta 标头。SDK 会自动设置 beta 标头。

在会话上启用技能

在创建代理时附加技能。每个会话最多支持 20 个技能 - 这包括会话中所有代理的技能，如果您正在使用多个代理。

agent=$(curl -sS https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  --json @- <<'EOF'
{
  "name": "Financial Analyst",
  "model": "claude-sonnet-4-6",
  "system": "You are a financial analysis agent.",
  "skills": [
    {"type": "anthropic", "skill_id": "xlsx"},
    {"type": "custom", "skill_id": "skill_abc123", "version": "latest"}
  ]
}
EOF
)

技能类型

字段	描述
`type`	预构建技能为 `anthropic`，或组织创建的技能为 `custom`。
`skill_id`	技能标识符。对于 Anthropic 技能，使用短名称（例如 `xlsx`）。对于自定义技能，使用创建时返回的 `skill_*` ID。
`version`	仅限自定义技能。固定到特定版本或使用 `latest`。

Was this page helpful?