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.
En lugar de enviar la información que su agente ha obtenido del usuario a una función de Lambda para su procesamiento, puede optar por devolver el control al desarrollador del agente enviando la información en el InvokeAgentrespuesta. 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, RETURN_CONTROL se especifica como customControl valor del actionGroupExecutor objeto en un CreateAgentActionGroup o UpdateAgentActionGroup request. Para obtener más información, consulte Agregación de un grupo de acciones al agente en Amazon Bedrock.
Si configuras la devolución del control para un grupo de acciones y si el agente determina que debe realizar una acción en ese grupo de acciones, los detalles de la API o de la función obtenidos por el usuario se devolverán en el invocationInputs campo de InvokeAgentrespuesta, junto con una únicainvocationId. 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. -
Envía los resultados de la invocación de tu aplicación en otra InvokeAgentsolicite, en el
sessionStatecampo, proporcionar contexto al agente. Debe utilizar los mismosinvocationIdyactionGroupque se devolvieron en el InvokeAgentrespuesta. 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
returnControlInvocationResultsen el camposessionState, el campoinputTextse 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
PlanTripcon una acciónsuggestActivitiesque ayuda a los usuarios a encontrar actividades a realizar durante un viaje. Ladescriptionde esta acción diceThis action suggests activities based on retrieved weather information. -
Un grupo de acciones
WeatherAPIscon una accióngetWeatherque ayuda al usuario a conocer la previsión meteorológica de una ubicación específica. Los parámetros obligatorios de la acción sonlocationydate. 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 solicita a su agente la siguiente consulta:
What should I do today?Esta consulta se envía en elinputTextcampo de un InvokeAgent request. -
Su agente reconoce que la acción
suggestActivitiesdebe invocarse, pero según la descripción, predice que primero debe invocar la accióngetWeathercomo contexto para ayudar a llevar a cabo la acciónsuggestActivities. -
El agente sabe que la
dateactual es2024-09-15, pero necesita lalocationdel 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 la
getWeathersiguiente manera InvokeAgentrespuesta (seleccione una pestaña para ver ejemplos de un grupo de acciones definido con ese método):HTTP/1.1 200 x-amzn-bedrock-agent-content-type: application/json x-amz-bedrock-agent-session-id: session0 Content-type: application/json { "returnControl": { "invocationInputs": [{ "functionInvocationInput": { "actionGroup": "WeatherAPIs", "function": "getWeather", "parameters": [ { "name": "location", "type": "string", "value": "seattle" }, { "name": "date", "type": "string", "value": "2024-09-15" } ] } }], "invocationId": "79e0feaa-c6f7-49bf-814d-b7c498505172" } } -
La aplicación está configurada para usar estos parámetros a fin de obtener la previsión meteorológica de
seattleen la fecha2024-09-15. El resultado de la previsión meteorológica es que será un día lluvioso. -
Envía estos resultados en el
sessionStatecampo de otro InvokeAgentsolicitud, utilizando la mismainvocationIdactionGroup, yfunctioncomo la respuesta anterior. Seleccione una pestaña para ver ejemplos de un grupo de acciones definido con este método:POST https://bedrock-agent-runtime.us-east-1.amazonaws.com/agents/AGENT12345/agentAliases/TSTALIASID/sessions/abb/text { "enableTrace": true, "sessionState": { "invocationId": "79e0feaa-c6f7-49bf-814d-b7c498505172", "returnControlInvocationResults": [{ "functionResult": { "actionGroup": "WeatherAPIs", "function": "getWeather", "responseBody": { "TEXT": { "body": "It's rainy in Seattle today." } } } }] } } -
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.
