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à.
Restituisci il controllo allo sviluppatore dell'agente inviando le informazioni richieste in una InvokeAgent risposta
Invece di inviare le informazioni che il tuo 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 il ritorno del controllo allo sviluppatore dell'agente durante la creazione o l'aggiornamento di un gruppo di azioni. Tramite l'API, si specifica RETURN_CONTROL come customControl valore nell'actionGroupExecutoroggetto in una UpdateAgentActionGrouprichiesta CreateAgentActionGroupor. Per ulteriori informazioni, consulta Aggiungi un gruppo d'azione al tuo agente in Amazon Bedrock.
Se configurate il ritorno al controllo per un gruppo di azioni e se l'agente stabilisce che deve richiamare un'azione in questo gruppo di azioni, i dettagli dell'API o della funzione rilevati dall'utente verranno restituiti nel invocationInputs campo della InvokeAgentrisposta, insieme a un valore univocoinvocationId. A questo punto puoi effettuare le seguenti operazioni:
-
Configura l'applicazione per richiamare l'API o la funzione che hai definito, a condizione che vengano restituite le informazioni restituite in.
invocationInputs -
Invia i risultati della chiamata dell'applicazione in un'altra InvokeAgentrichiesta, sul
sessionStatecampo, per fornire un contesto all'agente. È necessario utilizzare lo stessoinvocationIdvaloreactionGrouprestituito nella InvokeAgentrisposta. Queste informazioni possono essere utilizzate come contesto per un'ulteriore orchestrazione, inviate alla fase di post-elaborazione per consentire all'agente di formattare una risposta o utilizzate direttamente nella risposta dell'agente all'utente.Nota
Se lo includi
returnControlInvocationResultsnelsessionStatecampo, ilinputTextcampo verrà ignorato.
Per informazioni su come configurare il ritorno del controllo allo sviluppatore dell'agente durante la creazione del gruppo di azioni, consultaAggiungi un gruppo d'azione al tuo agente in Amazon Bedrock.
Esempio di restituzione del controllo allo sviluppatore dell'agente
Ad esempio, potresti avere i seguenti gruppi di azione:
-
Un gruppo di
PlanTripazioni con un'suggestActivitiesazione che aiuta gli utenti a trovare le attività da svolgere durante un viaggio. Ildescriptionmotivo per questa azione diceThis action suggests activities based on retrieved weather information. -
Un gruppo di
WeatherAPIsazione con un'getWeatherazione che aiuta l'utente a conoscere le condizioni meteorologiche per una località specifica. I parametri richiesti per l'azione sonolocationedate. Il gruppo di azioni è configurato per restituire il controllo allo sviluppatore dell'agente.
Di seguito è riportata una sequenza ipotetica che potrebbe verificarsi:
-
L'utente richiede all'agente la seguente domanda:
What should I do today?Questa richiesta viene inviata nelinputTextcampo di una richiesta. InvokeAgent -
L'agente riconosce che l'
suggestActivitiesazione deve essere invocata, ma, data la descrizione, prevede che debba prima richiamare l'getWeatherazione come contesto per contribuire alla realizzazione dell'azione.suggestActivities -
L'agente sa che la corrente
dateesiste2024-09-15, ma ha bisognolocationdell'utente come parametro obbligatorio per conoscere le condizioni meteorologiche. Richiede all'utente la domanda «Dove ti trovi?» -
L'utente risponde.
Seattle -
L'agente restituisce i parametri per
getWeatherla seguente InvokeAgentrisposta (seleziona una scheda per vedere esempi di un gruppo di azioni definito con quel metodo): -
L'applicazione è configurata per utilizzare questi parametri per ottenere le condizioni meteorologiche
seattlerelative alla data2024-09-15. Il tempo è determinato a essere piovoso. -
Questi risultati vengono inviati nel
sessionStatecampo di un'altra InvokeAgentrichiesta, utilizzando la stessainvocationIdefunctioncome risposta precedente.actionGroupSeleziona una scheda per vedere esempi di un gruppo di azioni definito con quel metodo: -
L'agente prevede che debba avviare l'
suggestActivitiesazione. Utilizza il contesto in cui quel giorno piove e nella risposta suggerisce all'utente attività al chiuso anziché all'aperto.
Esempio di restituzione del controllo all'agente collaboratore
Se si utilizza la collaborazione tra più agenti e se un collaboratore agente sceglie di riprendere il controllo inviando le informazioni contenute nella InvokeAgentrisposta, le informazioni vengono restituite nella risposta dell'agente supervisore con identificatori aggiuntivi e. agentId collaboratorName Seleziona una scheda per vedere esempi di un gruppo di azioni definito con quel metodo:
L'invocatore dell'agente supervisore invia i risultati del sessionState campo all'agente supervisore con i corrispondenti risultati agentId affinché vengano propagati all'agente collaboratore giusto.
