Competenze degli agenti Ultralytics#
Le competenze degli agenti Ultralytics forniscono agli agenti di programmazione AI compatibili istruzioni e materiale di riferimento per lavorare con il pacchetto Python ultralytics, la CLI yolo e la Ultralytics Platform, inclusa l'automazione con ul cloud. Seguono il formato aperto Agent Skills e vengono caricate quando viene richiesta un'attività pertinente.
Come funzionano le Skills#
La skill router yolo associa una richiesta alla fase del ciclo di vita a cui si riferisce, mentre ogni skill di fase copre entrambi i percorsi: il percorso più rapido in Ultralytics Platform e poi il flusso di lavoro locale con Python e CLI. I dati che dipendono dalla versione, come i nomi dei pesi, gli argomenti di addestramento e i formati di esportazione, si trovano in cataloghi verificati rispetto a una release ultralytics bloccata; ogni skill indica all'agente di fare affidamento sul pacchetto installato (yolo checks, yolo cfg e i messaggi di errore) in caso di discrepanze. La skill platform-cli, invece, rimanda alla guida della CLI ul installata e alla API di Platform aggiornata. Chiedi all'IA, la funzione integrata in Platform, usa la stessa skill platform-cli.
Competenze disponibili#
Il repository contiene un router, sei competenze per il ciclo di vita e una competenza per la CLI della Platform:
| Competenza | Da usare per |
|---|---|
yolo | Uso di base di Python e della CLI, flussi di lavoro della Platform e instradamento alle altre competenze |
yolo-models | Selezione delle famiglie di modelli, delle dimensioni, delle attività e dei pesi |
yolo-datasets | Preparazione, conversione, convalida e risoluzione dei problemi relativi ai dataset |
yolo-training | Addestramento, convalida, ripresa dell'addestramento, uso di più GPU e risoluzione dei problemi |
yolo-tuning | Ottimizzazione degli iperparametri e miglioramento degli esperimenti |
yolo-inference | Inferenza, risultati, tracciamento e soluzioni |
yolo-export | Esportazione, quantizzazione, formati di distribuzione e benchmark |
platform-cli | Automatizzazione della Ultralytics Platform con ul cloud: risorse, caricamenti, addestramento nel cloud, esportazioni e distribuzioni |
Installazione#
claude plugin marketplace add ultralytics/skills
claude plugin install yolo@ultralyticsPer aggiornare, esegui claude plugin update yolo@ultralytics e riavvia Claude Code.
Ogni versione del plugin viene pubblicata come release su GitHub con le relative note di rilascio.
Collega la CLI di Platform#
La skill platform-cli usa la CLI ul (Python 3.11+), inclusa in pip install ultralytics o nell'SDK autonomo (pip install ultralytics-platform). Crea una chiave API di Platform, rendila disponibile al tuo agente e verifica la connessione:
export ULTRALYTICS_API_KEY="YOUR_API_KEY" # or: ul login YOUR_API_KEY
ul cloud account summaryEsempi di prompt#
Dopo l'installazione, interagisci con l'agente in modo naturale. Il router yolo seleziona le indicazioni pertinenti:
| Obiettivo | Esempio di prompt |
|---|---|
| Prova YOLO | "Esegui YOLO su un'immagine di esempio e mostrami cosa rileva." |
| Addestra | "Trasforma le mie immagini in un modello YOLO personalizzato, con etichette e addestrato in Ultralytics Platform." |
| Migliora | "Il mAP del mio modello si è stabilizzato. Analizza l'esecuzione e proponi il prossimo esperimento." |
| Distribuisci | "Esporta il mio modello YOLO addestrato in TensorRT con quantizzazione INT8 e confrontane le prestazioni." |
| Analizza video | "Conta le auto che attraversano una linea in traffic.mp4 e salva il video annotato." |
| Automatizza Platform | "Elenca i miei dataset di Ultralytics Platform e avvia l'addestramento nel cloud su quello dei DPI." |
Consulta il repository ultralytics/skills per i comandi di installazione aggiornati, i file sorgente, gli aggiornamenti e la segnalazione dei problemi.
Domande frequenti#
Sono istruzioni riutilizzabili e materiale di riferimento che aiutano gli agenti di programmazione AI a lavorare con la Ultralytics Platform, il pacchetto Python
ultralytics, la CLIyoloe la CLI della Platformul.Il repository fornisce plugin per Claude Code e Codex. Cursor, Gemini CLI e altri agenti che leggono il formato aperto Agent Skills possono installare direttamente le cartelle delle competenze o farlo tramite la CLI skills.
Installa il plugin completo per instradare automaticamente le richieste tra le varie fasi del ciclo di vita della computer vision e le operazioni della CLI della Platform. Per installare una singola competenza con la CLI skills, passane il nome con
--skill, ad esempio--skill yolo-trainingo--skill platform-cli.Il plugin contiene solo istruzioni, quindi non viene eseguito nulla al caricamento. I comandi eseguiti dall'agente tramite le skill possono scaricare pacchetti, pesi e dataset; i comandi
ul cloudcaricano invece su Ultralytics Platform, con la tua chiave API, i file che gli passi. Anche il pacchettoultralyticsinvia dati di telemetria anonimi sull'utilizzo, cheyolo settings sync=Falsedisattiva.No. Le competenze indirizzano un agente verso il flusso di lavoro pertinente, ma il pacchetto installato e la documentazione Ultralytics aggiornata restano le fonti autorevoli quando il comportamento o le opzioni supportate sono diversi.
Apri una segnalazione di bug nel repository
ultralytics/skillse includi il prompt che hai usato, le indicazioni fornite dall'agente e ciò che sarebbe dovuto accadere.