Was this page helpful?
Le skill sono risorse riutilizzabili basate sul filesystem che forniscono al tuo agente competenze specifiche del dominio: flussi di lavoro, contesto e best practice che trasformano un agente generico in uno specialista. A differenza dei prompt (istruzioni a livello di conversazione per attività una tantum), le skill vengono caricate su richiesta, impattando la finestra di contesto solo quando necessario.
Sono supportati due tipi di skill. Entrambi funzionano allo stesso modo: il tuo agente le invoca automaticamente quando sono pertinenti al compito.
Per scoprire come creare skill personalizzate, consulta la panoramica delle Agent Skills e le best practice. Questa pagina presuppone che tu abbia già skill disponibili nella tua organizzazione o che tu stia utilizzando skill pre-costruite di Anthropic.
Tutte le richieste all'API Managed Agents richiedono l'intestazione beta managed-agents-2026-04-01. L'SDK imposta automaticamente l'intestazione beta.
Collega le skill durante la creazione di un agente. È supportato un massimo di 20 skill per sessione - questo include le skill di tutti gli agenti per la sessione, se stai lavorando con più agenti.
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 | Descrizione |
|---|---|
type | anthropic per le skill pre-costruite oppure custom per le skill create dall'organizzazione. |
skill_id | L'identificatore della skill. Per le skill Anthropic, usa il nome breve (ad esempio, xlsx). Per le skill personalizzate, usa l'ID skill_* restituito al momento della creazione. |
version | Solo per le skill personalizzate. Fissa una versione specifica o usa latest. |