KI-Agenten mit dem Agent Development Kit entwickeln und in bereitstellen

KI-Agenten mit dem Agent Development Kit entwickeln und in bereitstellen

Mit Agent Runtime können Sie KI-Agenten hosten, die mit dem Agent Development Kit (ADK) entwickelt wurden. In diesem Dokument wird erläutert, wie Sie mit dem ADK einen KI-Agenten erstellen, bereitstellen und testen.

In dieser Kurzanleitung werden folgende Schritte erläutert:

• Ihr Google Cloud Projekt einrichten
• Agent Platform SDK für Python und ADK installieren
• Währungsumtausch-Agent entwickeln
• KI-Agent in Agent Runtime bereitstellen
• Bereitgestellten KI-Agenten testen

Sie können auch die folgenden alternativen Kurzanleitungen für das ADK verwenden:

• ADK-Kurzanleitung: Die ADK-Kurzanleitung wird vollständig auf Ihrem Computer ausgeführt. Dabei wird davon ausgegangen, dass Sie eine lokale IDE und Terminalzugriff verwenden.
• Agent Starter Pack: Eine Sammlung produktionsreifer generativer KI-Agenten-Vorlagen, die für die Agent Platform entwickelt wurden.

Die Kurzanleitung für die Verwendung unterstützter Frameworks, die nicht das Agent Development Kit sind, finden Sie unter KI-Agenten in Agent Runtime entwickeln und bereitstellen.

Hinweis

Hinweis: Zum Aktivieren von APIs benötigen Sie die serviceusage.services.enable Berechtigung. Wenn Sie diese Berechtigung nicht haben, bitten Sie Ihren Administrator, Ihnen die Rolle „Administrator der Dienstnutzung“ (roles/serviceusage.serviceUsageAdmin) zuzuweisen.

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie noch kein Google Cloud-Konto haben, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Verwendung von Agent Runtime benötigen:

• Agent Platform-Nutzer (roles/aiplatform.user)
• Storage-Administrator (roles/storage.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Agent Platform SDK für Python installieren und initialisieren

1. Führen Sie den folgenden Befehl aus, um das Agent Platform SDK für Python und andere erforderliche Pakete zu installieren:

   pip install --upgrade --quiet google-cloud-aiplatform[agent_engines,adk]>=1.112

2. Als Nutzer authentifizieren

   Lokale Shell

   Führen Sie dazu diesen Befehl aus:

   gcloud auth application-default login

   Colab

   Führen Sie den folgenden Code aus:

   from google.colab import auth
   
   auth.authenticate_user(project_id="PROJECT_ID")
   

   Cloud Shell

   Es sind keine weiteren Schritte erforderlich.

3. Führen Sie den folgenden Code aus, um die Agent Platform zu importieren und das SDK zu initialisieren:

   Google Cloud-Projekt

   import vertexai
   
   client = vertexai.Client(
       project="PROJECT_ID",               # Your project ID.
       location="LOCATION",                # Your cloud region.
   )
   

   Wobei:

   • PROJECT_ID ist die Google Cloud Projekt-ID, unter der Sie KI-Agenten entwickeln und bereitstellen.

   • LOCATION ist eine der unterstützten Regionen.

KI-Agenten entwickeln

1. Entwickeln Sie ein Währungsumtausch-Tool für Ihren KI-Agenten:

   def get_exchange_rate(
       currency_from: str = "USD",
       currency_to: str = "EUR",
       currency_date: str = "latest",
   ):
       """Retrieves the exchange rate between two currencies on a specified date."""
       import requests
   
       response = requests.get(
           f"https://api.frankfurter.app/{currency_date}",
           params={"from": currency_from, "to": currency_to},
       )
       return response.json()
   

2. Instanziieren Sie einen KI-Agenten:

   from google.adk.agents import Agent
   from vertexai import agent_engines
   
   agent = Agent(
       model="gemini-3.5-flash",
       name='currency_exchange_agent',
       tools=[get_exchange_rate],
   )
   
   app = agent_engines.AdkApp(agent=agent)
   

3. Testen Sie den KI-Agenten lokal:

   **Hinweis** :Beim lokalen Testen eines ADK-KI-Agenten werden In-Memory-Sitzungen verwendet.

   async for event in app.async_stream_query(
       user_id="USER_ID",
       message="What is the exchange rate from US dollars to SEK today?",
   ):
       print(event)
   

   Dabei ist USER_ID eine nutzerdefinierte ID mit einer Zeichenbegrenzung von 128.

KI-Agenten bereitstellen

Stellen Sie den KI-Agenten bereit, indem Sie in der Agent Platform eine reasoningEngine-Ressource erstellen:

Hinweis: Wenn Sie einen ADK-KI-Agenten in der Agent Platform bereitstellen, wird automatisch eine verwaltete Sitzungsressource generiert. Sie können die verwaltete Sitzungsressource zusammen mit dem KI-Agenten im Abschnitt Bereinigen löschen.

from vertexai import types

remote_agent = client.agent_engines.create(
    agent=app,
    config={
        "requirements": ["google-cloud-aiplatform[agent_engines,adk]"],
        "staging_bucket": "STAGING_BUCKET",
        "identity_type": types.IdentityType.AGENT_IDENTITY,
    }
)

Dabei ist STAGING_BUCKET ein Cloud Storage-Bucket mit dem Präfix gs://.

KI-Agenten verwenden

Testen Sie den bereitgestellten KI-Agenten, indem Sie eine Anfrage senden:

async for event in remote_agent.async_stream_query(
    user_id="USER_ID",
    message="What is the exchange rate from US dollars to SEK today?",
):
    print(event)

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:

remote_agent.delete(force=True)

Nächste Schritte

Anleitung

Agent Platform Runtime einrichten

Richten Sie Ihre Umgebung für die Verwendung von Agent Platform Runtime ein.

Anleitung

KI-Agenten bereitstellen

Hier erfahren Sie mehr über die fünf Möglichkeiten, einen KI-Agenten in Agent Platform Runtime bereitzustellen, je nach Ihren Entwicklungsanforderungen.

Anleitung

Bereitgestellte KI-Agenten verwalten

Hier erfahren Sie, wie Sie KI-Agenten verwalten, die in der verwalteten Laufzeit der Agent Platform bereitgestellt wurden.

Anleitung

KI-Agenten verwenden

KI-Agenten mit Agent Platform Runtime verwenden.

Ressource

Support anfordern

Hier finden Sie Ressourcen und Support für die Google Agent Platform.