Codelab: Cloud Run Day 2025 - Workshop 1

1. Introduzione

Creerai un agente in grado di rispondere a qualsiasi query sulle notizie e lo implementerai in Cloud Run. Le notizie potrebbero riguardare qualsiasi argomento relativo a una sola località, ovvero "Bangalore". Alcune query possono essere:

  • Puoi dirmi alcune delle ultime notizie di Bangalore?
  • Dammi alcune notizie recenti sul traffico di Bangalore.

Puoi eseguire il deployment degli agenti su Cloud Run. Creeremo un semplice agente che utilizza il modello e uno strumento locale, poi lo implementeremo.

Cosa imparerai

  • Come configurare un progetto Google Cloud per Cloud Run.
  • Come creare un semplice agente AI utilizzando Google ADK.
  • Come definire e utilizzare gli strumenti locali all'interno dell'agente.
  • Come creare il pacchetto dell'agente utilizzando Docker.
  • Come eseguire il deployment dell'agente come servizio su Google Cloud Run.
  • Come interagire con l'agente di cui è stato eseguito il deployment tramite un'interfaccia utente web.

Cosa ti serve

  • Un account Gmail
  • Browser Chrome

2. Configurazione

  1. Completa tutte le istruzioni di configurazione qui.
  2. Vai alla directory del primo workshop:
cd Cloud-Run-Day-Workshop-2025/workshop1

3. Esegui il deployment dell'agente in Cloud Run

Una volta che tutti i file sono pronti nell'editor di Cloud Shell, esegui questi comandi nel terminale Cloud Shell per eseguire il deployment del servizio su Cloud Run:

gcloud run deploy news-assistant-agent \
--source . \
--region $REGION \
--project $PROJECT_ID \
--allow-unauthenticated \
--set-env-vars="GOOGLE_GENAI_USE_VERTEXAI=$GOOGLE_GENAI_USE_VERTEXAI,GOOGLE_API_KEY=$GOOGLE_API_KEY"

(Conferma il deployment digitando "Y" quando/se richiesto.)

4. Testare l'agente

Una volta eseguito il deployment, Cloud Shell restituirà l'URL del servizio Cloud Run di cui è stato eseguito il deployment.

Screenshot dell'output dell'URL del servizio Cloud Run

Quando apri il link, puoi interagire direttamente con l'agente utilizzando la UI web dell'ADK:

Screenshot della UI web dell'ADK

5. Esegui la pulizia

Per evitare addebiti futuri, elimina il servizio Cloud Run che hai creato.

gcloud run services delete news-assistant-agent --$REGION $GOOGLE_CLOUD_LOCATION  --quiet

6. Complimenti!

Hai creato ed eseguito correttamente il deployment di un agente AI News in Google Cloud Run.