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

Nach der Einrichtung des OpenAPI Schema und Lambda-Funktion für Ihre Aktionsgruppe, Sie können die Aktionsgruppe erstellen. Wählen Sie die Registerkarte aus, die der Methode Ihrer Wahl entspricht, und folgen Sie den Schritten:

Anmerkung

Wenn Sie verwenden Anthropic Claude 3.5 Sonnet, stellen Sie sicher, dass Ihr Werkzeugname, der die Form haben soll, dem anthropischen Werkzeugnamenformat httpVerb__actionGroupName__apiName ^[a-zA-Z0-9_-]{1,64}$ entspricht. Ihr actionGroupName und apiName darf keine doppelten '__' Unterstriche enthalten.

Console

Wenn Sie einen Agenten erstellen, können Sie dem Arbeitsentwurf Aktionsgruppen hinzufügen.

Nachdem ein Agent erstellt wurde, können Sie ihm Aktionsgruppen hinzufügen, indem Sie die folgenden Schritte ausführen:

Um einem Agenten eine Aktionsgruppe hinzuzufügen

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/
Wählen Sie im linken Navigationsbereich Agenten aus. Wählen Sie dann im Abschnitt Agenten einen Agenten aus.
Wählen Sie „In Agent Builder bearbeiten“.
Wählen Sie im Abschnitt Aktionsgruppen die Option Hinzufügen aus.
(Optional) Ändern Sie im Abschnitt Aktionsgruppendetails den automatisch generierten Namen und geben Sie optional eine Beschreibung für Ihre Aktionsgruppe ein.
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
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 .

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:

Geben Sie einen Namen und eine optionale (aber empfohlene) Beschreibung ein.
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.

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.

Um einen weiteren Parameter hinzuzufügen, wählen Sie Parameter hinzufügen.
Um ein Feld in einem Parameter zu bearbeiten, wählen Sie das Feld aus und bearbeiten Sie es nach Bedarf.
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.

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.
Stellen Sie sicher, dass Sie sich darauf vorbereiten, die Änderungen, die Sie am Agenten vorgenommen haben, zu übernehmen, bevor Sie ihn testen.

API

Um eine Aktionsgruppe zu erstellen, senden Sie eine CreateAgentActionGroupAnfrage (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem Build-Time-Endpunkt für Agents for Amazon Bedrock. Sie müssen entweder ein Funktionsschema oder ein Open-Schema angeben. API

Siehe Codebeispiele

In der folgenden Liste werden die Felder in der Anfrage beschrieben:

Die folgenden Felder sind erforderlich:


Feld	Short description
agentId	Die ID des Agenten, zu dem die Aktionsgruppe gehört.
agentVersion	Die Version des Agenten, zu dem die Aktionsgruppe gehört.
actionGroupName	Der Name der Aktionsgruppe.

Um die Parameter für die Aktionsgruppe zu definieren, müssen Sie eines der folgenden Felder angeben (Sie können nicht beide angeben).


Feld	Short description
functionSchema	Definiert die Parameter für die Aktionsgruppe, die der Agent dem Benutzer entlockt. Weitere Informationen finden Sie unter Definieren Sie Funktionsdetails für die Aktionsgruppen Ihres Agenten in Amazon Bedrock.
apiSchema	Gibt das API Open-Schema an, das die Parameter für die Aktionsgruppe definiert, oder verweist auf ein S3-Objekt, das diese enthält. Weitere Informationen finden Sie unter Definieren OpenAPI Schemas für die Aktionsgruppen Ihres Agenten in Amazon Bedrock.

Im Folgenden wird das allgemeine Format von functionSchema und dargestelltapiSchema:

Jedes Element im functionSchema Array ist ein FunctionSchemaObjekt. Geben Sie für jede Funktion Folgendes an:
- Geben Sie ein name und optional an (aber empfohlen)description.
- Geben Sie optional requireConfirmation ein Feld anENABLED, um eine Bestätigung vom Benutzer anzufordern, bevor die Funktion aufgerufen wird. 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.
- Im parameters Objekt ist jeder Schlüssel ein Parametername, der Details zu diesem Parameter in einem ParameterDetailObjekt zugeordnet ist.
Das allgemeine Format von functionSchema lautet wie folgt:
```
"functionSchema": [
    {
        "name": "string",
        "description": "string",
        "requireConfirmation": ENABLED | DISABLED,
        "parameters": {
            "<string>": {
                "type": "string" | number | integer | boolean | array,
                "description": "string",
                "required": boolean
            },
            ... // up to 5 parameters
        }
    },
    ... // up to 11 functions
]
```
Das APISchemakann in einem der folgenden Formate vorliegen:
1. Für das folgende Format können Sie das JSON oder YAML -formatiert direkt einfügen OpenAPI Schema als Wert.
```
"apiSchema": {
    "payload": "string"
}
```
2. Geben Sie für das folgende Format den Amazon S3 S3-Bucket-Namen und den Objektschlüssel an, wobei OpenAPI Schema ist gespeichert.
```
"apiSchema": {
    "s3": {
        "s3BucketName": "string",
        "s3ObjectKey": "string"
    }
}
```

Um zu konfigurieren, wie die Aktionsgruppe den Aufruf der Aktionsgruppe behandelt, nachdem dem Benutzer Parameter abgefragt wurden, müssen Sie eines der folgenden Felder innerhalb des Felds angeben. actionGroupExecutor


Feld	Short description
Lambda	Um die Parameter an eine Lambda-Funktion zu senden, die die Ergebnisse des Aktionsgruppenaufrufs verarbeitet, geben Sie den Amazon-Ressourcennamen (ARN) des Lambdas an. Weitere Informationen finden Sie unter Lambda-Funktionen so konfigurieren, dass sie Informationen senden, die ein Amazon Bedrock-Agent dem Benutzer entlockt.
customControl	Um die Verwendung einer Lambda-Funktion zu überspringen und stattdessen die vorhergesagte Aktionsgruppe zusätzlich zu den dafür erforderlichen Parametern und Informationen in der `InvokeAgent` Antwort zurückzugeben, geben Sie Folgendes an`RETURN_CONTROL`. Weitere Informationen finden Sie unter Geben Sie die Kontrolle an den Agentenentwickler zurück, indem Sie die ermittelten Informationen in einer Antwort senden InvokeAgent .

Die folgenden Felder sind optional:


Feld	Short description
parentActionGroupSignatur	Geben Sie `AMAZON.UserInput` an, dass der Agent den Benutzer erneut zur Eingabe weiterer Informationen auffordern kann, wenn er nicht über genügend Informationen verfügt, um eine weitere Aktionsgruppe abzuschließen. Sie müssen die `actionGroupExecutor` Felder `descriptionapiSchema`, und leer lassen, wenn Sie dieses Feld angeben.
description	Eine Beschreibung der Aktionsgruppe.
actionGroupState	Ob der Agent die Aktionsgruppe aufrufen darf oder nicht.
clientToken	Eine Kennung, um zu verhindern, dass Anfragen dupliziert werden.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Holen Sie sich eine Benutzerbestätigung, bevor Sie die Aktion aufrufen

Informationen über eine Aktionsgruppe anzeigen