KI-Agenten mit dem Agent Development Kit (ADK) in Agent Runtime entwickeln und bereitstellen

KI-Agenten mit dem Agent Development Kit (ADK) in Agent Runtime entwickeln und bereitstellen

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

In dieser Kurzanleitung werden Sie durch die folgenden Schritte geführt:

• Ihr Google Cloud -Projekt einrichten
• Installieren Sie das Agent Platform SDK für Python und das ADK.
• Entwickeln Sie einen Agenten für den Währungsumtausch.
• Stellen Sie den Agenten in Agent Runtime bereit.
• 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. Es wird davon ausgegangen, dass Sie eine lokale IDE und Terminalzugriff verwenden.
• Agent Starter Pack: Eine Sammlung von produktionsreifen Vorlagen für generative KI-Agenten, die für die Agent Platform entwickelt wurden.

Eine Kurzanleitung für andere unterstützte Frameworks als das ADK finden Sie unter KI-Agenten in der Agent Runtime entwickeln und bereitstellen.

Hinweis

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

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach 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 Agent Platform and Cloud Storage APIs, if any are not already enabled.

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 Agent Platform and Cloud Storage APIs, if any are not already enabled.

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 User (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 for 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 Agenten entwickeln und bereitstellen.

   • LOCATION ist eine der unterstützten Regionen.

KI-Agenten entwickeln

1. Entwickeln Sie ein Tool zur Währungsumrechnung 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)
   

   wobei USER_ID eine benutzerdefinierte ID mit einer Zeichenbeschränkung von 128 ist.

KI-Agenten bereitstellen

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

Hinweis: Wenn Sie einen ADK-Agenten auf der Agent Platform bereitstellen, wird automatisch eine verwaltete Sitzungsressource generiert. Sie können die verwaltete Sitzungsressource zusammen mit dem Agenten im Abschnitt „Bereinigung“ 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-Agent 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-Laufzeit einrichten

Umgebung für die Verwendung der Agent Platform-Laufzeit einrichten

Anleitung

Agenten bereitstellen

Hier erfahren Sie, wie Sie einen Agenten auf der Agent Platform Runtime auf fünf verschiedene Arten bereitstellen können, 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

Agenten mit Agent Platform Runtime verwenden

Ressource

Support anfordern

Ressourcen und Support für die Google Agent Platform