google-agents-cli-adk-code

Официальный skill Google Agents CLI ADK Code — справочник для написания Python-агентов на Agent Development Kit. Он применяется, когда нужно написать код агента, добавить tool, callback или state management, определить Agent либо разобрать API-паттерн ADK. В карточке явно указан предел назначения: workflow, scaffold и deployment разделены. Сначала активируют google-agents-cli-workflow, для создания или усиления проекта используют google-agents-cli-scaffold, а развёртывание относится к google-agents-cli-deploy; этот skill не является заменой этим этапам. До написания кода источник требует убедиться, что проект подготовлен. Сначала выполняют agents-cli info и продолжают, если конфигурация уже есть. Для нового проекта вызывают agents-cli scaffold create <name>, а для существующего кода — agents-cli scaffold enhance .. Если проект не scaffolded, написание agent code откладывается. Установка CLI в manifest описана через uv tool install google-agents-cli; для окружения требуется бинарник agents-cli. Справочник ориентирован на Python ADK SDK, поэтому поддержку других языков не следует приписывать этой карточке. Для повторного использования готовых решений нужно начать с references/samples.md. Это topic index с рецептами для sandboxed или per-user code execution, загружаемых агентом SKILL.md-навыков, cross-session memory, approval gates перед рискованными действиями, tool guardrails, credentials per user и scheduled или event-driven runs. Индекс только указывает имя рецепта: перед реализацией нужно клонировать соответствующий пример и прочитать его AGENTS.md. Такой порядок нужен, чтобы не переписывать Docker, E2B sandbox, skill loader, moderation callback или memory store там, где в наборе уже есть проверенный образец. Для обычного Python-агента quick reference показывает Agent с name, model, instruction и tools. В качестве tool используется Python-функция с типизированным аргументом и словарём результата. Дальнейшие темы вынесены в cheatsheets: adk-python.md описывает Agent, tools, callbacks, plugins, state, artifacts, multi-agent systems, SequentialAgent, ParallelAgent, LoopAgent, custom BaseAgent, ManagedAgent, A2A и A2UI; adk-workflows.md предназначен для graph-based Workflow API с nodes, edges, fan-out/fan-in, HITL и parallel processing. Часть API нужно сверять с установленным пакетом, а не выводить по названию раздела. Рабочий маршрут остаётся пошаговым. После подготовки проекта выбирают рецепт или API-справочник, затем пишут логику в согласованной директории. Для быстрого поведения предусмотрен agents-cli run, для интерактивной проверки — agents-cli playground. Smoke prompt не заменяет eval: end-to-end оценка должна проверять поведение, tools, последовательность действий и соблюдение требований через google-agents-cli-eval. Перед deployment отдельно проверяют target через agents-cli info; сам deploy не выполняют без одобрения человека. Ограничения следует считать частью назначения. Навык — краткий кодовый reference, а не гарантия совместимости конкретной версии ADK или готовый production scaffold. Для точных сигнатур и символов источник советует читать установленный ADK package, docs index и целевую страницу документации; версия CLI из frontmatter — ~= 1.3.1, но актуальность окружения нужно проверять через agents-cli info и agents-cli --help. Он помогает выбрать структуру агента, tools, callbacks, state и рецепт, однако не подтверждает качество поведения, права доступа, безопасность, deployment или результаты eval без фактического запуска и проверки.