Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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 plikzawartość
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:

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

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd import-google-adk

Kompilacja

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:

Terminal window
cd source
aggrega import support_agent --target compose
aggrega build --release release.yaml

Obraz 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:

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."}]}}'

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:

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