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 Bedingungen. Mit der Funktion „Design-Agents“ in Agent Studio können Kunden „KI-Agents“ gemäß Definition in den dienstspezifischen Nutzungsbedingungen entwerfen. Daher gelten die dienstspezifischen Nutzungsbedingungen für „agentische KI-Services“. Wenn die Google Suche als Tool in Agent Studio verwendet wird, gilt auch der Abschnitt „Fundierung mit der Google Suche“ in den dienstspezifischen Nutzungsbedingungen, mit der Ausnahme, dass der erste Verweis auf „Gemini Enterprise oder Agentspace“ in Unterabsatz (iv) des Abschnitts „Agentische KI Services“ durch „Gemini Enterprise Agent Platform“ ersetzt wird. Bitte lesen Sie die Nutzungsbedingungen aller anderen in Agent Studio verwendeten Tools 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 visueller Low-Code-Designer in der Google Cloud Konsole, der die Entwicklung von Agenten vereinfacht. Sie können Agent-Arbeitsabläufe visuell darstellen, Antworten in Echtzeit testen und mit verschiedenen Konfigurationen experimentieren, bevor Sie den Code bereitstellen oder darauf umstellen.

In diesem Dokument finden Sie einen Überblick über Agent Studio. Außerdem wird erläutert, 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 erstellen 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. Sie können Ihren KI‑Agenten im Arbeitsbereich von Agent Studio entwerfen und speichern. Sie können zwischen den folgenden Tabs wechseln:

   • Ablauf:Erstellen Sie den Haupt- und die Sub-Agents 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 Untervertreter hinzufügen (+) klicken, um Untervertreter hinzuzufügen.

     2. Konfigurieren Sie Ihren Haupt- und Ihre Sub-Agents 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 Ihren Agenten zu unterstützen.

        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.

     3. Klicken Sie in der Kopfzeile des Arbeitsbereichs auf Speichern, um den Agent zu speichern, und folgen Sie der Anleitung. Weitere Informationen finden Sie unter Agent speichern.

   • Tab „Vorschau“:Chatten Sie im Vorschaufenster mit Ihrem Agenten, um seine Funktionen und Antworten zu testen.

4. Klicken Sie auf Code abrufen, um Ihren Agent-Code aufzurufen. Wenn Sie Ihren Agent an einem anderen Ort weiterentwickeln möchten, können Sie den Code kopieren und in einen Code-Editor Ihrer Wahl einfügen.

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

KI-Agenten speichern

Sie müssen einen Agent speichern, bevor Sie ihn in der Vorschau ansehen oder bereitstellen können, da ein nicht gespeicherter Agent noch keine Identität hat. So speichern Sie einen Agent zum ersten Mal:

1. Klicken Sie im Canvas von Agent Studio auf Speichern.

2. Geben Sie im Dialogfeld KI-Agent speichern einen KI-Agentenname ein.

3. Klicken Sie auf Speichern.

Nach dem ersten Speichern werden alle weiteren Änderungen, die Sie vornehmen, automatisch in Agent Studio gespeichert. Wenn Sie versuchen, den Arbeitsbereich zu verlassen, bevor Sie einen neuen Agent gespeichert haben, werden Sie in Agent Studio aufgefordert, ihn zuerst zu speichern.

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 Data Store (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 Speicherort Ihres Datenspeichers.

  • Data Store ID (Datenspeicher-ID): ID der Daten, die eingeschlossen werden sollen, für Firestore im Datastore-Modus (Datastore). 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-Suche:

  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 Informationen zum Dienstkonto 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:Stellen Sie eine direkte Verbindung zu einem MCP-Server (Model Context Protocol) her.

  1. Wenn Sie MCP-Tools hinzufügen möchten, indem Sie eine Verbindung zu einem MCP-Server herstellen, klicken Sie neben MCP-Server auf Hinzufügen (+).
  2. Anzeigename für das MCP:Geben Sie einen Namen für Ihren MCP-Server ein.
  3. Endpunkt-URL:Geben Sie eine Endpunkt-URL für den MCP-Server ein.
  4. Authentifizierung:Autofill-Wert Keine. 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.

Agent über Agent Studio bereitstellen

Nachdem Sie einen Agent erstellt und in der Vorschau angesehen haben, können Sie ihn in der Produktion bereitstellen. So stellen Sie einen Agenten über Agent Studio bereit:

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 eine Meldung auf dem Tab Ablauf des Agent Studio-Arbeitsbereichs 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.

5. Wählen Sie den Tab Playground aus, um den Agent zu testen.

6. Geben Sie eine Testanfrage in den Chatbereich ein, um zu prüfen, ob der Agent ordnungsgemäß ausgeführt wird.

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