Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

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

Створення прикладу

Імпорт цього прикладу можна запустити командами нижче або доручити його запуск своєму ШІ-асистентові.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example import-google-adk

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd import-google-adk

Збирання

Імпорт створює чернетки файлів Aggrega поруч із проєктом, у source/. Він зіставляє проєкт із каталогом стандартної бібліотеки, який реєстр за замовчуванням робочого простору публікує як підписаний знімок: перший імпорт отримує його, перевіряє, зберігає в кеші вмісту робочого простору та позначає його дайджестом у записі, який записує поруч із чернетками. Робочий простір, що називає власні теки каталогу — в AGGREGA_CATALOG_DIRS або в workspace.catalog_dirs, — натомість імпортує відносно них. Імпорт читає образ із support_agent/import-answers.yaml, потім завантажує те, від чого залежить чернетка сутності Release, тож збірка може відбутися одразу:

Terminal window
cd source
aggrega import support_agent --target compose
aggrega 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:

Terminal window
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:

Terminal window
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000