Імпорт агента 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