Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Geben Sie die Kontrolle an den Agentenentwickler zurück, indem Sie die ermittelten Informationen in einer Antwort senden InvokeAgent
Anstatt die Informationen, die Ihr Agent vom Benutzer erhalten hat, zur Erfüllung an eine Lambda-Funktion zu senden, können Sie sich stattdessen dafür entscheiden, die Kontrolle an den Agentenentwickler zurückzugeben, indem Sie die Informationen in der Antwort senden. InvokeAgent Sie können die Rückgabe der Kontrolle an den Agent-Entwickler konfigurieren, wenn Sie eine Aktionsgruppe erstellen oder aktualisieren. Über die API geben Sie RETURN_CONTROL als customControl Wert im actionGroupExecutor Objekt in einer CreateAgentActionGroupUpdateAgentActionGroupOder-Anfrage an. Weitere Informationen finden Sie unter Fügen Sie Ihrem Agenten in Amazon Bedrock eine Aktionsgruppe hinzu.
Wenn Sie Return of Control für eine Aktionsgruppe konfigurieren und der Agent entscheidet, dass er eine Aktion in dieser Aktionsgruppe aufrufen soll, werden die vom Benutzer abgerufenen API- oder Funktionsdetails zusammen mit einem eindeutigen Wert in dem invocationInputs Feld in der InvokeAgentAntwort zurückgegeben. invocationId Sie können dann Folgendes durchführen:
-
Richten Sie Ihre Anwendung so ein, dass sie die von Ihnen definierte API oder Funktion aufruft, vorausgesetzt, die in der zurückgegebenen Informationen.
invocationInputs -
Senden Sie die Ergebnisse des Aufrufs Ihrer Anwendung in einer anderen InvokeAgentAnfrage in das
sessionStateFeld, um dem Agenten einen Kontext bereitzustellen. Sie müssen dieselbeninvocationIdDaten verwendenactionGroup, die in der InvokeAgentAntwort zurückgegeben wurden. Diese Informationen können als Kontext für die weitere Orchestrierung verwendet, zur Nachbearbeitung gesendet werden, damit der Agent eine Antwort formatieren kann, oder sie können direkt in der Antwort des Agenten an den Benutzer verwendet werden.Anmerkung
Wenn Sie Daten
returnControlInvocationResultsin dassessionStateFeld aufnehmen, wird dasinputTextFeld ignoriert.
Informationen zur Konfiguration der Rückgabe der Kontrolle an den Agent-Entwickler bei der Erstellung der Aktionsgruppe finden Sie unterFügen Sie Ihrem Agenten in Amazon Bedrock eine Aktionsgruppe hinzu.
Beispiel für die Rückgabe der Kontrolle an den Agent-Entwickler
Beispielsweise könnten Sie die folgenden Aktionsgruppen haben:
-
Eine
PlanTripAktionsgruppe mit einersuggestActivitiesAktion, die Ihren Benutzern hilft, Aktivitäten zu finden, die sie während einer Reise unternehmen können. Dasdescriptionfür diese Aktion lautetThis action suggests activities based on retrieved weather information. -
Eine
WeatherAPIsAktionsgruppe mit einergetWeatherAktion, die Ihrem Benutzer hilft, das Wetter für einen bestimmten Ort zu ermitteln. Die erforderlichen Parameter der Aktion sindlocationunddate. Die Aktionsgruppe ist so konfiguriert, dass sie die Steuerung an den Agent-Entwickler zurückgibt.
Es folgt eine hypothetische Sequenz, die auftreten könnte:
-
Der Benutzer fordert Ihren Agenten mit der folgenden Abfrage auf:
What should I do today?Diese Abfrage wird iminputTextFeld einer Anfrage gesendet. InvokeAgent -
Ihr Agent erkennt, dass die
suggestActivitiesAktion aufgerufen werden sollte, sagt aber anhand der Beschreibung voraus, dass er die Aktion zuerst aufrufen sollte, um diegetWeatherAktion als Kontext für die Ausführung der Aktion zu unterstützen.suggestActivities -
Der Agent weiß, dass der Strom gerade
dateist2024-09-15, benötigt aber den Wertlocationdes Benutzers als erforderlichen Parameter, um das Wetter zu ermitteln. Der Benutzer erhält erneut die Frage „Wo befinden Sie sich?“ -
Der Benutzer antwortet.
Seattle -
Der Agent gibt die Parameter für
getWeatherin der folgenden InvokeAgentAntwort zurück (wählen Sie eine Registerkarte aus, um Beispiele für eine mit dieser Methode definierte Aktionsgruppe zu sehen): -
Ihre Anwendung ist so konfiguriert, dass sie diese Parameter verwendet, um das Wetter
seattlefür das Datum abzurufen2024-09-15. Das Wetter wird voraussichtlich regnerisch sein. -
Sie senden diese Ergebnisse im
sessionStateFeld einer anderen InvokeAgentAnfrage und verwenden dabei dieselbe AntwortinvocationId,actionGroup, undfunctionwie die vorherige Antwort. Wählen Sie eine Registerkarte aus, um Beispiele für eine Aktionsgruppe zu sehen, die mit dieser Methode definiert wurde: -
Der Agent sagt voraus, dass er die
suggestActivitiesAktion aufrufen soll. Es verwendet den Kontext, dass es an diesem Tag regnet, und schlägt dem Benutzer in der Antwort eher Aktivitäten im Innenbereich als im Freien vor.
Beispiel für die Rückgabe der Kontrolle an den Collaborator-Agenten
Wenn Sie die Zusammenarbeit mit mehreren Agenten verwenden und ein Mitarbeiter mit Agenten die Kontrolle zurückgibt, indem er die in der Antwort enthaltenen Informationen sendet, werden die Informationen in der InvokeAgentAntwort des Supervisor-Agenten mit zusätzlichen Kennungen und zurückgegeben. agentId collaboratorName Wählen Sie eine Registerkarte aus, um Beispiele für eine Aktionsgruppe anzuzeigen, die mit dieser Methode definiert wurde:
Der Aufrufer des Supervisor-Agenten sendet die Ergebnisse im sessionState Feld zurück an den Supervisor-Agenten mit den entsprechenden agentId Informationen, damit sie an den richtigen Agent-Mitarbeiter weitergegeben werden können.
