Agents in Agent Studio entwerfen

Vorschau

Die Funktion für Design-Agents in Agent Studio unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Beziehung zu anderen Nutzungsbedingungen: Mit den Design-Agents in Agent Studio können Kunden „KI-Agents“ gemäß den dienstspezifischen Nutzungsbedingungen entwerfen. Daher gelten die dienstspezifischen Nutzungsbedingungen für „agentische KI-Services“. Wenn Sie die Google Suche als Tool in Agent Studio verwenden, gilt auch der Abschnitt „Fundierung mit der Google Suche“ in den dienstspezifischen Nutzungsbedingungen. Der erste Verweis auf „Gemini Enterprise oder Agentspace“ in Unterabschnitt (iv) des Abschnitts „agentische KI-Services“ wird jedoch durch „Gemini Enterprise Agent Platform“ ersetzt. Bitte lesen Sie die Nutzungsbedingungen aller anderen Tools, die in Agent Studio verwendet werden, und prüfen Sie, ob Ihr Agent für die Bereitstellung in Agent Runtime geeignet ist, bevor Sie diese Funktion nutzen.

Auf dieser Seite erhalten Sie einen Überblick über die Verwendung von Agent Studio in derGoogle Cloud Console.

Agent Studio ist ein Low-Code-Tool für visuelles Design in der Google Cloud -Konsole, das die Entwicklung von KI-Agenten vereinfacht. Sie können Agent-Workflows visuell darstellen, Antworten in Echtzeit testen und mit verschiedenen Konfigurationen experimentieren, bevor Sie die Bereitstellung vornehmen oder zu Code wechseln.

In diesem Dokument finden Sie einen Überblick über Agent Studio. Außerdem wird beschrieben, wie Sie Ihre Umgebung einrichten, Agents erstellen und testen und sie direkt in einer Produktionslaufzeitumgebung bereitstellen.

Umgebung einrichten

Bevor Sie Agent Studio verwenden, müssen Sie Google Cloud einrichten.

Erforderliche Rollen abrufen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Platform User (roles/aiplatform.user) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie für die Verwendung von Agent Studio benötigen. 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 erstellen

Hinweis:Alle Konfigurationsdateien für erstellte Agents werden in der Region us-west1 gespeichert. Wenn Ihre Organisation Richtlinien hat, die die Verwendung dieser Region verhindern, können Sie möglicherweise keinen Agent erstellen. Weitere Informationen finden Sie unter Ressourcenstandorte einschränken.

So entwerfen und testen Sie einen Agenten in Agent Studio:

1. Rufen Sie in der Google Cloud Console die Seite Agents auf.
   

   Zu „KI-Agenten“

2. Klicken Sie auf Agent erstellen, um die Agent Studio-Arbeitsfläche für einen neuen Agent zu öffnen.

3. Entwerfen Sie Ihren Agenten im Arbeitsbereich von Agent Studio. Sie können zwischen den folgenden Tabs wechseln:

   • Ablauf:Erstellen Sie den Haupt-Agenten und die Sub-Agenten mithilfe einer visuellen Darstellung des Workflows und der Steuerungslogik Ihres Agenten.

     1. Klicken Sie auf einen KI-Agenten, um den Bereich Details für diesen KI-Agenten zu öffnen. Sie können auch auf Sub-Agenten hinzufügen (+) klicken, um Sub-Agents hinzuzufügen.

     2. Konfigurieren Sie Ihren Haupt-Agenten und Ihre Sub-Agenten im Bereich Details:

        1. Name:Geben Sie einen Namen ein, mit dem sich der Agent identifizieren lässt.

        2. Beschreibung:Eine Zusammenfassung des Zwecks Ihres Agents.

        3. Anleitung:Fügen Sie eine Anleitung hinzu, um den KI-Agenten zu steuern.

        4. Modell:Wählen Sie das Modell aus, das für Ihren Agent verwendet werden soll.

        5. Tools:Klicken Sie auf Tools hinzufügen (+), um Tools hinzuzufügen, mit denen der Agent Aufgaben erledigen kann. Weitere Informationen finden Sie unter Tools einrichten und hinzufügen.

   • Vorschau:Testen Sie die Funktionen und Antworten des Agenten, während Sie ihn erstellen. Chatten Sie mit dem Agenten, um seine Funktionen zu testen.

4. Klicken Sie auf Code abrufen, um den Agentencode aufzurufen. Wenn Sie Ihren Agenten an einem anderen Ort weiterentwickeln möchten, können Sie den Code kopieren und in einen Code-Editor Ihrer Wahl einfügen. Weitere Optionen zum Weiterentwickeln Ihres Agenten finden Sie in den ADK-Tutorials.

Sobald Ihr Agent fertig ist, können Sie ihn direkt über Agent Studio bereitstellen. Weitere Informationen finden Sie unter Agent über Agent Studio bereitstellen.

Tools in Agent Studio einrichten und hinzufügen

Sie können die folgenden Tools für Ihren Agenten konfigurieren:

• Google Suche:Ermöglicht es dem Agenten, Websuchen über die Google Suche durchzuführen. Standardmäßig aktiviert.

• URL-Kontext:Das Modell kann URLs aus Prompts analysieren, die an den Agent gesendet werden. Standardmäßig aktiviert.

• Agent Platform Search-Datenspeicher:Klicken Sie auf Hinzufügen (+), damit Ihr Agent auf Informationen zugreifen kann, die in Ihrem Agent Search-Datenspeicher indexiert wurden.

  • Projektnummer:Die Google Cloud Projektnummer, die mit Ihrem Agent Search-Datenspeicher verknüpft ist. Projektnummer ansehen

  • Speicherort:Der Standort Ihres Datenspeichers.

  • Datenspeicher-ID:Firestore-ID im Datastore-Modus (Datastore) der einzubeziehenden Daten. Liste Ihrer Datenspeicher und IDs ansehen

  • Sammlungs-ID: Sammlungs-ID der einzubeziehenden Daten. Liste Ihrer Datenspeicher- und Sammlungs-IDs aufrufen Wenn Ihr Datenspeicher keine Sammlungs-ID hat, geben Sie default_collection ein.

  Wenn Sie noch keinen Datenspeicher haben, erstellen Sie einen. Gewähren Sie dann dem Dienstkonto Zugriff auf die Agent Platform Search:

  1. Rufen Sie in der Google Cloud Console die Seite IAM auf.
     

     Zur Identitäts- und Zugriffsverwaltung (IAM)

  2. Klicken Sie auf Zugriff erlauben.

  3. Geben Sie im Feld Neue Hauptkonten die folgenden Dienstkontoinformationen ein: [e-mail].

  4. Wählen Sie + Rollen hinzufügen aus. Suchen Sie nach Discovery Engine User (Discovery Engine-Nutzer) und wählen Sie diese Option aus. Klicken Sie auf Anwenden und dann auf Speichern.

• MCP-Server:Klicken Sie auf Hinzufügen (+), um MCP-Tools hinzuzufügen, indem Sie eine Verbindung zu einem MCP-Server herstellen.

  1. Anzeigename für das MCP:Geben Sie einen Namen für Ihren MCP-Server ein.

  2. Endpunkt-URL:Geben Sie eine Endpunkt-URL für den MCP-Server ein.

  3. Authentifizierung:Wird automatisch als Keine ausgefüllt. Agent Studio unterstützt nur MCP-Server, für die keine Authentifizierung erforderlich ist.

  Ihr Agent kann alle Tools auf Ihrem verbundenen MCP-Server verwenden.

KI‑Agenten über Agent Studio bereitstellen

Nachdem Sie einen Agenten erstellt und eine Vorschau davon aufgerufen haben, können Sie ihn in der Produktion bereitstellen. Gehen Sie dazu so vor:

1. Klicken Sie auf der Listenseite Agents auf den Agent, den Sie bereitstellen möchten. Die Seite mit den Agent-Details für den ausgewählten Agent wird angezeigt.

2. Klicken Sie auf Bereitstellen, um das Dialogfeld In einer Agent Runtime-Instanz bereitstellen zu öffnen.

3. Optional: Bearbeiten Sie den Anzeigenamen oder die Beschreibung für Ihren Agent.

4. Wählen Sie eine Bereitstellungsregion aus der Liste der verfügbaren Regionen aus und klicken Sie auf OK.

5. Klicken Sie auf Bereitstellen.

Bei der Bereitstellung wird eine neue Laufzeitinstanz erstellt. Das kann bis zu fünf Minuten dauern. Bei Erfolg wird auf dem Tab Flow des Agent Studio-Arbeitsbereichs eine Meldung angezeigt. Ihr Agent ist jetzt in der Produktion verfügbar und kann sicher in Ihre externen Apps eingebunden werden.

Bereitgestellten KI-Agenten ansehen

So rufen Sie Ihren bereitgestellten KI-Agenten auf:

1. Rufen Sie in der Google Cloud Console die Seite Agent Platform auf.
   

   Zur Agent Platform

2. Verwenden Sie die Liste Region, um nach Bereitstellungsregion zu filtern.

3. Bereitgestellte Agents, die Teil des ausgewählten Projekts sind, werden in der Liste angezeigt.

4. Klicken Sie auf den Namen des angegebenen Agents. Die Seite Messwerte für den Agenten wird geöffnet.

Weitere Informationen zu den verfügbaren Messwerten für Ihren Agenten finden Sie unter Messwerte für Ihren bereitgestellten Agenten ansehen.