Навыки агентов Ultralytics#
Навыки агентов Ultralytics предоставляют совместимым ИИ-агентам для программирования инструкции и справочные материалы для работы с Python-пакетом ultralytics, интерфейсом командной строки yolo и платформой Ultralytics, включая автоматизацию с помощью ul cloud. Они соответствуют открытому формату Agent Skills и загружаются при запросе подходящей задачи.
Как работают навыки#
Навык-маршрутизатор yolo сопоставляет запрос с соответствующим этапом рабочего процесса, а каждый навык для этапа описывает оба способа: самый быстрый путь в Ultralytics Platform, а затем рабочий процесс с локальными Python и CLI. Факты, зависящие от версии, например названия весов, аргументы обучения и форматы экспорта, собраны в каталогах, сверенных с зафиксированным релизом ultralytics; каждый навык указывает агенту ориентироваться на установленный пакет (yolo checks, yolo cfg и сообщения об ошибках), если сведения расходятся. Навык platform-cli вместо этого рекомендует обращаться к справке установленного CLI ul и актуальному API платформы. Функция Ask AI самой платформы использует тот же навык platform-cli.
Доступные навыки#
В репозитории есть один маршрутизатор, шесть навыков для разных этапов жизненного цикла и один навык для интерфейса командной строки Platform:
| Навык | Для чего использовать |
|---|---|
yolo | Основы работы с Python и CLI, процессы Platform и перенаправление к другим навыкам |
yolo-models | Выбор семейств моделей, размеров, задач и весов |
yolo-datasets | Подготовка, конвертация, проверка и устранение неполадок наборов данных |
yolo-training | Обучение, валидация, возобновление обучения, использование нескольких GPU и устранение неполадок |
yolo-tuning | Подбор гиперпараметров и улучшение экспериментов |
yolo-inference | Предсказание, результаты, отслеживание и решения |
yolo-export | Экспорт, квантование, форматы развертывания и сравнительное тестирование |
platform-cli | Автоматизация Ultralytics Platform с помощью ul cloud: ресурсы, загрузки, обучение в облаке, экспорт и развертывание |
Установка#
claude plugin marketplace add ultralytics/skills
claude plugin install yolo@ultralyticsЧтобы обновить, запусти claude plugin update yolo@ultralytics и перезапусти Claude Code.
Каждая версия плагина публикуется как релиз на GitHub с примечаниями к выпуску.
Подключи CLI платформы#
Навык platform-cli использует CLI ul (Python 3.11+), входящий в состав pip install ultralytics или автономного SDK (pip install ultralytics-platform). Создай ключ API платформы, предоставь его агенту и проверь подключение:
export ULTRALYTICS_API_KEY="YOUR_API_KEY" # or: ul login YOUR_API_KEY
ul cloud account summaryПримеры запросов#
После установки просто задавай агенту вопросы. Маршрутизатор yolo выберет подходящие инструкции:
| Цель | Пример запроса |
|---|---|
| Попробуй YOLO | «Запусти YOLO на тестовом изображении и покажи, что он обнаружит». |
| Обучение | «Преврати мои изображения в собственную модель YOLO: разметь их и обучи модель в Ultralytics Platform». |
| Улучши | «Показатель mAP моей модели перестал расти. Проанализируй запуск и предложи следующий эксперимент». |
| Разверни | «Экспортируй мою обученную модель YOLO в TensorRT с квантованием INT8 и проведи бенчмарк». |
| Проанализируй видео | «Посчитай автомобили, пересекающие линию на видео traffic.mp4, и сохрани видео с аннотациями». |
| Автоматизируй работу с платформой | «Выведи список моих наборов данных в Ultralytics Platform и запусти облачное обучение на наборе PPE». |
Актуальные команды установки, исходные файлы, обновления и порядок сообщения о проблемах смотри в репозитории ultralytics/skills.
Часто задаваемые вопросы#
Это инструкции и справочные материалы многократного использования, которые помогают ИИ-агентам для программирования работать с Ultralytics Platform, Python-пакетом
ultralytics, CLIyoloи CLI платформыul.В репозитории есть плагины для Claude Code и Codex. Cursor, Gemini CLI и другие агенты, поддерживающие открытый формат Agent Skills, могут установить папки навыков напрямую или через CLI для навыков.
Установи весь плагин, чтобы автоматически направлять задачи по всем этапам жизненного цикла компьютерного зрения и операциям с CLI Platform. Чтобы установить один навык через CLI для навыков, передай его имя с помощью
--skill, например--skill yolo-trainingили--skill platform-cli.Сам плагин содержит только инструкции, поэтому при его загрузке ничего не запускается. Команды, которые агент запускает с помощью навыков, могут скачивать пакеты, веса и наборы данных, а команды
ul cloudзагружают переданные им файлы в Ultralytics Platform, используя твой ключ API. Пакетultralyticsтакже отправляет анонимную аналитику использования;yolo settings sync=Falseотключает её.Нет. Навыки помогают агенту выбрать подходящий процесс, но при различиях в поведении или поддерживаемых параметрах приоритет имеют установленный пакет и актуальная документация Ultralytics.
Создай отчёт об ошибке в репозитории
ultralytics/skillsи укажи использованный запрос, ответ агента и то, что должно было произойти.