Workflow-KI-Agent freigeben

Vorabzugriff – Workflow-Agent

Diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen und den Zusatzbedingungen für Vorschauprodukte auf Basis von generativer KI. 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.

Sie können Workflow-Agenten, die Sie mit Workflow Builder erstellt und gestartet haben, für andere Nutzer in Ihrer Organisation freigeben.

Mit der Freigabe von Agenten haben Sie folgende Möglichkeiten:

• Sie können Live-Agenten für Nutzer und Gruppen in Ihrer Organisation freigeben.
• Sie können benutzerdefinierte Ausführungszeitpläne oder ereignisbasierte Trigger einrichten.
• Sie können Vorschauausführungen und automatisierte Ausführungen verfolgen.
• Sie können freigegebene Workflow-Agenten duplizieren, um ihre Schritte anzupassen.

Je nach den Konfigurationen der Funktionssteuerung Ihrer App müssen Sie möglicherweise eine Administratorgenehmigung einholen, bevor Sie einen Agenten freigeben können.

Achtung:Wenn Sie einen Agenten freigeben, geben Sie auch den Zugriff auf alle zugehörigen Datenquellen und Dateien frei. Nutzer können den Agenten nach dem Inhalt dieser Quellen fragen, auch wenn sie keinen direkten Zugriff auf die Datei oder Datenquelle haben.

Wenn Sie beispielsweise eine vertrauliche Datei in den Wissensbereich des Agenten hochladen und den Agenten dann freigeben, kann jeder Nutzer mit Zugriff dem Agenten Fragen zum Inhalt dieser Datei stellen.

Workflow-Agent freigeben

So geben Sie einen Workflow-Agenten frei:

App

1. Öffnen Sie Ihre Gemini Enterprise-App und rufen Sie die Seite Agentengalerie auf.

   Die Seite Agentengalerie wird angezeigt. Dort sind alle vor- und benutzerdefinierten KI-Agenten zu sehen.

2. Suchen Sie im Bereich Ihre Agenten nach dem Agenten, den Sie freigeben möchten.

   **Hinweis**: Sie können einen Agenten freigeben, der sich im Status draft befindet. Andere Nutzer können ihn jedoch erst ausführen, wenn er aktiviert wurde.

3. Klicken Sie rechts oben in der Kopfzeile des Workflow Builder-Canvas auf Teilen.

4. Geben Sie die E-Mail-Adressen der Nutzer oder Google-Gruppen ein, für die Sie den Agenten freigeben möchten.

   Hinweis: Sie können Ihren Agenten für einzelne Nutzer-E-Mail-Adressen freigeben. Die Freigabe für Google-Gruppen ist für Endnutzer nicht aktiviert. Ein Gemini Enterprise-App-Administrator oder ein beliebiger Nutzer mit der Rolle „Discovery Engine Admin“ (discoveryengine.admin) kann die Gruppenfreigabe auf Gemini Enterprise-App- Ebene aktivieren.

5. Klicken Sie auf Fertig.

   Hinweis: Wenn Ihr App-Administrator die Administratorüberprüfung für die Freigabe von Agenten aktiviert hat, wird eine Freigabeanfrage zur Überprüfung und Genehmigung an den App-Administrator gesendet. Nachdem der App-Administrator die Anfrage genehmigt hat, wird der Agent für die Nutzer in der Zugriffsliste freigegeben. Sie können die Freigabeanfrage jederzeit bearbeiten, um Nutzer hinzuzufügen oder zu entfernen, oder die Anfrage abbrechen.

Steuerung der Administratorüberprüfung

Standardmäßig können Agenteneigentümer ihre Agenten für jeden Nutzer in ihrer Organisation freigeben, ohne die Genehmigung eines App-Administrators einholen zu müssen. App Administratoren können jedoch die Konfigurationen der App Funktionssteuerung ändern, um eine Administratorüberprüfung und -genehmigung für die Freigabe von Agenten in der App zu erzwingen.

Standardmäßig können Agenteneigentümer ihre Agenten nicht für Gruppen freigeben. Der Gemini Enterprise-App-Administrator kann jedoch festlegen, dass Agenten für Google-Gruppen freigegeben werden können – mit oder ohne Administratorgenehmigung.

Der Freigabeprozess

Nur die erste Freigabe eines Agenten erfordert eine Administratorüberprüfung und -genehmigung. Für nachfolgende Agentenüberarbeitungen ist keine erneute Genehmigung erforderlich.

Die Freigabe von Agenten folgt einem zweistufigen Prozess, wenn die Administratorüberprüfung aktiviert ist:

1. Der Agenteneigentümer gibt den Agenten für einen oder mehrere Nutzer oder Google-Gruppen frei.

2. Der App-Administrator überprüft die Freigabeanfrage und genehmigt oder lehnt sie ab.

Freigabeanfrage überprüfen

App-Administratoren sind für die Überprüfung und Verwaltung von Freigabeanfragen für Agenten verantwortlich.

Hinweise:

• Dieser Abschnitt gilt nur, wenn die Funktion „Freigabe von Agenten ohne Administratorgenehmigung aktivieren“ in den Funktionssteuerungen der App deaktiviert ist.
• Nur App-Administratoren mit der IAM-Rolle „Gemini Enterprise Admin“ können Freigabeanfragen überprüfen und genehmigen.

Console

So überprüfen Sie als App-Administrator eine Freigabeanfrage:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Apps auf.

   Gemini Enterprise

2. Klicken Sie auf den Namen der App, die den Agenten enthält.

3. Klicken Sie im Navigationsmenü der App auf Agenten.

4. Suchen Sie in der Spalte Nutzerberechtigungen nach dem Agenten mit der Aktion Freigabeanfrage überprüfen.

   

5. Klicken Sie auf Freigabeanfrage überprüfen.

6. Im Bereich Freigabeanfrage haben Sie folgende Möglichkeiten:

   • Sehen Sie sich die Zugriffsliste unter Freigabe für die folgenden Nutzer angefordert an.
   • Optional: Ändern Sie die Zugriffsliste, um Nutzerkonten, Google-Gruppen oder WIF-Identitätspools hinzuzufügen oder zu entfernen.

7. Wenn Sie die Anfrage genehmigen und Zugriff gewähren möchten, klicken Sie auf Genehmigen und aktivieren.

8. Wenn Sie die Anfrage ablehnen möchten, klicken Sie auf Ablehnen.

Freigegebenen Agenten verwenden

Wenn ein Agenteneigentümer einen Workflow-Agenten für Sie freigibt, können Sie auf die Diagrammkonfiguration zugreifen und eine Vorschau davon ansehen. Das Workflow-Diagramm ist für freigegebene Nutzer schreibgeschützt. Sie können jedoch manuell eine Vorschau ausführen, eigene Triggereinstellungen konfigurieren, Ihren eigenen Ausführungsverlauf ansehen, oder eine Kopie des Agenten erstellen.

App

1. Öffnen Sie Ihre Gemini Enterprise-Webanwendung in einem Browser.
2. Klicken Sie im Navigationsmenü der Webanwendung auf Agenten.
3. Rufen Sie den Bereich Für mich freigegeben > Von meiner Organisation auf.

4. Klicken Sie auf den freigegebenen Workflow-Agenten, den Sie sich ansehen möchten. Der Agent wird in einem schreibgeschützten Designer-Layout gestartet, in dem das Live-Knotendiagramm angezeigt wird. Hinweis: Wenn der freigegebene Agent gesperrt oder deaktiviert ist, wird das Workflow Builder-Canvas nicht gerendert. Sie können sich aber trotzdem die Ausführungen ansehen.

5. Optional: So führen Sie einen manuellen Testlauf des Agentenworkflows aus:

   • Klicken Sie rechts oben in der Kopfzeile des Workflow Builder-Canvas auf Vorschau.
   • Führen Sie die Vorschau aus. Wenn die Vorschauausführung fehlschlägt, weil ein vom Workflow verwendeter Connector nicht autorisiert ist, klicken Sie unter der Fehlermeldung auf Connectors aktivieren , um den OAuth-Ablauf abzuschließen.

Eigene Trigger einrichten

Trigger für einen freigegebenen Agenten sind nutzerspezifisch. Sie können einen benutzerdefinierten Ausführungszeitplan oder Ereignisfilter konfigurieren, um einen freigegebenen Agenten automatisch auszuführen.

So richten Sie eigene Trigger ein:

App

1. Öffnen Sie Ihre Gemini Enterprise-Webanwendung in einem Browser.
2. Klicken Sie im Navigationsmenü der Webanwendung auf Agenten > Galerie.
3. Rufen Sie den Bereich Für mich freigegeben > Von meiner Organisation auf und klicken Sie auf den freigegebenen Workflow-Agenten, für den Sie einen Trigger einrichten möchten.

4. Greifen Sie auf die Triggerkonfiguration zu:

   • Wählen Sie das Aktionen-Menü > Trigger einrichten aus.
   • Alternativ können Sie den Workflow-Agenten im Workflow Builder-Editor-Canvas öffnen, auf den Agententitel klicken und Trigger einrichten auswählen.

5. Sie können einen Trigger mit einem der folgenden Modi konfigurieren:

   • Zeitplan:Wählen Sie Nach Zeitplan ausführen aus und konfigurieren Sie, wann der Agent für Sie ausgeführt werden soll (z. B. Häufigkeit und Zeitzone).
   • Ereignis:Wählen Sie Bei App-Ereignissen ausführen aus und konfigurieren Sie die Ereignisfilter, um festzulegen, wann der Agent für Sie ausgeführt werden soll. Für einen Google Drive-Ereignistrigger können Sie beispielsweise nach Feldern wie Inhaber (z. B. eine Google-ID wie janedoe), Name, MIME-Typ, Änderungszeit oder Übergeordneter Ordner filtern. Wählen Sie einen Operator aus (z. B. enthält oder ist gleich), geben Sie einen Wert ein und kombinieren Sie mehrere Regeln mit den Bedingungen UND oder ODER.

6. Wenn der Workflow Connectors verwendet, die eine Authentifizierung erfordern (z. B. Connectors, die in einem Agentenschritt und nicht im Trigger selbst verwendet werden), aktivieren und autorisieren Sie die Connectors im Workflow Builder-Canvas-Editor, wenn Sie dazu aufgefordert werden.

7. Klicken Sie auf Speichern. Der Trigger wird gespeichert und führt den Agenten automatisch aus. Sie können den Agenten manuell auslösen , um eine Vorschau zu sehen, was passiert, wenn der Zeitplan- oder Ereignistrigger diesen Agenten ausführt. Wenn Sie die Ausführung des Agenten beenden möchten, wählen Sie im Fenster Trigger einrichten die Option Nicht bei App-Ereignissen ausführen oder Nicht nach Zeitplan ausführen aus.

Ausführungen ansehen

So sehen Sie sich Ihre Ausführungen an:

App

1. Klicken Sie im Navigationsmenü der Webanwendung auf Agenten.
2. Rufen Sie den Bereich Für mich freigegeben > Von meiner Organisation auf und klicken Sie auf den freigegebenen Workflow-Agenten.
3. Klicken Sie im Workflow Builder-Canvas auf den Tab Ausführungen.
4. Klicken Sie auf eine bestimmte Ausführung, um die Ausführungsprotokolle und den schrittweisen Trace anzusehen.

Weitere Informationen finden Sie unter Workflow-Agent-Ausführungen.

Kopie eines freigegebenen Workflow-Agenten erstellen

Freigegebene Agenten sind für freigegebene Nutzer schreibgeschützt, mit Ausnahme ihrer Triggerkonfigurationen. Wenn Sie die Workflowschritte eines freigegebenen Agenten bearbeiten und anpassen möchten, können Sie eine Kopie in Ihrem eigenen Arbeitsbereich erstellen.

So erstellen Sie ein bearbeitbares Duplikat des freigegebenen Agenten:

App

1. Öffnen Sie Ihre Gemini Enterprise-Webanwendung in einem Browser.
2. Klicken Sie im Navigationsmenü der Webanwendung auf Agenten > Galerie.
3. Rufen Sie den Bereich Für mich freigegeben > Von meiner Organisation auf und klicken Sie auf den freigegebenen Workflow-Agenten, den Sie kopieren möchten.
4. Klicken Sie im Workflow Builder-Editor-Canvas auf den Agententitel und wählen Sie Kopie erstellen aus. Die Kopie wird der Liste Ihre Agenten hinzugefügt.

Abhängigkeiten freigegebener Agenten

Wenn Ihr Agent andere Agenten (Unteragenten) in seinen Workflowschritten importiert und referenziert, beachten Sie Folgendes:

• Zugriffsvoraussetzungen: Wenn Sie einen übergeordneten Agenten freigeben oder einen Agenten in Ihren Agenten importieren, müssen alle Nutzer in Ihrer Zugriffsliste auch Zugriff auf alle importierten Unteragenten haben.
• Ausführungsfehler: Wenn ein Nutzer einen Agenten ausführt, ohne Zugriff auf einen importierten Unteragenten zu haben, schlägt die Ausführung fehl und er wird aufgefordert, Zugriff vom Eigentümer anzufordern.

Hinweise

• Wenn der Agenteneigentümer eine neue Version aktiviert oder die Live-Version des Workflow-Agenten aktualisiert, führen alle freigegebenen Nutzer bei nachfolgenden Ausführungen automatisch die neue Live-Version aus.

• Wenn ein Agent deaktiviert oder gesperrt ist, wird das Workflow Builder-Canvas nicht gerendert und freigegebene Nutzer können den Agenten nicht ausführen. Sie können sich aber trotzdem ihre bisherigen Ausführungsverläufe und Sitzungsprotokolle in der Galerie Ausführungen ansehen. Wenn die Freigabe des Agenten aufgehoben, er deaktiviert oder gelöscht wird, verlieren freigegebene Nutzer den gesamten Zugriff, einschließlich auf ihre bisherigen Ausführungsverläufe und Sitzungsprotokolle.

• Für Aktionen, die externe Daten ändern, ist eine Human-in-the-Loop-Genehmigung (HITL) erforderlich, mit Ausnahme von E-Mails oder Kalenderterminen, die Sie an sich selbst senden.

Nächste Schritte

• Workflow-Agent erstellen .
• Workflow-Agent bearbeiten
• Workflow-Agent-Versionen verwalten .
• Ausführungen von Workflow-Agenten überwachen .