AIKraft Agents

google/agents-cli

CLI и навыки, которые превращают любого ассистента для кодинга в эксперта по созданию, оценке и развертыванию AI-агентов на Google Cloud.

Агенты⭐ 6 312Pythonпоследний релиз: v1.13.0
Открыть на GitHub ↗Сайт проекта ↗

Что это за инструмент

agents-cli — это набор CLI-инструментов и навыков (skills), который интегрируется в любые AI-ассистенты для кода (например, Claude Code, Codex), превращая их в экспертов по созданию и развертыванию AI-агентов на Google Cloud.

Зачем нужен

Инструмент решает задачу упрощения разработки enterprise-агентов, позволяя разработчикам использовать знакомые текстовые интерфейсы для генерации кода, оценки (eval) и деплоя, не изучая вручную сложные сервисы Google Cloud. Он предоставляет агентам контекст и команды для полного жизненного цикла: от создания проекта до публикации в Gemini Enterprise.

Что можно реализовать

  • Создание новых проектов агентов с помощью команд scaffold (create, enhance, upgrade) через текстовый запрос к AI-ассистенту.
  • Оценка качества агентов (eval) с помощью метрик, LLM-as-judge и автоматической оптимизации промптов на основе данных.
  • Развертывание агентов на Google Cloud (Cloud Run, GKE, Agent Runtime) с настройкой CI/CD и инфраструктуры.
  • Регистрация и публикация агентов в Gemini Enterprise Platform.
  • Настройка наблюдаемости (observability) через Cloud Trace и логирование.

Ключевые возможности

  • Интеграция с популярными coding agents: Antigravity CLI, Claude Code, Codex и другими.
  • Полный стек инструментов: scaffold, eval, deploy, publish, observability и data ingestion для RAG.
  • Поддержка enterprise-практик: governance, CI/CD, secrets management и multi-project infrastructure.
  • Автоматическая оптимизация промптов и анализ режимов сбоев (failure modes) через eval-данные.
  • Простая установка через uvx или npx skills add, после чего ассистент получает новые навыки.

👤 Кому подойдёт: разработчики, использующие AI-ассистенты для кода, и инженеры, внедряющие AI-агенты на Google Cloud

Релизы

v1.13.0minorbreaking
🕐 2 дн назад · релиз на GitHub ↗

Поддержка Agent Identity для Cloud Run, новые возможности A2A, улучшения CLI и логирования, а также исправления в расширениях и сессиях.

  • Added: Cloud Run-развертывания теперь поддерживают Agent Identity; новые проекты используют его по умолчанию.
  • Added: A2A-агенты автоматически регистрируют карточку агента в Agent Registry при деплое через Agent Runtime.
  • Added: Команда login теперь синхронизирует gcloud CLI и Application Default Credentials для корректной работы команд.
  • Added: Расширения из доверенных репозиториев устанавливаются без запроса подтверждения, а также поддерживаются langchain и claude.
  • Breaking: Запуск eval завершается с ошибкой exit 1 при любых ошибках кейсов, даже если не заданы пороги срабатывания.
v1.12.0minorbreaking
🕐 10 дн назад · релиз на GitHub ↗

ADK Go стал GA, шаблон Python переименован в adk_python, добавлена экспериментальная поддержка Claude Agent SDK.

  • Added: ADK Go вышел из стадии Preview: шаблон стабилен, готов к продакшену и поддерживается наравне с Python-версией.
  • Breaking: Шаблон Python теперь называется adk_python; старый алиас adk работает, но новые проекты фиксируют новое имя в манифесте.
  • Added: Добавлена экспериментальная поддержка Claude Agent SDK: развертывание через A2A, интеграция с Gemini и облачными сервисами Google.
  • Fixed: Увеличен таймаут серверных e2e-тестов до 120 секунд для Go и Python, что предотвращает падения многошаговых агентов.
  • Added: Команда scaffold enhance теперь сохраняет оригинальные файлы проекта в папку .agents-cli-original при их замене.
v1.11.0majorbreaking
🕐 17 дн назад · релиз на GitHub ↗

Удаление shortcut adk@, обновление зависимостей ADK, улучшения деплоя и стабильности Go-агентов.

  • Breaking: Удален shortcut adk@; теперь для создания проектов нужно использовать GitHub-URL рецептов из google/adk-recipes.
  • Added: Обновлены зависимости: новые проекты используют google-adk>=2.12.0 и google-cloud-aiplatform>=2.2,<3.
  • Added: При деплое в Agent Runtime регистрируются методы артефактов и выводятся последние 40 строк лога сборки при ошибках.
  • Fixed: Исправлена работа uv с публичным PyPI, улучшена обработка ошибок в режиме a2a и стабильность Go-агентов при долгих ответах.
  • Added: LangChain-агенты теперь именовываются по имени проекта, а трассировка фиксирует ID беседы для отслеживания контекста.
v1.10.0minor
🕐 25 дн назад · релиз на GitHub ↗

В Agents CLI v1.10.0 добавлена поддержка Agent Identity, навыков расширений и улучшена обработка ошибок.

  • Added: Новые проекты по умолчанию используют Agent Identity вместо сервисных аккаунтов.
  • Added: Расширения теперь могут поставлять навыки (skills), которые автоматически копируются в проект.
  • Fixed: Команда run теперь корректно завершается с ошибкой при сбоях в потоке данных ADK.
  • Added: Добавлены флаги для управления метками и секретами при развертывании в Cloud Run.
  • Fixed: Исправлено экранирование значений в манифесте и улучшена работа с конфигурацией при создании проекта.
v1.9.0minor
🕐 1 мес назад · релиз на GitHub ↗

В v1.9.0 включена телеметрия по умолчанию, добавлена поддержка CMEK для деплоя и улучшена диагностика через dry-run.

  • Added: Телеметрия использования включена по умолчанию; отключается переменными AGENTS_CLI_TELEMETRY=0 или DO_NOT_TRACK=1.
  • Added: Поддержка шифрования деплоя ключами Cloud KMS (CMEK) через флаг deploy --key для проектов с ограничениями GCP.
  • Added: Флаг deploy --dry-run теперь выполняет проверку API, прав IAM и секретов, возвращая код 1 при критических ошибках.
  • Fixed: Исправлена проблема с удалением таблиц BigQuery log sink при повторном применении Terraform-инфраструктуры.
  • Deprecated: Новые проекты ADK Python используют GOOGLE_GENAI_USE_ENTERPRISE вместо устаревшего GOOGLE_GENAI_USE_VERTEXAI.
v1.8.0minor
🕐 1 мес назад · релиз на GitHub ↗

Обновление agents-cli v1.8.0: улучшена работа scaffold upgrade, исправлены ошибки деплоя и добавлена телеметрия.

  • Added: Добавлен флаг --force для agents-cli scaffold upgrade, позволяющий принудительно перезаписать файлы шаблона.
  • Fixed: Исправлена ошибка, при которой неудачный слияние зависимостей приводило к ложному успеху и невозможности повторного запуска.
  • Fixed: Исправлено наложение состояний деплоя при одновременном запуске нескольких команд agents-cli deploy.
  • Added: Добавлена экспериментальная телеметрия (отключена по умолчанию), собирающая анонимные данные об ошибках и времени выполнения.
  • Fixed: Улучшена обработка ошибок: теперь при сбое GKE-роллаута выводятся состояния подов и события неймспейса.
v1.6.1minor
🕐 1 мес назад · релиз на GitHub ↗

Доступен Go-шаблон ADK, сгенерированные проекты используют Gemini 3.8 Flash, исправлены ошибки деплоя и оценки.

  • Added: Шаблон Go-агента ADK стал доступен без экспериментальных флагов с полной поддержкой деплоя и аналитики.
  • Added: Шаблоны проектов теперь по умолчанию используют модель gemini-3.8-flash.
  • Fixed: Исправлена ошибка, из-за которой на версии 2.9.0 промпты и ответы не попадали в BigQuery Agent Analytics.
  • Fixed: Устранены проблемы с выводом статуса в режиме a2a, корректным отображением identity и лишними директориями в образцах.
  • Fixed: Исправлено сохранение состояния сессии при оценке, вывод служебных сообщений в stderr и установка uv в Dockerfile.
v1.5.0minor
🕐 2 мес назад · релиз на GitHub ↗

Релиз v1.5.0: добавлена система расширений на базе LangChain, улучшена работа с инфраструктурой и исправлены ошибки стриминга.

  • Added: Появилась система расширений с шаблонами LangChain, поддерживающая установку из GitHub, других Git-хостов и локальных путей.
  • Added: Добавлены флаги --update-only и --labels для команды deploy, а также команда infra show для инспекции Terraform-конфигураций.
  • Added: Команда setup теперь работает без доступа к сети и Git, а сгенерированные агенты A2A корректно передают вызовы инструментов.
  • Fixed: Исправлен возврат пустого ответа при стриминге в reasoning_engine_adapter и ошибка загрузки проектов на Windows.
  • Fixed: Улучшена обработка ошибок: добавлены понятные сообщения для сбоев preconditions, некорректных манифестов и повторные попытки при блокировках.
v1.4.2patch
🕐 2 мес назад · релиз на GitHub ↗

В релизе v1.4.2 добавлено верхнее ограничение для зависимости google-cloud-aiplatform.

  • Fixed: Добавлено верхнее ограничение для зависимости google-cloud-aiplatform.
v1.4.1patch
🕐 2 мес назад · релиз на GitHub ↗

Релиз v1.4.1: исправление уязвимости, новые дефолты для Gemini и деплоя, улучшения в генерации трасс и бэкапах.

  • Fixed: Исправлена уязвимость произвольной записи файлов в команде scaffold create.
  • Added: Скелеты проектов теперь по умолчанию используют модель gemini-3.7-flash.
  • Added: Команда deploy по умолчанию устанавливает min-instances=0 для экономии ресурсов в режиме ожидания.
  • Fixed: Исправлена ошибка генерации трасс (traces) для некоторых агентов в команде eval generate.
  • Added: Команда scaffold upgrade теперь создает резервную копию проекта перед применением изменений.
v1.4.0minor
🕐 2 мес назад · релиз на GitHub ↗

Добавлена поддержка Agent Gateway, улучшены руководства по A2A и MCP, внедрена токено-базовая компактизация контекста.

  • Added: Добавлена поддержка Agent Gateway в команде agents-cli deploy
  • Added: Улучшены руководства по A2A-on-Agent-Runtime и MCP Agent Registry в навыках
  • Added: В шпаргалке ADK внедрена токено-базовая компактизация контекста
  • Added: В навык оценки добавлены рекомендации по удержанию тестовых случаев во время итераций
  • Deprecated: Удалён встроенный эндпоинт обратной связи; вместо него предложено реализовать механизм через навык наблюдаемости
  • Fixed: В agents-cli info теперь отображается язык проекта; добавлена поддержка переменных $GH_TOKEN и $GITHUB_TOKEN как запасных вариантов для --github-pat
v1.3.1patch
🕐 3 мес назад · релиз на GitHub ↗

Исправлена ошибка установки через откат npx skills, улучшена обработка backoff в CI/CD и добавлен манифест плагина.

  • Fixed: Откат версии npx skills до 1.5.9 для устранения ложного сообщения об ошибке при выполнении команды setup.
  • Fixed: Улучшена логика обработки backoff для команд CI/CD.
  • Added: Добавлен манифест плагина agent-plugins.org.