Importare un agente Google ADK — un agente su Gemini
L’Agent Config di un’applicazione costruita sull’Agent Development Kit di Google — un agente su Gemini, con lo strumento Google Search fornito da ADK — trasformato in bozze di file Aggrega da aggrega import, con l’immagine dell’applicazione indicata una sola volta in un file di risposte, e compilato per Docker Compose.
Importare un agente Google ADK lo illustra passo per passo: il comando, ciò che chiede, i file che scrive e perché ogni riga è lì, la compilazione e l’agente in esecuzione. Questa cartella contiene ogni fase di quella procedura guidata:
| cartella o file | cosa contiene |
|---|---|
source/ | la configurazione dell’agente, support_agent/root_agent.yaml, il .aggrega-config.yaml che rende la cartella un workspace, e support_agent/import-answers.yaml, i valori che nessuna configurazione contiene: l’immagine dell’applicazione e il nome del Secret di Kubernetes da cui una build per Kubernetes legge la chiave API di Gemini |
draft/ | i file che aggrega import support_agent --target compose ha scritto, invariati, release.lock compreso, e ciò che ha stampato: stdout.txt sullo standard output, import.txt sullo standard error |
La configurazione è scritta per questo esempio. Il codice dell’applicazione e il file di ambiente che lo scaffold di ADK scrive non ne fanno parte: l’importazione non legge né l’uno né l’altro, e la Release indica l’immagine in cui l’applicazione viene eseguita.
In un checkout del repository della documentazione, check.sh esegue di nuovo l’importazione, confronta ciò che scrive e stampa con draft/, confronta i blocchi citati dalla procedura guidata con questi file, e convalida e compila ciò che l’importazione ha scritto. Richiede il catalogo della libreria standard (dove procurarselo) estratto accanto a questo repository, oppure la sua directory indicata in AGGREGA_CATALOG_DIRS.
Generare l’esempio
Puoi eseguire l’importazione di questo esempio con i comandi qui sotto, oppure far sì che il tuo assistente AI la esegua per te.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example import-google-adkPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd import-google-adkBuild
L’import scrive le bozze dei file Aggrega accanto al progetto, in source/. Confronta il progetto con il catalogo della libreria standard, che il registry predefinito del workspace pubblica come snapshot firmato: il primo import lo scarica, lo verifica, lo conserva nella cache dei contenuti del workspace e lo indica tramite il suo digest nel record che scrive accanto alle bozze. Un workspace che indica cartelle di catalogo proprie — in AGGREGA_CATALOG_DIRS, oppure sotto workspace.catalog_dirs — esegue invece l’import rispetto a quelle. L’import legge l’immagine da support_agent/import-answers.yaml, poi scarica ciò da cui dipende la Release in bozza, così la compilazione può seguire subito:
cd sourceaggrega import support_agent --target composeaggrega build --release release.yamlL’immagine indicata dall’esempio rappresenta una che compili a partire dal tuo progetto; come compilarla ed eseguire lo stack è spiegato nella procedura guidata collegata sopra.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `import-google-adk`, chiama una volta lo strumento `scaffold` con `example` impostato a `import-google-adk` e senza `dir`: scrive l’esempio in una nuova cartella `import-google-adk`, la cui cartella `source` contiene ciò che questo esempio importa. Poi chiama lo strumento `import` con `workspace_root` impostato a `import-google-adk/source`, `source` impostato a `support_agent` e `target` impostato a `compose`: legge le risposte di cui ha bisogno da `import-answers.yaml` nella cartella `support_agent`, scrive le sue bozze in `import-google-adk/source` e scarica ciò di cui hanno bisogno. Poi chiama lo strumento `validate` con `workspace_root` impostato a `import-google-adk/source` e `release` impostato a `release.yaml`, e lo strumento `build` con `workspace_root` impostato a `import-google-adk/source`, `release` impostato a `release.yaml` e `write` impostato a true. Dimmi quali file ha scritto la build; si trovano in `import-google-adk/source/dist/`.Eseguire il test
Con lo stack in esecuzione come lo esegue la guida, sull’immagine che costruisce il suo Dockerfile, invia un messaggio all’agente sulla porta che la Release pubblica:
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 chiave Gemini usata nell’esecuzione era un segnaposto, quindi la richiesta ha risposto HTTP 500, Internal Server Error, e il log del servizio riporta il rifiuto di 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]}}Importato con --target helm, sull’immagine caricata in un registry che il cluster legge, come mostra la guida, l’agente risponde allo stesso messaggio allo stesso indirizzo una volta inoltrata una porta locale al suo Service:
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000