Importer un agent Google ADK — un agent sur Gemini
L’Agent Config d’une application construite sur l’Agent Development Kit de Google — un agent sur Gemini, avec l’outil Google Search fourni par ADK — transformée en brouillons de fichiers Aggrega par aggrega import, avec l’image de l’application indiquée une seule fois dans un fichier de réponses, et compilée pour Docker Compose.
Importer un agent Google ADK le présente pas à pas : la commande, ce qu’elle demande, les fichiers qu’elle écrit et la raison d’être de chaque ligne, la compilation, et l’agent en cours d’exécution. Ce dossier contient chaque étape de ce tutoriel :
| dossier ou fichier | ce qu’il contient |
|---|---|
source/ | la configuration de l’agent, support_agent/root_agent.yaml, le .aggrega-config.yaml qui fait du dossier un espace de travail, et support_agent/import-answers.yaml, les valeurs qu’aucune configuration ne contient : l’image de l’application et le nom du Secret Kubernetes dans lequel une compilation pour Kubernetes lit la clé d’API Gemini |
draft/ | les fichiers que aggrega import support_agent --target compose a écrits, inchangés, release.lock compris, et ce qu’il a affiché : stdout.txt sur la sortie standard, import.txt sur la sortie d’erreur standard |
La configuration est écrite pour cet exemple. Le code de l’application et le fichier d’environnement qu’écrit l’échafaudage d’ADK n’en font pas partie : l’import ne lit ni l’un ni l’autre, et la Release nomme l’image dans laquelle l’application s’exécute.
Dans un checkout du dépôt de la documentation, check.sh exécute à nouveau l’import, compare ce qu’il écrit et affiche avec draft/, compare les blocs que le tutoriel cite avec ces fichiers, et valide et compile ce que l’import a écrit. Il nécessite le catalogue de la bibliothèque standard (où en obtenir un) extrait à côté de ce dépôt, ou son répertoire indiqué dans AGGREGA_CATALOG_DIRS.
Générer l’exemple
Vous pouvez exécuter l’import de cet exemple avec les commandes ci-dessous, ou le faire exécuter par votre assistant IA.
Écrivez l’exemple dans un nouveau dossier qui porte son nom :
aggrega scaffold --example import-google-adkElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd import-google-adkBuild
L’import rédige les brouillons des fichiers Aggrega à côté du projet, dans source/. Il évalue le projet au regard du catalogue de la bibliothèque standard, que le registre par défaut de l’espace de travail publie sous forme d’instantané signé : le premier import le récupère, le vérifie, le conserve dans le cache de contenu de l’espace de travail et le désigne par son condensé dans l’enregistrement qu’il écrit à côté des brouillons. Un espace de travail qui nomme ses propres dossiers de catalogue — dans AGGREGA_CATALOG_DIRS, ou sous workspace.catalog_dirs — importe plutôt au regard de ceux-ci. L’import lit l’image dans support_agent/import-answers.yaml, puis récupère ce dont dépend la Release rédigée, si bien que la compilation suit aussitôt :
cd sourceaggrega import support_agent --target composeaggrega build --release release.yamlL’image que nomme l’exemple tient lieu de celle que vous construisez à partir de votre projet ; sa construction et l’exécution de la stack sont décrites dans le tutoriel indiqué ci-dessus.
Avec un assistant IA
Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.
Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `import-google-adk`, appelez une fois l’outil `scaffold` avec `example` défini à `import-google-adk` et sans `dir` : il écrit l’exemple dans un nouveau dossier `import-google-adk`, dont le dossier `source` contient ce que cet exemple importe. Appelez ensuite l’outil `import` avec `workspace_root` défini à `import-google-adk/source`, `source` défini à `support_agent` et `target` défini à `compose` : il lit les réponses dont il a besoin dans le fichier `import-answers.yaml` du dossier `support_agent`, écrit ses brouillons dans `import-google-adk/source` et récupère ce dont ils ont besoin. Appelez ensuite l’outil `validate` avec `workspace_root` défini à `import-google-adk/source` et `release` défini à `release.yaml`, puis l’outil `build` avec `workspace_root` défini à `import-google-adk/source`, `release` défini à `release.yaml` et `write` défini à true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `import-google-adk/source/dist/`.Tester
Avec la stack en cours d’exécution telle que le guide l’exécute, sur l’image que construit son Dockerfile, envoyez un message à l’agent sur le port que la Release publie :
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."}]}}'La clé Gemini de l’exécution était un espace réservé, la requête a donc répondu HTTP 500, Internal Server Error, et le journal du service indique le refus de 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]}}Importé avec --target helm, sur l’image poussée vers un registre que le cluster lit, comme le montre le guide, l’agent répond au même message à la même adresse une fois un port local redirigé vers son Service :
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000