Fügen Sie Ihrem Agenten in Amazon Bedrock eine Aktionsgruppe hinzu

Um einem Agenten eine Aktionsgruppe hinzuzufügen

1. Melden Sie sich als Benutzer mit IAM Amazon Bedrock-Berechtigungen an und öffnen Sie die Amazon Bedrock-Konsole AWS Management Console unter. https://console.aws.amazon.com/bedrock/

2. Wählen Sie im linken Navigationsbereich Agenten aus. Wählen Sie dann im Abschnitt Agenten einen Agenten aus.

3. Wählen Sie „In Agent Builder bearbeiten“.

4. Wählen Sie im Abschnitt Aktionsgruppen die Option Hinzufügen aus.

5. (Optional) Ändern Sie im Abschnitt Aktionsgruppendetails den automatisch generierten Namen und geben Sie optional eine Beschreibung für Ihre Aktionsgruppe ein.

6. Wählen Sie im Abschnitt Aktionsgruppentyp eine der folgenden Methoden zur Definition der Parameter aus, die der Agent Benutzern zur Unterstützung der Ausführung von Aktionen entnehmen kann:

   1. Mit Funktionsdetails definieren — Definieren Sie Parameter, die Ihr Agent dem Benutzer zur Ausführung der Aktionen entnehmen soll. Weitere Informationen zum Hinzufügen von Funktionen finden Sie unter. Definieren Sie Funktionsdetails für die Aktionsgruppen Ihres Agenten in Amazon Bedrock

   2. Mit API Schemas definieren — Definieren Sie die API Operationen, die der Agent aufrufen kann, und die Parameter. Verwenden Sie ein von Ihnen erstelltes API Open-Schema oder verwenden Sie den Texteditor der Konsole, um das Schema zu erstellen. Weitere Informationen zum Einrichten eines API Open-Schemas finden Sie unter Definieren OpenAPI Schemas für die Aktionsgruppen Ihres Agenten in Amazon Bedrock

7. Im Abschnitt Aktionsgruppenaufruf legen Sie fest, was der Agent tun soll, nachdem er die Funktion API oder vorhergesagt hat, die er aufrufen soll, und die benötigten Parameter empfangen hat. Wählen Sie eine der folgenden Optionen:

   • Schnelles Erstellen einer neuen Lambda-Funktion — empfohlen — Lassen Sie Amazon Bedrock eine grundlegende Lambda-Funktion für Ihren Agenten erstellen, die Sie später AWS Lambda für Ihren Anwendungsfall ändern können. Der Agent übergibt die von ihm vorhergesagte API OR-Funktion und die auf der Sitzung basierenden Parameter an die Lambda-Funktion.

   • Wählen Sie eine vorhandene Lambda-Funktion aus — Wählen Sie eine Lambda-Funktion aus, die Sie zuvor in erstellt haben, AWS Lambda und die Version der Funktion, die Sie verwenden möchten. Der Agent übergibt die von ihm vorhergesagte API OR-Funktion und die auf der Sitzung basierenden Parameter an die Lambda-Funktion.

     Anmerkung

     Damit der Amazon Bedrock Service Principal auf die Lambda-Funktion zugreifen kann, fügen Sie der Lambda-Funktion eine ressourcenbasierte Richtlinie hinzu, damit der Amazon Bedrock Service Principal auf die Lambda-Funktion zugreifen kann.

   • Steuerung zurückgeben — Anstatt die Parameter für die Funktion API oder, die er vorhersagt, an die Lambda-Funktion zu übergeben, gibt der Agent die Kontrolle an Ihre Anwendung zurück, indem er die Aktion übergibt, von der er prognostiziert, dass sie aufgerufen werden sollte, zusätzlich zu den Parametern und Informationen für die Aktion, die er in der Sitzung ermittelt hat, in der InvokeAgentAntwort. Weitere Informationen finden Sie unter Geben Sie die Kontrolle an den Agentenentwickler zurück, indem Sie die ermittelten Informationen in einer Antwort senden InvokeAgent .

8. Abhängig von Ihrer Wahl für den Gruppentyp Aktion wird einer der folgenden Abschnitte angezeigt:

   • Wenn Sie Mit Funktionsdetails definieren ausgewählt haben, steht Ihnen ein Funktionsbereich Aktionsgruppe zur Verfügung. Gehen Sie wie folgt vor, um die Funktion zu definieren:

     1. Geben Sie einen Namen und eine optionale (aber empfohlene) Beschreibung ein.

     2. Um vor dem Aufruf der Funktion eine Bestätigung vom Benutzer anzufordern, wählen Sie Aktiviert aus. Wenn Sie vor dem Aufrufen der Funktion eine Bestätigung anfordern, kann Ihre Anwendung möglicherweise davor schützen, aufgrund böswilliger Eingabeaufforderungen Maßnahmen zu ergreifen.

     3. Wählen Sie im Unterabschnitt Parameter die Option Parameter hinzufügen aus. Definieren Sie die folgenden Felder:

        Feld	Beschreibung
        Name	Geben Sie dem Parameter einen Namen.
        Description (optional)	Beschreiben Sie den Parameter.
        Typ	Geben Sie den Datentyp des Parameters an.
        Erforderlich	Geben Sie an, ob der Agent den Parameter vom Benutzer benötigt.

     4. Um einen weiteren Parameter hinzuzufügen, wählen Sie Parameter hinzufügen.

     5. Um ein Feld in einem Parameter zu bearbeiten, wählen Sie das Feld aus und bearbeiten Sie es nach Bedarf.

     6. Um einen Parameter zu löschen, wählen Sie das Löschsymbol ( ) in der Zeile, die den Parameter enthält.

     Wenn Sie die Funktion lieber mithilfe eines JSON Objekts definieren möchten, wählen Sie JSONEditor statt Tabelle. Das JSON Objektformat lautet wie folgt (jeder Schlüssel im parameters Objekt ist ein Parametername, den Sie angeben):

     {
         "name": "string",
         "description": "string",
         "parameters": [
             {
                 "name": "string",
                 "description": "string",
                 "required": "True" | "False",
                 "type": "string" | "number" | "integer" | "boolean" | "array"
             }
         ]
     }

     Um Ihrer Aktionsgruppe eine weitere Funktion hinzuzufügen, indem Sie einen anderen Satz von Parametern definieren, wählen Sie Aktionsgruppenfunktion hinzufügen.

   • Wenn Sie Mit API Schemas definieren ausgewählt haben, steht Ihnen ein Abschnitt Aktionsgruppen-Schema mit den folgenden Optionen zur Verfügung:

     • Um ein API Open-Schema zu verwenden, das Sie zuvor mit API Beschreibungen, Strukturen und Parametern für die Aktionsgruppe vorbereitet haben, wählen Sie API Schema auswählen und geben Sie einen Link zu Amazon S3 URI des Schemas an.

     • Um das API Open-Schema mit dem Inline-Schema-Editor zu definieren, wählen Sie Per Inline-Schema-Editor definieren aus. Es wird ein Beispielschema angezeigt, das Sie bearbeiten können.

       1. Wählen Sie das Format für das Schema aus, indem Sie das Dropdownmenü neben Format verwenden.

       2. Um ein vorhandenes Schema zur Bearbeitung aus S3 zu importieren, wählen Sie Schema importieren aus, geben Sie das S3 URI an und wählen Sie Importieren aus.

       3. Wählen Sie Zurücksetzen und bestätigen Sie dann die angezeigte Meldung, indem Sie erneut auf Zurücksetzen klicken, um das Schema auf das ursprüngliche Beispielschema zurückzusetzen.

9. Wenn Sie mit der Erstellung der Aktionsgruppe fertig sind, wählen Sie Hinzufügen. Wenn Sie ein API Schema definiert haben, wird ein grünes Erfolgsbanner angezeigt, sofern keine Probleme vorliegen. Wenn bei der Überprüfung des Schemas Probleme auftreten, wird ein rotes Banner angezeigt. Ihnen stehen folgende Optionen zur Verfügung:

   • Scrollen Sie durch das Schema, um die Zeilen zu sehen, in denen ein Fehler oder eine Warnung zur Formatierung vorliegt. Ein X weist auf einen Formatierungsfehler hin, während ein Ausrufezeichen auf eine Warnung zur Formatierung hinweist.

   • Wählen Sie im roten Banner die Option Details anzeigen aus, um eine Liste mit Fehlern im Zusammenhang mit dem Inhalt des API Schemas anzuzeigen.

10. Stellen Sie sicher, dass Sie sich darauf vorbereiten, die Änderungen, die Sie am Agenten vorgenommen haben, zu übernehmen, bevor Sie ihn testen.