Импорт агента Google ADK — один агент на Gemini
Agent Config приложения, построенного на Agent Development Kit от Google, — один агент на Gemini с инструментом Google Search, который поставляется с ADK, — преобразованный командой aggrega import в черновики файлов Aggrega, с образом приложения, указанным один раз в файле ответов, и собранный для Docker Compose.
Импорт агента Google ADK пошагово разбирает этот процесс: команду, что она запрашивает, файлы, которые она записывает, и зачем в них каждая строка, сборку и работающего агента. В этой папке хранится каждый этап этого руководства:
| папка или файл | что содержит |
|---|---|
source/ | конфигурация агента support_agent/root_agent.yaml, файл .aggrega-config.yaml, который делает папку рабочим пространством, и support_agent/import-answers.yaml — значения, которых нет ни в одной конфигурации: образ приложения и имя Secret в Kubernetes, из которого сборка для Kubernetes читает ключ API Gemini |
draft/ | файлы, которые записала команда aggrega import support_agent --target compose, без изменений, включая release.lock, и то, что она вывела: stdout.txt — стандартный вывод, import.txt — стандартный поток ошибок |
Конфигурация написана для этого примера. Код приложения и файл окружения, который записывает шаблон ADK, в пример не входят: импорт не читает ни то, ни другое, а образ, в котором работает приложение, указывает Release.
В клоне репозитория документации check.sh повторно запускает импорт, сравнивает то, что он записывает и выводит, с draft/, сравнивает блоки, которые цитирует руководство, с этими файлами, а также валидирует и собирает то, что записал импорт. Для этого каталог стандартной библиотеки (где его взять) должен быть извлечён рядом с этим репозиторием или его директория должна быть указана в AGGREGA_CATALOG_DIRS.
Создание примера
Импорт этого примера можно запустить командами ниже или поручить его запуск своему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example import-google-adkЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd import-google-adkСборка
Импорт создаёт черновики файлов Aggrega рядом с проектом, в source/. Он сопоставляет проект с каталогом стандартной библиотеки, который реестр по умолчанию рабочего пространства публикует в виде подписанного снимка: первый импорт получает его, проверяет, хранит в кеше содержимого рабочего пространства и указывает его по дайджесту в записи, которую пишет рядом с черновиками. Рабочее пространство, которое называет собственные папки каталога — в AGGREGA_CATALOG_DIRS или в workspace.catalog_dirs, — вместо этого импортирует относительно них. Импорт читает образ из support_agent/import-answers.yaml, затем загружает то, от чего зависит черновик сущности Release, так что сборка может последовать сразу:
cd sourceaggrega import support_agent --target composeaggrega build --release release.yamlОбраз, который называет пример, заменяет тот, что вы собираете из своего проекта; его сборка и запуск стека описаны в руководстве по ссылке выше.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочей области ещё нет папки `import-google-adk`, вызовите один раз инструмент `scaffold`, задав для `example` значение `import-google-adk` и не указывая `dir`: он запишет пример в новую папку `import-google-adk`, папка `source` которой содержит то, что импортирует этот пример. Затем вызовите инструмент `import`, задав `workspace_root` значение `import-google-adk/source`, `source` — `support_agent`, а `target` — `compose`: он читает нужные ему ответы из `import-answers.yaml` в папке `support_agent`, записывает свои черновики в `import-google-adk/source` и загружает то, что им нужно. Затем вызовите инструмент `validate`, задав `workspace_root` значение `import-google-adk/source`, а `release` — `release.yaml`, и инструмент `build`, задав `workspace_root` значение `import-google-adk/source`, `release` — `release.yaml`, а `write` — true. Скажите мне, какие файлы записала сборка; они находятся в `import-google-adk/source/dist/`.Тестирование
Когда стек работает так, как его запускает руководство, на образе, который собирает его Dockerfile, отправьте агенту сообщение на порт, который публикует сущность Release:
curl -sS -X POST http://127.0.0.1:8000/run -H 'Content-Type: application/json' \ -d '{"app_name": "support_agent", "user_id": "u1", "session_id": "s1", "new_message": {"role": "user", "parts": [{"text": "Where is my order 1234? Answer in one short sentence."}]}}'Ключ Gemini в этом запуске был заглушкой, поэтому запрос ответил HTTP 500, Internal Server Error, а журнал сервиса называет отказ Gemini:
google.genai.errors.ClientError: 400 INVALID_ARGUMENT. {'error': {'code': 400, 'message': 'API key not valid. Please pass a valid API key.', 'status': 'INVALID_ARGUMENT', [… omitted: the error's details]}}После импорта с --target helm, на образе, отправленном в реестр, который читает кластер, как показывает руководство, агент отвечает на то же сообщение по тому же адресу, как только локальный порт перенаправлен на его Service:
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000