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
sessionState
Feld, um dem Agenten einen Kontext bereitzustellen. Sie müssen dieselbeninvocationId
Daten 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
returnControlInvocationResults
in dassessionState
Feld aufnehmen, wird dasinputText
Feld 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
PlanTrip
Aktionsgruppe mit einersuggestActivities
Aktion, die Ihren Benutzern hilft, Aktivitäten zu finden, die sie während einer Reise unternehmen können. Dasdescription
für diese Aktion lautetThis action suggests activities based on retrieved weather information
. -
Eine
WeatherAPIs
Aktionsgruppe mit einergetWeather
Aktion, die Ihrem Benutzer hilft, das Wetter für einen bestimmten Ort zu ermitteln. Die erforderlichen Parameter der Aktion sindlocation
unddate
. 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 iminputText
Feld einer Anfrage gesendet. InvokeAgent -
Ihr Agent erkennt, dass die
suggestActivities
Aktion aufgerufen werden sollte, sagt aber anhand der Beschreibung voraus, dass er die Aktion zuerst aufrufen sollte, um diegetWeather
Aktion als Kontext für die Ausführung der Aktion zu unterstützen.suggestActivities
-
Der Agent weiß, dass der Strom gerade
date
ist2024-09-15
, benötigt aber den Wertlocation
des 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
getWeather
in 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
seattle
für das Datum abzurufen2024-09-15
. Das Wetter wird voraussichtlich regnerisch sein. -
Sie senden diese Ergebnisse im
sessionState
Feld einer anderen InvokeAgentAnfrage und verwenden dabei dieselbe AntwortinvocationId
,actionGroup
, undfunction
wie 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
suggestActivities
Aktion 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.