Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Einen Google-ADK-Agenten importieren — ein Agent auf Gemini

Die Agent Config einer Anwendung, die auf dem Agent Development Kit von Google aufbaut — ein Agent auf Gemini, mit dem Google-Search-Tool, das ADK mitliefert — von aggrega import als Entwurf in Aggrega-Dateien überführt, wobei das Image der Anwendung einmal in einer Antwortdatei angegeben wird, und für Docker Compose gebaut.

Einen Google-ADK-Agenten importieren führt Schritt für Schritt hindurch: der Befehl, wonach er fragt, die Dateien, die er schreibt, und warum jede Zeile dasteht, der Build und der laufende Agent. Dieser Ordner enthält jede Stufe dieser Anleitung:

Ordner oder Dateiwas er enthält
source/die Konfiguration des Agenten, support_agent/root_agent.yaml, die .aggrega-config.yaml, die den Ordner zu einem Workspace macht, und support_agent/import-answers.yaml, die Werte, die keine Konfiguration enthält: das Image der Anwendung und der Name des Kubernetes-Secrets, aus dem ein Build für Kubernetes den Gemini-API-Schlüssel liest
draft/die Dateien, die aggrega import support_agent --target compose geschrieben hat, unverändert, einschließlich release.lock, und was der Befehl ausgegeben hat: stdout.txt auf der Standardausgabe, import.txt auf der Standardfehlerausgabe

Die Konfiguration ist für dieses Beispiel geschrieben. Der Code der Anwendung und die Umgebungsdatei, die das Scaffold von ADK schreibt, gehören nicht dazu: Der Import liest keines von beiden, und das Release nennt das Image, in dem die Anwendung läuft.

In einem Checkout des Dokumentations-Repositorys führt check.sh den Import erneut aus, vergleicht, was er schreibt und ausgibt, mit draft/, vergleicht die Blöcke, die die Anleitung zitiert, mit diesen Dateien und validiert und baut, was der Import geschrieben hat. Es benötigt den Katalog der Standardbibliothek (woher Sie einen bekommen), neben diesem Repository ausgecheckt, oder dessen Verzeichnis in AGGREGA_CATALOG_DIRS angegeben.

Das Beispiel generieren

Sie können den Import dieses Beispiels mit den folgenden Befehlen ausführen oder ihn von Ihrem KI-Assistenten für Sie ausführen lassen.

Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:

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

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd import-google-adk

Build

Der Import entwirft die Aggrega-Dateien neben dem Projekt, in source/. Er gleicht das Projekt mit dem Katalog der Standardbibliothek ab, den die Standard-Registry des Workspace als signierten Snapshot veröffentlicht: Der erste Import ruft ihn ab, verifiziert ihn, legt ihn im Inhalts-Cache des Workspace ab und benennt ihn über seinen Digest in dem Datensatz, den er neben die Entwürfe schreibt. Ein Workspace, der eigene Katalogordner nennt — in AGGREGA_CATALOG_DIRS oder unter workspace.catalog_dirs —, importiert stattdessen gegen diese. Der Import liest das Image aus support_agent/import-answers.yaml und lädt dann, wovon das entworfene Release abhängt, sodass der Build sofort folgen kann:

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

Das Image, das das Beispiel nennt, steht für eines, das Sie aus Ihrem Projekt bauen; wie Sie es bauen und den Stack ausführen, steht in der oben verlinkten Anleitung.

Mit einem KI-Assistenten

Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.

Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `import-google-adk` enthält, rufen Sie das Tool `scaffold` einmal auf, mit `example` auf `import-google-adk` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `import-google-adk`, dessen Ordner `source` enthält, was dieses Beispiel importiert. Rufen Sie dann das Tool `import` auf, mit `workspace_root` auf `import-google-adk/source`, `source` auf `support_agent` und `target` auf `compose` gesetzt: Es liest die benötigten Antworten aus `import-answers.yaml` im Ordner `support_agent`, schreibt seine Entwürfe nach `import-google-adk/source` und lädt herunter, was diese benötigen. Rufen Sie dann das Tool `validate` auf, mit `workspace_root` auf `import-google-adk/source` und `release` auf `release.yaml` gesetzt, und das Tool `build`, mit `workspace_root` auf `import-google-adk/source`, `release` auf `release.yaml` und `write` auf true gesetzt. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `import-google-adk/source/dist/`.

Testen

Wenn der Stack so läuft, wie die Anleitung ihn ausführt, auf dem Image, das ihr Dockerfile baut, senden Sie dem Agenten eine Nachricht an den Port, den das Release veröffentlicht:

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

Der Gemini-Schlüssel des Laufs war ein Platzhalter, daher antwortete die Anfrage mit HTTP 500, Internal Server Error, und das Log des Dienstes nennt die Ablehnung durch 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]}}

Mit --target helm importiert, auf dem Image, das in eine vom Cluster gelesene Registry gepusht wurde, wie die Anleitung zeigt, beantwortet der Agent dieselbe Nachricht unter derselben Adresse, sobald ein lokaler Port an seinen Service weitergeleitet ist:

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