Skills são recursos reutilizáveis baseados em sistema de arquivos que dão ao seu agente expertise específica do domínio: fluxos de trabalho, contexto e melhores práticas que transformam um agente de propósito geral em um especialista. Diferentemente de prompts (instruções em nível de conversa para tarefas únicas), 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 melhores práticas. Esta página assume que você já tem skills disponíveis em sua organização ou está usando skills pré-construídas do Anthropic.
Todas as solicitações da API 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. Um máximo de 20 skills por sessão é suportado - isso inclui skills em todos os agentes da sessão, se você estiver trabalhando com múltiplos agentes.
agent = client.beta.agents.create(
name="Financial Analyst",
model="claude-opus-4-7",
system="You are a financial analysis agent.",
skills=[
{
"type": "anthropic",
"skill_id": "xlsx",
},
{
"type": "custom",
"skill_id": "skill_abc123",
"version": "latest",
},
],
)| Campo | Descrição |
|---|---|
type | Ou anthropic para skills pré-construídas ou custom para skills criadas pela organização. |
skill_id | O identificador da skill. Para skills do 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 uma versão específica ou use latest. |
Was this page helpful?