API VEGA

Резюме

Краткое руководство по шаблонам ADK Python: агенты, инструменты, обратные вызовы и управление состоянием.

  • Охватывает создание агента с конфигурацией модели и инструкций, базовое определение инструмента через FunctionTool и шаблоны обратных вызовов для инициализации состояния и хуков жизненного цикла

  • Включает встроенные импорты инструментов, оркестрацию агентов (SequentialAgent, ParallelAgent, LoopAgent) и управление состоянием через CallbackContext

  • ADK 2.0 Workflow API доступен как опциональная экспериментальная функция для пайплайнов на графах с условной маршрутизацией и параллельной обработкой; требуется Python 3.11+ и явное согласие пользователя перед использованием

  • Требуется существующий заготовленный проект; используйте agents-cli scaffold create или scaffold enhance перед написанием кода агента

ADK Code Reference

Активируйте /google-agents-cli-workflow сначала для необходимых фаз разработки и шагов по созданию каркаса.

1. Изучение рецептов (проект не требуется)

Прочитайте индекс тем в references/samples.md перед ответом на вопрос «как построить X». Существуют готовые реализации для: песочничного выполнения кода и кода на уровне конкретного пользователя, навыков, загружаемых агентом через SKILL.md, межсессионной памяти, порогов утверждения перед рискованными действиями, ограничителей инструментов, учетных данных для каждого пользователя и запланированных/событийно-управляемых запусков.

Индекс даёт лишь имя; рецепт — это код. Клонируйте его и прочитайте его AGENTS.md перед тем, как реализовать что-либо из того, что он охватывает. Ручная реализация обёртки песочницы Docker или E2B, загрузчика навыков, модерационного callback или хранилища памяти — для возможности, перечисленной индексом — означает, что вы остановились на имени.

2. Требования к написанию кода

Не пишите код агента до тех пор, пока проект не будет скелетирован.

  • Проверка проекта: запустите agents-cli info (продолжайте, если конфигурация существует).

  • Новый проект: запустите agents-cli scaffold create <name>.

  • Существующий код: запустите agents-cli scaffold enhance ..

Языковая поддержка: Этот справочник охватывает Python ADK SDK. Поддержка других языков скоро будет доступна.