Import agenta Google ADK — jeden agent na Gemini
Konfiguracja Agent Config aplikacji zbudowanej na Agent Development Kit Google — jeden agent na Gemini, z narzędziem Google Search dostarczanym przez ADK — przekształcona przez aggrega import w szkice plików Aggrega, z obrazem aplikacji podanym raz w pliku odpowiedzi, i skompilowana dla Docker Compose.
Import agenta Google ADK omawia to krok po kroku: polecenie, o co pyta, pliki, które zapisuje, i dlaczego znajduje się w nich każdy wiersz, kompilację oraz działającego agenta. Ten folder zawiera każdy etap tego przewodnika:
| folder lub plik | zawartość |
|---|---|
source/ | konfiguracja agenta, support_agent/root_agent.yaml, .aggrega-config.yaml, który czyni folder obszarem roboczym, oraz support_agent/import-answers.yaml, wartości, których nie zawiera żadna konfiguracja: obraz aplikacji oraz nazwa Secretu Kubernetes, z którego kompilacja dla Kubernetes odczytuje klucz API Gemini |
draft/ | pliki zapisane przez aggrega import support_agent --target compose, bez zmian, łącznie z release.lock, oraz to, co polecenie wypisało: stdout.txt na standardowe wyjście, import.txt na standardowe wyjście błędów |
Konfiguracja jest napisana na potrzeby tego przykładu. Kod aplikacji i plik środowiskowy zapisywany przez szkielet ADK nie są jej częścią: import nie czyta żadnego z nich, a encja Release wskazuje obraz, w którym działa aplikacja.
W kopii repozytorium dokumentacji check.sh ponownie uruchamia import, porównuje to, co zapisuje i wypisuje, z draft/, porównuje bloki cytowane w przewodniku z tymi plikami oraz waliduje i kompiluje to, co zapisał import. Wymaga katalogu biblioteki standardowej (skąd go pobrać) pobranego obok tego repozytorium albo jego folderu wskazanego w AGGREGA_CATALOG_DIRS.
Generowanie przykładu
Import tego przykładu można uruchomić poleceniami poniżej albo zlecić jego uruchomienie swojemu asystentowi AI.
Należy zapisać przykład w nowym folderze nazwanym tak jak on:
aggrega scaffold --example import-google-adkNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd import-google-adkKompilacja
Import tworzy szkice plików Aggrega obok projektu, w source/. Porównuje projekt z katalogiem biblioteki standardowej, który domyślny rejestr obszaru roboczego publikuje jako podpisaną migawkę: pierwszy import pobiera go, weryfikuje, przechowuje w pamięci podręcznej treści obszaru roboczego i wskazuje go przez jego skrót w rekordzie, który zapisuje obok szkiców. Obszar roboczy, który wskazuje własne foldery katalogu — w AGGREGA_CATALOG_DIRS lub pod workspace.catalog_dirs — importuje zamiast tego względem nich. Import odczytuje obraz z support_agent/import-answers.yaml, a następnie ściąga to, od czego zależy szkic encji Release, więc kompilacja może nastąpić od razu:
cd sourceaggrega import support_agent --target composeaggrega build --release release.yamlObraz wskazany w przykładzie zastępuje obraz budowany z własnego projektu; jego budowanie i uruchamianie stosu opisuje przewodnik podlinkowany powyżej.
Z asystentem AI
Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.
Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder obszaru roboczego nie zawiera jeszcze folderu `import-google-adk`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `import-google-adk` i bez `dir`: zapisze ono przykład w nowym folderze `import-google-adk`, którego folder `source` zawiera to, co importuje ten przykład. Następnie wywołaj narzędzie `import` z `workspace_root` ustawionym na `import-google-adk/source`, `source` ustawionym na `support_agent` i `target` ustawionym na `compose`: odczytuje ono potrzebne odpowiedzi z `import-answers.yaml` w folderze `support_agent`, zapisuje swoje szkice w `import-google-adk/source` i pobiera to, czego one potrzebują. Następnie wywołaj narzędzie `validate` z `workspace_root` ustawionym na `import-google-adk/source` i `release` ustawionym na `release.yaml` oraz narzędzie `build` z `workspace_root` ustawionym na `import-google-adk/source`, `release` ustawionym na `release.yaml` i `write` ustawionym na true. Powiedz mi, które pliki zapisała kompilacja; znajdują się w `import-google-adk/source/dist/`.Testowanie
Gdy stos działa tak, jak uruchamia go przewodnik, na obrazie budowanym przez jego Dockerfile, należy wysłać do agenta wiadomość na port publikowany przez encję 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."}]}}'Klucz Gemini użyty w przebiegu był symbolem zastępczym, więc żądanie odpowiedziało HTTP 500, Internal Server Error, a dziennik usługi wskazuje odrzucenie przez 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]}}Po zaimportowaniu z --target helm, na obrazie wypchniętym do rejestru odczytywanego przez klaster, jak pokazuje przewodnik, agent odpowiada na tę samą wiadomość pod tym samym adresem, gdy tylko lokalny port zostanie przekierowany do jego Service:
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000