Compétences d’agent Ultralytics#
Les compétences d’agent Ultralytics fournissent aux agents de programmation IA compatibles des instructions et des ressources de référence pour utiliser le package Python ultralytics, la CLI yolo et la plateforme Ultralytics, y compris l’automatisation avec ul cloud. Elles suivent le format ouvert Agent Skills et se chargent lorsqu’une tâche pertinente est demandée.
Fonctionnement des compétences#
La compétence routeur yolo associe une demande à l’étape du cycle de vie concernée, et chaque compétence d’étape couvre les deux parcours : le chemin le plus rapide dans Ultralytics Platform, puis le workflow local en Python et CLI. Les faits qui varient selon la version, comme les noms des poids, les arguments d’entraînement et les formats d’exportation, sont répertoriés dans des catalogues vérifiés par rapport à une version épinglée de ultralytics, et chaque compétence indique à l’agent de faire confiance au package installé (yolo checks, yolo cfg et les messages d’erreur) en cas de divergence. La compétence platform-cli s’en remet plutôt à l’aide de la CLI ul installée et à l’API de la Platform en temps réel. L’Ask AI de Platform utilise la même compétence platform-cli.
Compétences disponibles#
Le dépôt contient un routeur, six compétences couvrant le cycle de vie et une compétence dédiée à la CLI de la plateforme :
| Compétence | Utilisation |
|---|---|
yolo | Utilisation de base de Python et de la CLI, workflows de la plateforme et orientation vers les autres compétences |
yolo-models | Sélection des familles de modèles, des tailles, des tâches et des poids |
yolo-datasets | Préparation, conversion, validation et dépannage des jeux de données |
yolo-training | Entraînement, validation, reprise, utilisation de plusieurs GPU et dépannage |
yolo-tuning | Réglage des hyperparamètres et amélioration des expériences |
yolo-inference | Prédiction, résultats, suivi et Solutions |
yolo-export | Export, quantification, formats de déploiement et benchmarking |
platform-cli | Automatisation de la plateforme Ultralytics avec ul cloud : ressources, téléversements, entraînement dans le cloud, exports et déploiements |
Installation#
claude plugin marketplace add ultralytics/skills
claude plugin install yolo@ultralyticsPour effectuer la mise à jour, exécute claude plugin update yolo@ultralytics, puis redémarre Claude Code.
Chaque version du plugin est publiée sous forme de version sur GitHub, accompagnée de notes de version.
Connecter la CLI de Platform#
La compétence platform-cli utilise la CLI ul (Python 3.11+), incluse avec pip install ultralytics ou dans le SDK autonome (pip install ultralytics-platform). Crée une clé API de Platform, rends-la accessible à ton agent et vérifie la connexion :
export ULTRALYTICS_API_KEY="YOUR_API_KEY" # or: ul login YOUR_API_KEY
ul cloud account summaryExemples de requêtes#
Une fois l’installation terminée, adresse-toi naturellement à l’agent. Le routeur yolo sélectionne les conseils pertinents :
| Objectif | Exemple de prompt |
|---|---|
| Essayer YOLO | « Lance YOLO sur une image d’exemple et montre-moi ce qu’il détecte. » |
| Entraînement | « Transforme mes images en un modèle YOLO personnalisé, annoté et entraîné dans Ultralytics Platform. » |
| Améliorer | « Le mAP de mon modèle a plafonné. Analyse l’exécution et propose la prochaine expérience. » |
| Déployer | « Exporte mon modèle YOLO entraîné vers TensorRT avec une quantification INT8 et évalue ses performances. » |
| Analyser une vidéo | « Compte les voitures qui franchissent une ligne dans traffic.mp4 et enregistre la vidéo annotée. » |
| Automatiser Platform | « Répertorie mes jeux de données Ultralytics Platform et lance un entraînement dans le cloud avec celui sur les EPI. » |
Consulte le dépôt ultralytics/skills pour connaître les commandes d’installation actuelles, les fichiers source, les mises à jour et la procédure de signalement des problèmes.
FAQ#
Ce sont des instructions réutilisables et des ressources de référence qui aident les agents de programmation IA à utiliser la plateforme Ultralytics, le package Python
ultralytics, la CLIyoloet la CLI de la plateformeul.Le dépôt fournit des plugins pour Claude Code et Codex. Cursor, Gemini CLI et les autres agents capables de lire le format ouvert Agent Skills peuvent installer directement les dossiers de compétences ou passer par la CLI skills.
Installe le plugin complet pour bénéficier d’un routage automatique couvrant le cycle de vie de la vision par ordinateur et les opérations de la CLI de la plateforme. Pour installer une seule compétence avec la CLI skills, indique son nom avec
--skill, par exemple--skill yolo-trainingou--skill platform-cli.Le plugin lui-même ne contient que des instructions ; rien ne s’exécute donc lors de son chargement. Les commandes exécutées par ton agent à partir des compétences peuvent télécharger des packages, des poids et des jeux de données, et les commandes
ul cloudtéléversent les fichiers que tu leur fournis vers Ultralytics Platform à l’aide de ta clé API. Le packageultralyticsenvoie également des données d’utilisation anonymes, une collecte désactivée paryolo settings sync=False.Non. Les compétences orientent l’agent vers le workflow pertinent, mais le package installé et la documentation Ultralytics actuelle font autorité lorsque le comportement ou les options prises en charge diffèrent.
Ouvre un rapport de bug dans le dépôt
ultralytics/skills, en précisant la requête utilisée, les conseils donnés par l’agent et ce qui aurait dû se passer.