Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Restituzione del controllo allo sviluppatore dell’agente inviando le informazioni richieste in una risposta InvokeAgent
Anziché inviare le informazioni che l’agente ha ottenuto dall’utente a una funzione Lambda per l’adempimento, puoi scegliere di restituire il controllo allo sviluppatore dell’agente inviando le informazioni nella risposta InvokeAgent. È possibile configurare la restituzione del controllo allo sviluppatore dell’agente durante la creazione o l’aggiornamento di un gruppo di operazioni. Tramite l’API, puoi specificare RETURN_CONTROL come valore customControl nell’oggetto actionGroupExecutor in una richiesta UpdateAgentActionGroup o CreateAgentActionGroup. Per ulteriori informazioni, consulta Aggiunta di un gruppo di operazioni all’agente in Amazon Bedrock.
Se configuri la restituzione del controllo per un gruppo di operazioni e se l’agente stabilisce che deve chiamare un’azione in tale gruppo, i dettagli dell’API o della funzione richiesti all’utente verranno restituiti nel campo invocationInputs della risposta InvokeAgent, insieme a un valore invocationId univoco. A questo punto puoi effettuare le seguenti operazioni:
-
Configurare l’applicazione per invocare l’API o la funzione che hai definito, a condizione di fornire le informazioni restituite in
invocationInputs. -
Inviare i risultati dell’invocazione dell’applicazione in un’altra richiesta InvokeAgent, nel campo
sessionState, per fornire un contesto all’agente. È necessario utilizzare gli stessiinvocationIdeactionGrouprestituiti nella risposta InvokeAgent. Queste informazioni possono essere utilizzate come contesto per un’ulteriore orchestrazione, inviate in post-elaborazione affinché l’agente formatti una risposta o utilizzate direttamente nella risposta dell’agente all’utente.Nota
Se includi
returnControlInvocationResultsnel camposessionState, il campoinputTextverrà ignorato.
Per informazioni su come configurare la restituzione del controllo allo sviluppatore dell’agente durante la creazione del gruppo di operazioni, consulta Aggiunta di un gruppo di operazioni all’agente in Amazon Bedrock.
Esempio di restituzione del controllo allo sviluppatore dell’agente
Ad esempio potrebbero essere presenti i seguenti gruppi di operazioni:
-
Un gruppo di operazioni
PlanTripcon un’azionesuggestActivitiesche aiuta gli utenti a trovare le attività da svolgere durante un viaggio. Ladescriptiondi questa azione riportaThis action suggests activities based on retrieved weather information. -
Un gruppo di operazioni
WeatherAPIscon un’azionegetWeatherche aiuta l’utente a consultare le condizioni meteorologiche di una località specifica. I parametri dell’azione richiesti sonolocationedate. Il gruppo di operazioni è configurato in modo da restituire il controllo allo sviluppatore dell’agente.
Di seguito è riportata una sequenza ipotetica che potrebbe verificarsi:
-
L’utente pone all’agente la seguente domanda:
What should I do today?Questa query viene inviata nel campoinputTextdi una richiesta InvokeAgent. -
L’agente riconosce che l’azione
suggestActivitiesdeve essere invocata ma, data la descrizione, prevede di dover prima invocare l’azionegetWeathercome contesto per contribuire all’adempimento dell’azionesuggestActivities. -
L’agente sa che la
datecorrente è2024-09-15, ma per scoprire le condizioni meteorologiche ha bisogno dellalocationdell’utente come parametro obbligatorio. Quindi, si rivolge nuovamente all’utente ponendo la domanda “Dove ti trovi?” -
L’utente risponde
Seattle. -
L’agente restituisce i parametri per
getWeathernella seguente risposta InvokeAgent (seleziona una scheda per consultare gli esempi di un gruppo di operazioni definito con quel metodo): -
L’applicazione è configurata per utilizzare questi parametri allo scopo di ottenere le condizioni meteorologiche di
seattlein data2024-09-15. Viene determinato che il tempo è piovoso. -
Questi risultati vengono inviati nel campo
sessionStatedi un’altra richiesta InvokeAgent, utilizzando gli stessiinvocationId,actionGroupefunctiondella risposta precedente. Seleziona una scheda per consultare esempi di un gruppo di operazioni definito con tale metodo: -
L’agente prevede di dover chiamare l’azione
suggestActivities. Basandosi sul contesto secondo cui quel giorno pioverà, nella risposta suggerisce all’utente attività al chiuso anziché all’aperto.
Esempio di restituzione del controllo all’agente collaboratore
Se utilizzi la collaborazione multiagente e un agente collaboratore sceglie di restituire il controllo inviando le informazioni nella risposta InvokeAgent, le informazioni vengono restituite nella risposta dell’agente supervisore con gli identificatori aggiuntivi agentId e collaboratorName. Seleziona una scheda per consultare esempi di un gruppo di operazioni definito con tale metodo:
L’invoker dell’agente supervisore invia i risultati del campo sessionState all’agente supervisore con i risultati agentId corrispondenti, affinché vengano propagati all’agente collaboratore giusto.
