Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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

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

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd import-google-adk

Build

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:

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

L’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:

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

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:

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