Codelab: Cloud Run Day 2025 – Workshop 1

1. Einführung

Sie erstellen einen Agent, der alle Fragen zu Nachrichten beantworten kann, und stellen ihn in Cloud Run bereit. Die Nachrichten können sich auf ein beliebiges Thema beziehen, das nur einen Ort betrifft: Bengaluru. Beispiele für solche Anfragen:

  • Kannst du mir etwas über die aktuellen Nachrichten aus Bengaluru erzählen?
  • Gib mir einige aktuelle Nachrichten zum Verkehr in Bengaluru.

Sie können Agents in Cloud Run bereitstellen. Wir erstellen einen einfachen Agent, der das Modell und ein lokales Tool verwendet, und stellen ihn dann bereit.

Lerninhalte

  • Ein Google Cloud-Projekt für Cloud Run einrichten
  • Einen einfachen KI-Agenten mit dem Google ADK erstellen
  • Lokale Tools im Agent definieren und verwenden
  • So verpacken Sie den Agent mit Docker.
  • So stellen Sie den Agent als Dienst in Google Cloud Run bereit.
  • So interagieren Sie über eine Weboberfläche mit dem bereitgestellten Agent.

Das brauchen Sie

  • Ein Gmail-Konto
  • Chrome-Browser

2. Einrichtung

  1. Hier finden Sie eine vollständige Anleitung.
  2. Wechseln Sie zum Verzeichnis für den ersten Workshop:
cd Cloud-Run-Day-Workshop-2025/workshop1

3. Agent in Cloud Run bereitstellen

Wenn Sie alle Dateien im Cloud Shell-Editor haben, führen Sie die folgenden Befehle im Cloud Shell-Terminal aus, um den Dienst in Cloud Run bereitzustellen:

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"

(Bestätigen Sie die Bereitstellung, indem Sie „Y“ eingeben, wenn Sie dazu aufgefordert werden.)

4. Agent testen

Nach erfolgreicher Bereitstellung gibt Cloud Shell die URL für den bereitgestellten Cloud Run-Dienst aus.

Screenshot der Ausgabe der Cloud Run-Dienst-URL

Wenn Sie den Link öffnen, können Sie direkt über die ADK-Web-UI mit Ihrem Agent interagieren:

Screenshot der ADK-Web-UI

5. Bereinigen

Löschen Sie den erstellten Cloud Run-Dienst, um zukünftige Gebühren zu vermeiden.

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

6. Glückwunsch!

Sie haben erfolgreich einen KI-Nachrichtenagenten in Google Cloud Run erstellt und bereitgestellt.