Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Devolución del control al desarrollador del agente al enviar la información obtenida en una respuesta de InvokeAgent
En lugar de enviar la información que el agente ha obtenido del usuario a una función de Lambda para su procesamiento, puede optar por devolver el control al desarrollador del agente mediante el envío de la información en la respuesta de InvokeAgent. Puede configurar la devolución del control al desarrollador del agente al crear o actualizar un grupo de acciones. A través de la API, especifica RETURN_CONTROL
como valor customControl
en el objeto actionGroupExecutor
de una solicitud CreateAgentActionGroup o UpdateAgentActionGroup. Para obtener más información, consulte Agregación de un grupo de acciones al agente en Amazon Bedrock.
Si configura la devolución del control para un grupo de acciones y el agente determina que debe llamar a una acción en ese grupo de acciones, los detalles de la API o de la función obtenidos del usuario se devolverán en el campo invocationInputs
de la respuesta de InvokeAgent, junto con un invocationId
único. A continuación puede hacer lo siguiente:
-
Configurar la aplicación para que invoque la API o la función que ha definido, siempre que la información se devuelva en las
invocationInputs
. -
Enviar los resultados de la invocación de la aplicación en otra solicitud InvokeAgent, en el campo
sessionState
, para proporcionar contexto al agente. Debe usar los mismosinvocationId
yactionGroup
devueltos en la respuesta de InvokeAgent. Esta información puede usarse como contexto para una mayor orquestación, enviarse al posprocesamiento para que el agente formatee una respuesta o usarse directamente en la respuesta del agente al usuario.nota
Si incluye
returnControlInvocationResults
en el camposessionState
, el campoinputText
se ignorará.
Para obtener más información sobre cómo configurar la devolución del control al desarrollador del agente al crear el grupo de acciones, consulte Agregación de un grupo de acciones al agente en Amazon Bedrock.
Ejemplo de devolución del control al desarrollador del agente
Por ejemplo, es posible que tenga los siguientes grupos de acciones:
-
Un grupo de acciones
PlanTrip
con una acciónsuggestActivities
que ayuda a los usuarios a encontrar actividades a realizar durante un viaje. Ladescription
de esta acción diceThis action suggests activities based on retrieved weather information
. -
Un grupo de acciones
WeatherAPIs
con una accióngetWeather
que ayuda al usuario a conocer la previsión meteorológica de una ubicación específica. Los parámetros obligatorios de la acción sonlocation
ydate
. El grupo de acciones está configurado para devolver el control al desarrollador del agente.
A continuación se muestra una secuencia hipotética que podría producirse:
-
El usuario hace la siguiente consulta a su agente:
What should I do today?
. Esta consulta se envía en el campoinputText
de una solicitud InvokeAgent. -
Su agente reconoce que la acción
suggestActivities
debe invocarse, pero según la descripción, predice que primero debe invocar la accióngetWeather
como contexto para ayudar a llevar a cabo la acciónsuggestActivities
. -
El agente sabe que la
date
actual es2024-09-15
, pero necesita lalocation
del usuario como parámetro obligatorio para obtener la previsión meteorológica. Así que le vuelve a preguntar al usuario dónde se encuentra. -
El usuario responde
Seattle
. -
El agente devuelve los parámetros de
getWeather
en la siguiente respuesta de InvokeAgent (seleccione una pestaña para ver ejemplos de un grupo de acciones definido con ese método): -
La aplicación está configurada para usar estos parámetros a fin de obtener la previsión meteorológica de
seattle
en la fecha2024-09-15
. El resultado de la previsión meteorológica es que será un día lluvioso. -
Los resultados se envían en el campo
sessionState
de otra solicitud InvokeAgent con los mismosinvocationId
,actionGroup
yfunction
de la respuesta anterior. Seleccione una pestaña para ver ejemplos de un grupo de acciones definido con este método: -
El agente predice que debe llamar a la acción
suggestActivities
. Como respuesta, utiliza el contexto de que es un día lluvioso y le sugiere al usuario actividades de interior, en lugar de exterior.