Was this page helpful?
Skills são recursos reutilizáveis baseados em sistema de arquivos que fornecem ao seu agente expertise específica de domínio: fluxos de trabalho, contexto e melhores práticas que transformam um agente de propósito geral em um especialista. Ao contrário de prompts (instruções em nível de conversa para tarefas únicas), as skills são carregadas sob demanda, impactando a janela de contexto apenas quando necessário.
Dois tipos de skill são suportados. Ambos funcionam da mesma forma: seu agente os invoca automaticamente quando são relevantes para a tarefa.
Para aprender como criar skills personalizadas, consulte a visão geral de Agent Skills e as melhores práticas. Esta página pressupõe que você já tem skills disponíveis em sua organização ou está usando skills pré-construídas da Anthropic.
Todas as solicitações da API de Managed Agents requerem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente.
Anexe skills ao criar um agente. É suportado um máximo de 20 skills por sessão - isso inclui skills de todos os agentes da sessão, se você estiver trabalhando com múltiplos agentes.
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
)| Campo | Descrição |
|---|---|
type | anthropic para skills pré-construídas ou custom para skills criadas pela organização. |
skill_id | O identificador da skill. Para skills da Anthropic, use o nome curto (por exemplo, xlsx). Para skills personalizadas, use o ID skill_* retornado na criação. |
version | Apenas para skills personalizadas. Fixe em uma versão específica ou use latest. |