google-agents-cli-onboarding

Google Agents CLI Onboarding — это стартовый Agent Skill для жизненного цикла агентов на Agent Platform. Он предназначен для случаев, когда нужно создать нового агента, разрабатывать его на базе ADK, запускать локально, отлаживать код, тестировать и оценивать результаты, развертывать приложение, публиковать агента или организовать наблюдение за его работой. Карточка описывает роль CLI как точки входа: она помогает определить нужную фазу и перейти к специализированному workflow, а не подменяет собой все остальные инструкции проекта. Первый шаг — понять задачу и зафиксировать спецификацию агента в файле .agents-cli-spec.md. Затем рекомендуется изучить готовые примеры, прежде чем создавать структуру проекта. После этого жизненный цикл разделяется на отдельные этапы. Фаза scaffold отвечает за создание или расширение проекта, базовой структуры, CI/CD и инфраструктурных шаблонов. Фаза build предназначена для логики агента, инструментов, callbacks и управления состоянием через API Agent Development Kit. Фаза evaluate используется для систематической проверки качества с оцениванием трасс выполнения. Фаза deploy переводит агента в эксплуатационную среду, включая Agent Runtime, Cloud Run или GKE. Фаза publish регистрирует опубликованного агента в Gemini Enterprise, а фаза observe описывает Cloud Trace, журналирование prompt-response и аналитику в BigQuery. Для одноразовой настройки источник предлагает «uvx google-agents-cli setup», который устанавливает CLI и включает семь специализированных skills. Другой вариант — «npx skills add google/agents-cli», если нужно добавить экспертные workflow и позволить агенту выбирать их по контексту. После установки следует выполнить «agents-cli info», чтобы проверить состояние установки и текущую конфигурацию проекта. Основные команды отражают стадии процесса: «agents-cli scaffold <name>» создаёт проект агента, «agents-cli eval run» запускает агента и оценивание трасс одним шагом, «agents-cli deploy» отправляет его в Agent Runtime, Cloud Run или GKE, а «agents-cli publish gemini-enterprise» регистрирует агента для Gemini Enterprise. Полный список параметров предлагается смотреть через «agents-cli --help». Практическая ценность этого skill — в правильном порядке действий. Сначала формулируется назначение и внешние инструменты агента, затем изучаются примеры, после чего выбираются специализированные инструкции для scaffold, ADK-кода, оценки, развертывания, публикации или наблюдения. Такой порядок уменьшает риск начать с генерации файлов без понятной спецификации и помогает разделять создание кода, проверку качества и эксплуатацию. Skill подходит как навигационная карта для разработчика, который строит агентный проект на Google Agent Platform, и как чек-лист перехода между фазами. Ограничение важно учитывать заранее: это onboarding-вход, а не самостоятельная реализация агента и не гарантия успешного deploy. Для конкретной фазы всё равно нужны соответствующие специализированные skills, установленный CLI, конфигурация проекта и доступ к выбранной инфраструктуре. Файл спецификации нужен до написания кода; примеры необходимо изучить до scaffold; команда оценки проверяет трассы, но не заменяет содержательную проверку требований; deploy и publish зависят от реального состояния целевой платформы. Источник также предлагает обращаться в официальный репозиторий agents-cli для сообщений об ошибках и использовать его документацию как следующий уровень деталей.