Habilidades de agente da Ultralytics#
As habilidades de agente da Ultralytics fornecem a agentes de programação com IA compatíveis instruções e material de referência para trabalhar com o pacote Python ultralytics, a CLI yolo e a Ultralytics Platform, incluindo a automação com ul cloud. Elas seguem o formato aberto Agent Skills e são carregadas quando uma tarefa relevante é solicitada.
Como as Skills funcionam#
A skill roteadora yolo mapeia uma solicitação para a etapa do ciclo de vida correspondente, e cada skill de etapa abrange as duas rotas: o caminho mais rápido na Ultralytics Platform e, em seguida, o fluxo de trabalho local com Python e CLI. Fatos que variam conforme a versão, como nomes de pesos, argumentos de treinamento e formatos de exportação, ficam em catálogos fundamentados em uma versão fixada ultralytics, e cada skill instrui o agente a confiar no pacote instalado (yolo checks, yolo cfg e mensagens de erro) quando houver divergências. Em vez disso, a skill platform-cli consulta a ajuda da CLI ul instalada e a API da Platform em tempo real. O Ask AI da própria Platform usa a mesma skill platform-cli.
Habilidades disponíveis#
O repositório contém um roteador, seis habilidades do ciclo de vida e uma habilidade para a CLI da Platform:
| Habilidade | Usar para |
|---|---|
yolo | Uso básico de Python e CLI, fluxos de trabalho da Platform e direcionamento para as outras habilidades |
yolo-models | Selecionar famílias de modelos, tamanhos, tarefas e pesos |
yolo-datasets | Preparar, converter, validar e solucionar problemas de conjuntos de dados |
yolo-training | Treinamento, validação, retomada, uso de várias GPUs e solução de problemas |
yolo-tuning | Ajuste de hiperparâmetros e aprimoramento de experimentos |
yolo-inference | Predição, resultados, rastreamento e Solutions |
yolo-export | Exportação, quantização, formatos de implantação e avaliação de desempenho |
platform-cli | Automatizar a Ultralytics Platform com ul cloud: recursos, uploads, treinamento na nuvem, exportações e implantações |
Instalação#
claude plugin marketplace add ultralytics/skills
claude plugin install yolo@ultralyticsPara atualizar, execute claude plugin update yolo@ultralytics e reinicie o Claude Code.
Cada versão do plugin é publicada como uma versão do GitHub, com notas da versão.
Conecte a CLI da Platform#
A skill platform-cli usa a CLI ul (Python 3.11+), incluída com pip install ultralytics ou com o SDK independente (pip install ultralytics-platform). Crie uma chave da API da Platform, disponibilize-a para o agente e verifique a conexão:
export ULTRALYTICS_API_KEY="YOUR_API_KEY" # or: ul login YOUR_API_KEY
ul cloud account summaryExemplos de prompts#
Depois de instalar, faça perguntas ao agente de forma natural. A skill roteadora yolo seleciona as orientações relevantes:
| Objetivo | Exemplo de prompt |
|---|---|
| Experimente o YOLO | "Execute o YOLO em uma imagem de exemplo e mostre o que ele detecta." |
| Treinar | "Transforme minhas imagens em um modelo YOLO personalizado, com anotações e treinamento na Ultralytics Platform." |
| Melhorar | "O mAP do meu modelo estagnou. Analise a execução e proponha o próximo experimento." |
| Implantar | "Exporte meu modelo YOLO treinado para TensorRT com quantização INT8 e faça um benchmark." |
| Analisar vídeo | "Conte os carros que cruzam uma linha no trânsito.mp4 e salve o vídeo anotado." |
| Automatizar a Platform | "Liste meus conjuntos de dados da Ultralytics Platform e inicie o treinamento na nuvem com o conjunto de EPI." |
Consulte o repositório ultralytics/skills para ver os comandos de instalação atuais, arquivos-fonte, atualizações e como relatar problemas.
Perguntas frequentes#
São instruções reutilizáveis e material de referência que ajudam agentes de programação com IA a trabalhar com a Ultralytics Platform, o pacote Python
ultralytics, a CLIyoloe a CLI da Platformul.O repositório oferece plugins para Claude Code e Codex. Cursor, Gemini CLI e outros agentes que leem o formato aberto Agent Skills podem instalar as pastas de habilidades diretamente ou por meio da CLI skills.
Instale o plugin completo para obter o direcionamento automático em todo o ciclo de vida da visão computacional e nas operações da CLI da Platform. Para instalar uma habilidade com a CLI skills, passe o nome dela com
--skill, como--skill yolo-trainingou--skill platform-cli.O plugin contém apenas instruções, então nada é executado quando ele é carregado. Os comandos executados pelo agente a partir das skills podem baixar pacotes, pesos e conjuntos de dados, e os comandos
ul cloudenviam à Ultralytics Platform, usando sua chave da API, os arquivos que você fornecer. O pacoteultralyticstambém envia dados anônimos de uso, algo queyolo settings sync=Falsedesativa.Não. As habilidades orientam o agente para o fluxo de trabalho relevante, mas o pacote instalado e a documentação atual da Ultralytics continuam sendo as fontes de referência quando o comportamento ou as opções compatíveis forem diferentes.
Abra um relatório de bug no repositório
ultralytics/skillscom o prompt que você usou, as orientações dadas pelo agente e o que deveria ter acontecido.