google-agents-cli-publish

google-agents-cli-publish — официальный skill Google для публикации агента в Gemini Enterprise и управления зарегистрированными агентами. Он покрывает команду agents-cli publish gemini-enterprise, режимы ADK и A2A, Agent Registry, флаги, переменные окружения и диагностику ошибок. Skill не предназначен для развёртывания: агент уже должен быть запущен и доступен, а приложение Gemini Enterprise должно существовать до регистрации. Для Cloud Run и GKE источник описывает A2A-регистрацию. В этом режиме передаётся URL agent card, то есть JSON-карточки, которую сервис публикует для протокола Agent-to-Agent, и полное имя Gemini Enterprise app. Имя и описание можно взять из карточки или переопределить флагами. Discovery Engine service account также должен иметь roles/run.servicesInvoker на сервис Cloud Run. Если сервис не отдаёт карточку или права не настроены, публикация не завершится корректно. Для Agent Runtime рекомендован режим ADK. Он использует ресурс reasoning engine и вызывает агент через нативный потоковый интерфейс, поэтому URL agent card для этого сценария не нужен. В команде указываются agent runtime ID и Gemini Enterprise app ID; display name, description и tool description можно задать явно. При наличии deployment_metadata.json skill умеет автоматически прочитать remote agent runtime ID, определить deployment target и выбрать регистрацию ADK для Agent Runtime либо A2A для Cloud Run и GKE. OAuth-сценарий может дополнительно использовать authorization ID. Skill поддерживает программный и интерактивный запуск. Для CI/CD значения передаются флагами или переменными окружения, включая AGENT_RUNTIME_ID, GEMINI_ENTERPRISE_APP_ID, GEMINI_DISPLAY_NAME и GEMINI_DESCRIPTION. Файл метаданных и интерактивный режим имеют отдельные ограничения: metadata-file не читается через переменную окружения в описанном интерфейсе, а --interactive или -i запускает запрос недостающих значений и может показать доступные Gemini Enterprise apps. Для работы нужен установленный бинарник agents-cli; источник указывает установку через uv tool install google-agents-cli. Отдельная часть skill посвящена Agent Registry. Управляемые агенты Agent Runtime регистрируются там автоматически после deploy, а просмотр и изменение fleet выполняются через gcloud alpha agent-registry. Обновлять нужно Service resource, а не сам Agent, когда требуется изменить endpoint или метаданные. Удаление зависит от способа регистрации: для управляемого runtime удаляется underlying runtime agent, для ручной записи удаляется Service resource. Эти действия требуют соответствующих ролей и не заменяют проверку самого приложения. В troubleshooting источник связывает Session not found с несовместимой версией google-cloud-aiplatform, а HTTP 403 с отсутствием Discovery Engine Editor permissions. Ошибка Could not fetch agent card требует проверки доступности агента и URL, а отсутствие registration type в неинтерактивном запуске исправляется явным флагом. Повторная публикация считается идемпотентной и обновляет существующую регистрацию. Skill помогает выбрать контракт публикации и проверить предпосылки, но не выдаёт права, не разворачивает сервис и не подтверждает production-доступность без отдельной проверки.