Was this page helpful?
Les compétences sont des ressources réutilisables basées sur le système de fichiers qui donnent à votre agent une expertise spécifique à un domaine : des flux de travail, du contexte et des bonnes pratiques qui transforment un agent polyvalent en spécialiste. Contrairement aux invites (instructions au niveau de la conversation pour des tâches ponctuelles), les compétences se chargent à la demande, n'impactant la fenêtre de contexte que lorsque cela est nécessaire.
Deux types de compétences sont pris en charge. Les deux fonctionnent de la même manière : votre agent les invoque automatiquement lorsqu'elles sont pertinentes pour la tâche.
Pour apprendre à créer des compétences personnalisées, consultez l'aperçu des compétences d'agent et les bonnes pratiques. Cette page suppose que vous avez déjà des compétences disponibles dans votre organisation ou que vous utilisez les compétences pré-construites d'Anthropic.
Toutes les demandes de l'API Managed Agents nécessitent l'en-tête bêta managed-agents-2026-04-01. Le SDK définit automatiquement l'en-tête bêta.
Attachez les compétences lors de la création d'un agent. Un maximum de 20 compétences par session est pris en charge - cela inclut les compétences sur tous les agents de la session, si vous travaillez avec plusieurs agents.
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
)| Champ | Description |
|---|---|
type | Soit anthropic pour les compétences pré-construites, soit custom pour les compétences créées par l'organisation. |
skill_id | L'identifiant de la compétence. Pour les compétences Anthropic, utilisez le nom court (par exemple, xlsx). Pour les compétences personnalisées, utilisez l'ID skill_* retourné à la création. |
version | Compétences personnalisées uniquement. Épinglez à une version spécifique ou utilisez latest. |