Pour la référence API complète incluant les schémas de requête/réponse et tous les paramètres, consultez :
- Référence API de gestion des compétences - Opérations CRUD pour les compétences
- Référence API des versions de compétences - Gestion des versions
Liens rapides
Commencer avec les compétences d'agent
Créez votre première compétence
Créer des compétences personnalisées
Meilleures pratiques pour la création de compétences
Aperçu
Pour une analyse approfondie de l’architecture et des applications réelles des compétences d’agent, lisez notre blog d’ingénierie : Équiper les agents pour le monde réel avec les compétences d’agent.
container
.
Utiliser les compétences
Les compétences s’intègrent de manière identique dans l’API Messages quel que soit leur source. Vous spécifiez les compétences dans le paramètrecontainer
avec un skill_id
, un type
et une version
optionnelle, et elles s’exécutent dans l’environnement d’exécution de code.
Vous pouvez utiliser les compétences de deux sources :
Aspect | Compétences Anthropic | Compétences personnalisées |
---|---|---|
Valeur de type | anthropic | custom |
IDs de compétence | Noms courts : pptx , xlsx , docx , pdf | Générés : skill_01AbCdEfGhIjKlMnOpQrStUv |
Format de version | Basé sur la date : 20251013 ou latest | Horodatage d’époque : 1759178010641129 ou latest |
Gestion | Prédéfinies et maintenues par Anthropic | Téléchargées et gérées via API Skills |
Disponibilité | Disponibles pour tous les utilisateurs | Privées pour votre espace de travail |
source
pour filtrer). La forme d’intégration et l’environnement d’exécution sont identiques—la seule différence est la provenance des compétences et leur gestion.
Prérequis
Pour utiliser les compétences, vous avez besoin de :- Clé API Anthropic depuis la Console
- En-têtes bêta :
code-execution-2025-08-25
- Active l’exécution de code (obligatoire pour les compétences)skills-2025-10-02
- Active l’API Skillsfiles-api-2025-04-14
- Pour télécharger/télécharger des fichiers vers/depuis le conteneur
- Outil d’exécution de code activé dans vos requêtes
Utiliser les compétences dans Messages
Paramètre Container
Les compétences sont spécifiées à l’aide du paramètrecontainer
dans l’API Messages. Vous pouvez inclure jusqu’à 8 compétences par requête.
La structure est identique pour les compétences Anthropic et personnalisées—spécifiez le type
et le skill_id
requis, et incluez optionnellement version
pour épingler une version spécifique :
Télécharger les fichiers générés
Lorsque les compétences créent des documents (Excel, PowerPoint, PDF, Word), elles renvoient des attributsfile_id
dans la réponse. Vous devez utiliser l’API Files pour télécharger ces fichiers.
Comment cela fonctionne :
- Les compétences créent des fichiers lors de l’exécution du code
- La réponse inclut
file_id
pour chaque fichier créé - Utilisez l’API Files pour télécharger le contenu du fichier réel
- Enregistrez localement ou traitez selon vos besoins
Pour plus de détails sur l’API Files, consultez la documentation de l’API Files.
Conversations multi-tours
Réutilisez le même conteneur sur plusieurs messages en spécifiant l’ID du conteneur :Opérations longues
Les compétences peuvent effectuer des opérations qui nécessitent plusieurs tours. Gérez les raisons d’arrêtpause_turn
:
La réponse peut inclure une raison d’arrêt
pause_turn
, qui indique que l’API a mis en pause une opération de compétence longue. Vous pouvez fournir la réponse telle quelle dans une requête ultérieure pour laisser Claude continuer son tour, ou modifier le contenu si vous souhaitez interrompre la conversation et fournir des conseils supplémentaires.Utiliser plusieurs compétences
Combinez plusieurs compétences dans une seule requête pour gérer des flux de travail complexes :Gérer les compétences personnalisées
Créer une compétence
Téléchargez votre compétence personnalisée pour la rendre disponible dans votre espace de travail. Vous pouvez télécharger en utilisant soit un chemin de répertoire, soit des objets de fichier individuels.- Doit inclure un fichier SKILL.md au niveau supérieur
- Tous les fichiers doivent spécifier un répertoire racine commun dans leurs chemins
- La taille totale du téléchargement doit être inférieure à 8 Mo
- Préambule YAML :
name
(64 caractères max),description
(1024 caractères max)
Lister les compétences
Récupérez toutes les compétences disponibles pour votre espace de travail, y compris les compétences prédéfinies Anthropic et vos compétences personnalisées. Utilisez le paramètresource
pour filtrer par type de compétence :
Récupérer une compétence
Obtenez les détails d’une compétence spécifique :Supprimer une compétence
Pour supprimer une compétence, vous devez d’abord supprimer toutes ses versions :Versioning
Les compétences supportent le versioning pour gérer les mises à jour en toute sécurité : Compétences gérées par Anthropic :- Les versions utilisent le format de date :
20251013
- Les nouvelles versions sont publiées au fur et à mesure des mises à jour
- Spécifiez les versions exactes pour la stabilité
- Horodatages d’époque générés automatiquement :
1759178010641129
- Utilisez
"latest"
pour toujours obtenir la version la plus récente - Créez de nouvelles versions lors de la mise à jour des fichiers de compétence
Comment les compétences sont chargées
Lorsque vous spécifiez des compétences dans un conteneur :- Découverte des métadonnées : Claude voit les métadonnées de chaque compétence (nom, description) dans l’invite système
- Chargement des fichiers : Les fichiers de compétence sont copiés dans le conteneur à
/skills/{directory}/
- Utilisation automatique : Claude charge et utilise automatiquement les compétences lorsqu’elles sont pertinentes pour votre demande
- Composition : Plusieurs compétences se composent ensemble pour les flux de travail complexes
Cas d’utilisation
Compétences organisationnelles
Marque et communications- Appliquer le formatage spécifique à l’entreprise (couleurs, polices, mises en page) aux documents
- Générer des communications suivant les modèles organisationnels
- Assurer la cohérence des directives de marque dans tous les résultats
- Structurer les notes avec des formats spécifiques à l’entreprise (OKRs, journaux de décision)
- Générer des tâches suivant les conventions de l’équipe
- Créer des récapitulatifs de réunion et des mises à jour de statut standardisés
- Créer des rapports, propositions et analyses conformes à l’entreprise
- Exécuter des procédures analytiques spécifiques à l’entreprise
- Générer des modèles financiers suivant les modèles organisationnels
Compétences personnelles
Création de contenu- Modèles de document personnalisés
- Formatage et style spécialisés
- Génération de contenu spécifique au domaine
- Pipelines de traitement de données personnalisés
- Modèles de visualisation spécialisés
- Méthodes analytiques spécifiques à l’industrie
- Modèles de génération de code
- Cadres de test
- Flux de travail de déploiement
Exemple : Modélisation financière
Combinez les compétences Excel et d’analyse DCF personnalisée :Limites et contraintes
Limites de requête
- Compétences maximales par requête : 8
- Taille maximale de téléchargement de compétence : 8 Mo (tous les fichiers combinés)
- Limites du préambule YAML :
name
64 caractères,description
1024 caractères
Contraintes d’environnement
Les compétences s’exécutent dans le conteneur d’exécution de code avec ces limitations :- Pas d’accès réseau - Impossible d’effectuer des appels API externes
- Pas d’installation de package d’exécution - Seuls les packages préinstallés disponibles
- Environnement isolé - Chaque requête obtient un conteneur frais
Meilleures pratiques
Quand utiliser plusieurs compétences
Combinez les compétences lorsque les tâches impliquent plusieurs types de documents ou domaines : Bons cas d’utilisation :- Analyse de données (Excel) + création de présentation (PowerPoint)
- Génération de rapport (Word) + export en PDF
- Logique de domaine personnalisée + génération de document
- Inclure des compétences inutilisées (affecte les performances)