定義您的代理

技能

為您的代理附加可重複使用的、基於檔案系統的專業知識，以支援特定領域的工作流程。

技能是可重複使用的、基於檔案系統的資源，為您的代理提供特定領域的專業知識：工作流程、上下文和最佳實踐，將通用代理轉變為專業代理。與提示詞（針對一次性任務的對話層級指令）不同，技能按需載入，僅在需要時影響上下文視窗。

支援兩種類型的技能。兩者的工作方式相同：當技能與任務相關時，您的代理會自動調用它們。

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?