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 neuesten 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 Agenten, der das Modell und ein lokales Tool verwendet, und stellen ihn dann bereit.
Lerninhalte
- So richten Sie ein Google Cloud-Projekt für Cloud Run ein.
- Einen einfachen KI-Agenten mit dem Google ADK erstellen
- Lokale Tools im Agent definieren und verwenden
- So verpacken Sie den Agenten 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. Google Cloud-Umgebung einrichten
Cloud-Guthaben erhalten
Lösen Sie Ihr Geschenk ein, damit Sie das Guthaben für die Bereitstellung nutzen können. Verwenden Sie Ihr Gmail-Konto.
Projekt erstellen
- Wählen Sie in der Google Cloud Console auf der Seite zur Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
- Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
- Aktivieren Sie Cloud Shell, indem Sie auf diesen Link klicken.
- Führen Sie in Cloud Shell den folgenden Befehl aus, um das aktive Konto festzulegen:
gcloud config set account <ACCOUNT>
ACCOUNT ist die Gmail-Adresse, mit der Sie sich in Google Cloud angemeldet haben.
- Prüfen Sie Ihre Authentifizierung, indem Sie den folgenden Befehl in der Cloud Shell ausführen:
gcloud auth list
- Bestätigen Sie die Projekt-ID mit dem folgenden Befehl:
gcloud config list project
- Legen Sie die Variable für die Projekt-ID fest. Ersetzen Sie <YOUR_PROJECT_ID> durch die ID aus dem vorherigen Schritt:
export PROJECT_ID=<YOUR_PROJECT_ID> && gcloud config set project $PROJECT_ID
export REGION=europe-west1 && gcloud config set run/region $REGION
- Google API-Schlüssel festlegen:
Generieren Sie Ihren API-Schlüssel unter https://aistudio.google.com/app/apikey und fügen Sie ihn hier ein:
export GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE
export GOOGLE_GENAI_USE_VERTEXAI=FALSE
- Aktivieren Sie die erforderlichen APIs:
gcloud services enable cloudresourcemanager.googleapis.com \
servicenetworking.googleapis.com \
run.googleapis.com \
cloudbuild.googleapis.com \
artifactregistry.googleapis.com \
aiplatform.googleapis.com \
compute.googleapis.com \
storage.googleapis.com
Das kann einige Minuten dauern.
Codebeispiele für Cloud Run Day-Workshops klonen
Wenn Sie auf den Beispielcode für alle Workshops zugreifen möchten, klonen Sie das gesamte Repository:
git clone https://github.com/shrutimantri/first-adk-agent5.git
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 bei Aufforderung „Y“ eingeben.)
4. Agent testen
Nach erfolgreicher Bereitstellung gibt Cloud Shell die URL für den bereitgestellten Cloud Run-Dienst aus.
Wenn Sie den Link öffnen, können Sie direkt über die ADK-Web-UI mit Ihrem Agenten interagieren:
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 $REGION $GOOGLE_CLOUD_LOCATION --quiet
6. Glückwunsch!
Sie haben erfolgreich einen KI-Nachrichtenagenten erstellt und in Google Cloud Run bereitgestellt.