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. # Intenciones integradas Para las acciones comunes, puede utilizar la biblioteca de intenciones integrada estándar. Para crear una intención a partir de una intención integrada, elíjala en la consola y asígnele otro nombre. La nueva intención tiene la misma configuración que la intención base, como los enunciados de ejemplo. En la implementación actual, no puede hacer lo siguiente: + Añadir ni eliminar enunciados de ejemplo de la intención base + Configurar slots para intenciones integradas **Añadir una intención integrada a un bot** 1. Inicie sesión en la consola de administración de AWS y abra la consola de Amazon Lex en [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/). 1. Seleccione el bot al cual se debe agregar la intención integrada. 1. En el menú de la izquierda, seleccione el idioma y, a continuación, seleccione **Intenciones**. 1. Seleccione **Añadir intención** y, a continuación, seleccione **Usar intención integrada**. 1. En **Intención integrada**, seleccione la intención que quiere usar. 1. Asigne un nombre a la intención y, a continuación, seleccione **Añadir**. 1. Use el editor de intenciones para configurar la intención según sea necesario para su bot. **Topics** + [AMAZON.BedrockAgentIntent](built-in-intent-bedrockagent.md) + [AMAZON.CancelIntent](built-in-intent-cancel.md) + [AMAZON.FallbackIntent](built-in-intent-fallback.md) + [AMAZON.HelpIntent](built-in-intent-help.md) + [AMAZON.KendraSearchIntent](built-in-intent-kendra-search.md) + [AMAZON.PauseIntent](built-in-intent-pause.md) + [AMAZON.QnAIntent](built-in-intent-qna.md) + [AMAZON.QnAIntent (multiple use support)](built-in-intent-qna-multi.md) + [AMAZON.QinConnectIntent](built-in-intent-qinconnect.md) + [AMAZON.RepeatIntent](built-in-intent-repeat.md) + [AMAZON.ResumeIntent](built-in-intent-resume.md) + [AMAZON.StartOverIntent](built-in-intent-start-over.md) + [AMAZON.StopIntent](built-in-intent-stop.md) # AMAZON.BedrockAgentIntent **nota** Para aprovechar las características de la IA generativa debe cumplir los siguientes requisitos previos Para obtener información sobre el precio de uso de Amazon Bedrock, consulte [Precios de Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/). Active las capacidades de IA generativa para la configuración regional de su bot. Para ello, siga los pasos que se indican en [Optimización de la creación y el rendimiento de bots Lex V2 con IA generativa](generative-features.md). Activa los agentes de Amazon Bedrock que se definen con la intención de responder a las solicitudes de los clientes y activa los flujos de trabajo agénticos para realizar la tarea definida. Esta característica está disponible en todas las configuraciones regionales compatibles con Amazon Lex V2 y en todas las regiones comerciales en las que estén presentes Amazon Lex V2 y agentes de Amazon Bedrock. Si esta intención prevalece`FallbackIntent`, la intención se activa cuando un enunciado no está clasificado en ninguna de las demás intenciones presentes en el bot; de lo contrario, solo se activa cuando un enunciado se clasifica en esta intención. Es importante tener en cuenta que esta intención no se activará en el caso de expresiones omitidas cuando se obtenga un valor de espacio. Cuando su bot de Amazon Lex V2 la reconozca, la `AMAZON.BedrockAgentIntent` activa el `BedrockAgent` o la `BedrockKnowledgeBase` definidos para responder al cliente. Si utiliza agentes para Amazon Bedrock, la conversación permanece en la `BedrockAgentIntent` y las solicitudes de los usuarios se transmiten a los agentes hasta que el agente para Amazon Bedrock determine que la conversación haya `FINISH`. Solo entonces, Amazon Lex V2 asumirá el control de la conversación y seguirá los siguientes pasos definidos en la `AMAZON.BedrockAgentIntent`. Responde a las preguntas de los clientes usando los agentes y bases de conocimiento de Amazon Bedrock para responder a las preguntas de los clientes y proporcionar respuestas detalladas. **aviso** No puedes usar expresiones sin muestras, `AMAZON.BedrockAgentIntent` `AMAZON.QnAIntent` sin expresiones de muestra y `AMAZON.KendraSearchIntent` en la misma configuración regional del bot. Si selecciona esta intención, configure los siguientes campos y, a continuación, seleccione Agregar para agregar la intención. + ID del agente de Amazon Bedrock: es el identificador del agente de Amazon Bedrock. Elija el agente de Bedrock que desea usar. + ID del alias del agente de Amazon Bedrock: es el identificador del alias del agente de Amazon Bedrock. **importante** Al crear el agente de Amazon Bedrock para usarlo con Amazon Lex V2, compruebe que la **Entrada del usuario** en **Configuración adicional** sea `ENABLED`. Esta configuración es fundamental para que los agentes puedan hacer preguntas aclaratorias o de seguimiento, y permite a Amazon Lex V2 delegar en los agentes la tarea correspondiente. (Opcional) También puedes añadir un BedrockAgentIntent con estas opciones: + Modelo Amazon Bedrock: elija el modelo de proveedor y base que se utilizará para este propósito. Actualmente, se admiten algunos modelos Anthropic Claude. + Base de conocimiento de Amazon Bedrock: si elige esta opción, especifique el ID de la base de conocimiento de Amazon Bedrock. Puede buscar el ID en la página de detalles de la base de conocimiento de Amazon Bedrock en la consola o enviando una solicitud `GetKnowledgeBase`. Las respuestas del se BedrockAgentIntent almacenarán en los atributos de sesión y solicitud, tal y como se muestra a continuación: + `x-amz-lex:bedrock-agent-search-response`: respuesta del agente de Amazon Bedrock a la pregunta o al enunciado. + `x-amz-lex:bedrock-knowledge-base-search-response-source`: señala al documento o la lista de documentos utilizados para generar la respuesta si se utiliza la configuración de la base de conocimiento de Amazon Bedrock. + `x-amz-lex:bedrock-agent-action-group-invocation-input`: objeto que contiene los valores de entrada recopilados por el grupo de acciones de los agentes. Para obtener más información sobre los grupos de acción de los agentes, consulte ActionGroupInvocationInput. + `x-amz-lex:bedrock-agent-knowledge-base-lookup-input`: objeto que contiene los detalles relacionados con la búsqueda en la base de conocimiento de Amazon Bedrock. + `x-amz-lex:bedrock-agent-agent-collaborator-details`: objeto que contiene detalles de las entradas y salidas de los subagentes que se han invocado como parte de las invocaciones de colaboración entre múltiples agentes. Para obtener más información, consulte [Uso BedrockAgentIntent de un agente Bedrock en Amazon Lex](https://docs.aws.amazon.com/lexv2/latest/dg/bedrock-agent-intent.html). # AMAZON.CancelIntent Responda a las palabras y frases que indican que el usuario quiere cancelar la interacción actual. Su aplicación puede utilizar esta intención para eliminar los valores de los tipos de slot y otros atributos antes de finalizar la interacción con el usuario. Enunciados comunes: + cancelar + no importa + olvidar # AMAZON.FallbackIntent Cuando la entrada de un usuario a una intención no es lo que espera un bot, puede configurar Amazon Lex V2 para que invoque una *intención alternativa*. Por ejemplo, si la entrada del usuario «Quiero pedir caramelos» no coincide con una intención del bot `OrderFlowers`, Amazon Lex V2 invoca la intención alternativa para gestionar la respuesta. El tipo de `AMAZON.FallbackIntent` intención integrado se añade al bot automáticamente cuando se crea un bot mediante la consola o cuando se añade una configuración regional a un bot mediante esta operación. [CreateBotLocale](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotLocale.html) La invocación de una intención alternativa se realiza en dos pasos. En el primer paso, la intención alternativa coincide según la entrada del usuario. Cuando la intención alternativa coincide, la forma en que se comporta el bot depende del número de reintentos configurados para una pregunta. Amazon Lex V2 hace coincidir la intención alternativa en estas situaciones: + La entrada del usuario a una intención no coincide con la entrada que espera el bot + La entrada de audio es ruido o la entrada de texto no se reconoce como palabras. + La entrada del usuario es ambigua y Amazon Lex V2 no puede determinar qué intención debe invocar. La intención alternativa se invoca cuando: + Una intención no reconoce la entrada del usuario como un valor de slot después del número de intentos configurado. + Una intención no reconoce la entrada del usuario como respuesta a una pregunta de confirmación después del número de intentos configurado. No puede añadir lo siguiente a una intención alternativa: + Enunciados + Ranuras + Una solicitud de confirmación ## Uso de una función de Lambda con una intención alternativa Cuando se invoca una intención alternativa, la respuesta depende de la configuración del parámetro `fulfillmentCodeHook` para la operación [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html). El bot realiza una de las siguientes operaciones: + Devuelve la información de la intención a la aplicación cliente. + Llama a la función Lambda de validación y cumplimiento del alias. Llama a la función con las variables de sesión que se establecen para la sesión. Para obtener más información acerca de cómo configurar la respuesta cuando se invoca una intención alternativa, consulte el parámetro `fulfillmentCodeHook` de la operación [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html). Si utiliza la función de Lambda con su intención alternativa, puede utilizar esta función para llamar a otra intención o para realizar algún tipo de comunicación con el usuario, como recopilar un número de devolución de llamada o abrir una sesión con un representante del servicio de atención al cliente. Una intención alternativa se puede invocar varias veces en la misma sesión. Por ejemplo, suponga que la función de Lambda utiliza la acción de diálogo `ElicitIntent` para solicitar al usuario una intención diferente. Si Amazon Lex V2 no puede inferir la intención del usuario después del número de intentos configurado, invoca de nuevo la intención alternativa. También invoca la intención alternativa cuando el usuario no responde con un valor de slot válido después del número de intentos configurados. Puede configurar su función de Lambda para realizar un seguimiento del número de veces que se llama a la intención alternativa mediante una variable de sesión. La función de Lambda puede realizar una acción diferente si se llama más veces que el umbral establecido en la función de Lambda. Para obtener más información acerca de las variables de sesión, consulte [Cómo establecer atributos de sesión para su bot Lex V2](context-mgmt-session-attribs.md). # AMAZON.HelpIntent Responde a palabras o frases que indican que el usuario necesita ayuda para interactuar con el bot. Cuando se invoca esta intención, puede configurar la función o aplicación de Lambda para que proporcione información sobre las capacidades del bot, formule preguntas de seguimiento sobre áreas de ayuda o entregue la interacción a un agente humano. Enunciados comunes: + ayuda + ayúdame + ¿me puedes ayudar? # AMAZON.KendraSearchIntent Para buscar documentos indexados con Amazon Kendra, utilice la intención `AMAZON.KendraSearchIntent`. Cuando Amazon Lex V2 no puede determinar la siguiente acción en una conversación con el usuario, desencadena la intención de búsqueda. Solo `AMAZON.KendraSearchIntent` está disponible en la configuración regional en inglés (EE. UU.) (en-US) y en el Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón) y Europa (Irlanda). Amazon Kendra es un servicio de machine-learning-based búsqueda que indexa documentos en lenguaje natural, como documentos PDF o archivos de Microsoft Word. Puede buscar documentos indexados y devolver los siguientes tipos de contestaciones a una pregunta: + Una respuesta + Una entrada de una pregunta frecuente que podría dar respuesta a la pregunta + Un documento relacionado con la pregunta Para ver un ejemplo del uso de `AMAZON.KendraSearchIntent`, consulte [Ejemplo: Creación de un bot de preguntas frecuentes sobre un índice de Amazon Kendra](faq-bot-kendra-search.md). Si configura una intención `AMAZON.KendraSearchIntent` para su bot, Amazon Lex V2 la llamará siempre que no pueda determinar el enunciado del usuario en un slot o una intención. Si no hay respuesta de Amazon Kendra, la conversación continuará tal y como está configurada en el bot. **nota** Actualmente, Amazon Lex V2 no admite la `AMAZON.KendraSearchIntent` durante la obtención del slot. Si Amazon Lex V2 no puede determinar el enunciado del usuario para un slot, llama al `AMAZON.FallbackIntent`. Cuando use la `AMAZON.KendraSearchIntent` con la `AMAZON.FallbackIntent` en el mismo bot, Amazon Lex V2 utiliza las intenciones de la siguiente manera: 1. Amazon Lex V2 llama a la `AMAZON.KendraSearchIntent`. La intención llama a la operación `Query` de Amazon Kendra. 1. Si Amazon Kendra devuelve una respuesta, Amazon Lex V2 muestra el resultado al usuario. 1. Si no hay respuesta por parte de Amazon Kendra, Amazon Lex V2 vuelve a preguntar al usuario. La siguiente acción dependerá de la respuesta del usuario. + Si la respuesta del usuario contiene un enunciado que Amazon Lex V2 reconoce, como llenar un valor de slot o confirmar una intención, la conversación con el usuario continúa conforme a la configuración del bot. + Si la respuesta del usuario no contiene un enunciado que Amazon Lex V2 reconozca, Amazon Lex V2 hará otra llamada a la operación `Query`. 1. Si tras un número establecido de nuevos intentos no hay ninguna respuesta, Amazon Lex V2 llamará a `AMAZON.FallbackIntent` y finalizará la conversación con el usuario. Hay tres formar de usar la `AMAZON.KendraSearchIntent` para hacer una solicitud a Amazon Kendra: + Deje que la intención de búsqueda haga la solicitud por usted. Amazon Lex V2 llama a Amazon Kendra con el enunciado del usuario como cadena de búsqueda. Cuando cree la intención, puede definir una cadena de filtro de consulta que limite el número de respuestas devueltas por Amazon Kendra. Amazon Lex V2 utiliza el filtro en la solicitud de consulta. + Agregue parámetros de consulta adicionales a la solicitud para acotar los resultados de la búsqueda mediante la función de Lambda. Puede agregar un campo `kendraQueryFilterString` que contenga parámetros de consulta de Amazon Kendra a la acción de diálogo `delegate`. Cuando se agregan parámetros de consulta a la solicitud con la función de Lambda, estos tienen prioridad sobre el filtro de consulta que se definió al crear la intención. + Crear una nueva consulta utilizando la función de Lambda. Puede crear una solicitud de consulta de Amazon Kendra completa para que Amazon Lex V2 la envíe. Especifique la consulta en el campo `kendraQueryRequestPayload` de la acción de diálogo `delegate`. El campo `kendraQueryRequestPayload` tiene prioridad sobre el campo `kendraQueryFilterString`. Si desea especificar el parámetro `queryFilterString` al crear un bot o el campo `kendraQueryFilterString` al llamar a la acción `delegate` en una función de Lambda de diálogo, especifique una cadena que se utilice como filtro de atributos en la consulta de Amazon Kendra. Si la cadena no es un filtro de atributos válido, aparecerá una excepción `InvalidBotConfigException` en tiempo de ejecución. Para obtener más información sobre los filtros de atributos, consulte [Usar atributos de documentos para filtrar las consultas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering) en la *Guía para desarrolladores de Amazon Kendra*. Para mantener el control sobre la consulta que Amazon Lex V2 envía a Amazon Kendra, puede especificar una consulta en el campo `kendraQueryRequestPayload` de la función de Lambda de diálogo. Si la consulta no es válida, Amazon Lex V2 devolverá una excepción `InvalidLambdaResponseException`. Para obtener más información, consulte la [Operación Query](https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html) en la *Guía para desarrolladores de Amazon Kendra*. Si desea ver un ejemplo de cómo se usa `AMAZON.KendraSearchIntent`, consulte [Ejemplo: Creación de un bot de preguntas frecuentes sobre un índice de Amazon Kendra](faq-bot-kendra-search.md). ## Política de IAM para Amazon Kendra Search Para utilizar la `AMAZON.KendraSearchIntent` intención, debe utilizar una función que proporcione políticas de AWS Identity and Access Management (IAM) que permitan a Amazon Lex V2 asumir una función en tiempo de ejecución que tenga permiso para denominar la intención de Amazon `Query` Kendra. La configuración de IAM que utilice dependerá de si la ha creado `AMAZON.KendraSearchIntent` con la consola Amazon Lex V2 o con un AWS SDK o la AWS Command Line Interface (AWS CLI). Si utiliza la consola, puede decidir si desea agregar permisos al rol vinculado al servicio de Amazon Lex V2 para que llame a Amazon Kendra o si prefiere utilizar un rol específico para llamar a la operación `Query` de Amazon Kendra. Cuando usa la AWS CLI o un SDK para crear la intención, debe usar un rol específico para llamar a la `Query` operación. ### Asociación de permisos Puede utilizar la consola para asociar permisos que permitan al rol vinculado al servicio de Amazon Lex V2 predeterminado acceder a la operación `Query` de Amazon Kendra. Si asocia permisos al rol vinculado al servicio, no es necesario crear y administrar específicamente un rol en tiempo de ejecución para conectarse al índice de Amazon Kendra. El usuario, el rol o el grupo que utilice para obtener acceso a la consola de Amazon Lex V2 debe tener permisos para administrar políticas de roles. Asocie la siguiente política de IAM al rol de acceso de la consola. Al conceder estos permisos, el rol podrá cambiar la política del rol vinculado al servicio existente. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:AttachRolePolicy", "iam:PutRolePolicy", "iam:GetRolePolicy" ], "Resource": "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexBots*" }, { "Effect": "Allow", "Action": "iam:ListRoles", "Resource": "*" } ] } ``` ------ ### Especificación de un rol Puede usar la consola, la AWS CLI o la API para especificar un rol de tiempo de ejecución que se utilizará al llamar a la operación de Amazon Kendra`Query`. El usuario, rol o grupo que utilice para especificar el rol en tiempo de ejecución debe tener el permiso `iam:PassRole`. La siguiente política define el permiso. Puede utilizar las claves de contexto de condición `iam:AssociatedResourceArn` y `iam:PassedToService` para limitar aún más el alcance de los permisos. Para obtener más información, consulte [IAM y claves de contexto de AWS STS condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_iam-condition-keys.html) en la *Guía del usuario de AWS Identity and Access Management*. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::111122223333:role/role" } ] } ``` ------ El rol en tiempo de ejecución que Amazon Lex V2 tiene que usar para llamar a Amazon Kendra debe tener permisos `kendra:Query`. Cuando se utiliza un rol de IAM existente para obtener permiso para llamar a la operación `Query` de Amazon Kendra, el rol debe tener asociada la siguiente política. Puede usar la consola de IAM, la API de IAM o la AWS CLI para crear una política y asociarla a un rol. Estas instrucciones utilizan la CLI de AWS para crear el rol y las políticas. **nota** El siguiente código tiene formato para Linux y MacOS. Para Windows, reemplace el carácter de continuación de línea de Linux (\$1) por un signo de intercalación (^). **Para agregar permisos de la operación Query a un rol** 1. Cree un documento llamado **KendraQueryPolicy.json** en el directorio actual, agregue el código siguiente y guárdelo. 1. En la AWS CLI, ejecute el siguiente comando para crear la política de IAM para ejecutar la operación de Amazon `Query` Kendra. ``` aws iam create-policy \ --policy-name query-policy-name \ --policy-document file://KendraQueryPolicy.json ``` 1. Asocie la política al rol de IAM que esté utilizando para llamar a la operación `Query`. ``` aws iam attach-role-policy \ --policy-arn arn:aws:iam::account-id:policy/query-policy-name --role-name role-name ``` Puede optar por actualizar el rol vinculado al servicio de Amazon Lex V2 o utilizar el rol que creó al generar la `AMAZON.KendraSearchIntent` de su bot. En el siguiente procedimiento, se muestra cómo puede elegir el rol de IAM que se va a utilizar. **Para especificar el rol de tiempo de ejecución para AMAZON.KendraSearchIntent** 1. Inicie sesión en la consola de administración de AWS y abra la consola de Amazon Lex en [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/). 1. Seleccione el bot al que desee agregar la `AMAZON.KendraSearchIntent`. 1. Seleccione el signo más (\$1) situado junto a **Intenciones**. 1. En **Agregar intención**, seleccione **Buscar intenciones existentes**. 1. En **Intenciones de búsqueda**, escriba **AMAZON.KendraSearchIntent** y seleccione **Agregar**. 1. En **Copiar intención integrada**, escriba un nombre para la intención, como **KendraSearchIntent**, y seleccione **Agregar**. 1. Abra la sección de **consultas de Amazon Kendra**. 1. En **Rol de IAM**, seleccione una de las opciones siguientes: + Para actualizar el rol vinculado al servicio de Amazon Lex V2 y permitir que el bot consulte los índices de Amazon Kendra, seleccione **Agregar permisos de Amazon Kendra**. + Para utilizar un rol que tenga permiso para llamar a la operación `Query` de Amazon Kendra, seleccione **Usar un rol existente**. ## Uso de atributos de solicitud y sesión como filtros Para filtrar la respuesta de Amazon Kendra y obtener los elementos relacionados con la conversación actual, use los atributos de sesión y solicitud como filtros agregando el parámetro `queryFilterString` cuando cree el bot. Especifique un marcador de posición para el atributo cuando cree la intención. De ese modo, Amazon Lex V2 sustituirá el valor antes de llamar a Amazon Kendra. Para obtener más información sobre los atributos de solicitud, consulte [Cómo establecer atributos de solicitud para su bot Lex V2](context-mgmt-request-attribs.md). Para obtener más información acerca de los atributos de sesión, consulte [Cómo establecer atributos de sesión para su bot Lex V2](context-mgmt-session-attribs.md). A continuación, se muestra un ejemplo de un parámetro `queryFilterString` que utiliza una cadena para filtrar la consulta de Amazon Kendra. ``` "{"equalsTo": {"key": "City", "value": {"stringValue": "Seattle"}}}" ``` A continuación, se muestra un ejemplo de un parámetro `queryFilterString` que utiliza un atributo de sesión llamado `"SourceURI"` para filtrar la consulta de Amazon Kendra. ``` "{"equalsTo": {"key": "SourceURI","value": {"stringValue": "[FileURL]"}}}" ``` A continuación, se muestra un ejemplo de un parámetro `queryFilterString` que utiliza un atributo de solicitud llamado `"DepartmentName"` para filtrar la consulta de Amazon Kendra. ``` "{"equalsTo": {"key": "Department","value": {"stringValue": "((DepartmentName))"}}}" ``` Los filtros `AMAZON.KendraSearchInteng` utilizan el mismo formato que los filtros de búsqueda de Amazon Kendra. Para obtener más información, consulte [Usar atributos de documentos para filtrar los resultados de búsqueda](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering) en la *Guía para desarrolladores de Amazon Kendra*. La cadena de filtro de consultas utilizada con la `AMAZON.KendraSearchIntent` debe incluir letras minúsculas para la primera letra de cada filtro. Por ejemplo, a continuación se muestra un filtro de consulta válido para la `AMAZON.KendraSearchIntent`. ``` { "andAllFilters": [ { "equalsTo": { "key": "City", "value": { "stringValue": "Seattle" } } }, { "equalsTo": { "key": "State", "value": { "stringValue": "Washington" } } } ] } ``` ## Usar la respuesta de búsqueda Amazon Kendra devuelve la respuesta a una búsqueda en una respuesta a la declaración `IntentClosingSetting` de intención. La intención debe tener una declaración `closingResponse`, a menos que una función de Lambda genere un mensaje de respuesta de conclusión. Amazon Kendra tiene cinco tipos de respuestas. + Las dos respuestas siguientes requieren que se configure una sección de preguntas frecuentes para su índice de Amazon Kendra. Para obtener más información, consulte [Agregar preguntas y respuestas directamente a un índice](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html). + `x-amz-lex:kendra-search-response-question_answer-question-`: la pregunta de una sección de preguntas frecuentes que coincide con la búsqueda. + `x-amz-lex:kendra-search-response-question_answer-answer-`: la respuesta de una sección de preguntas frecuentes que coincide con la búsqueda. + Las tres respuestas siguientes requieren que se configure un origen de datos para su índice de Amazon Kendra. Para obtener más información, consulte [Crear un origen de datos](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html). + `x-amz-lex:kendra-search-response-document-`: un extracto de un documento del índice relacionado con el texto del enunciado. + `x-amz-lex:kendra-search-response-document-link-`: la URL de un documento del índice relacionado con el texto del enunciado. + `x-amz-lex:kendra-search-response-answer-`: un extracto de un documento del índice que responde a la pregunta. Las respuestas se devuelven en atributos `request`. Puede haber hasta cinco respuestas para cada atributo, numeradas del 1 al 5. Para obtener más información sobre las respuestas, consulte [Tipos de respuesta](https://docs.aws.amazon.com/kendra/latest/dg/response-types.html) en la *Guía para desarrolladores de Amazon Kendra*. La declaración `closingResponse` debe tener uno o varios grupos de mensajes. Cada grupo contiene uno o varios mensajes. Cada mensaje puede contener una o varias variables de marcador de posición que se reemplazarán con los atributos de solicitud de la respuesta proporcionada por Amazon Kendra. En el grupo de mensajes debe haber al menos un mensaje en el que todas las variables se hayan sustituido por los valores de atributo de solicitud obtenidos de la respuesta en tiempo de ejecución o debe haber un mensaje sin variables de marcador de posición. Los atributos de solicitud se separan con paréntesis dobles («((« »))»). Los siguientes mensajes del grupo coinciden con cualquier respuesta de Amazon Kendra: + «He encontrado una pregunta de preguntas frecuentes para usted: ((x-amz-lex: kendra-search-response-question \$1answer-question-1)), y la respuesta es ((x-amz-lex: \$1answer-answer-1))» kendra-search-response-question + «He encontrado un extracto de un documento útil: ((: -1))» x-amz-lex kendra-search-response-document + «Creo que la respuesta a tus preguntas es ((x-amz-lex: kendra-search-response-answer -1))» ## Usar una función de Lambda para administrar la solicitud y la respuesta La intención `AMAZON.KendraSearchIntent` puede utilizar el enlace de código de diálogo y el enlace de código de cumplimentación para administrar la solicitud enviada a Amazon Kendra y la respuesta. Utilice la función de Lambda del enlace de código de diálogo cuando desee modificar la consulta que envía a Amazon Kendra, y la función de Lambda de enlace de código de cumplimentación cuando desee modificar la respuesta. ### Crear una consulta con el enlace de código de diálogo Puede utilizar el enlace de código de diálogo para crear una consulta y enviarla a Amazon Kendra. El uso del enlace de código de diálogo es opcional. Si no especifica ningún enlace de código de diálogo, Amazon Lex V2 creará una consulta a partir del enunciado del usuario y utilizará la `queryFilterString` que se proporcionó al configurar la intención, si se proporcionó alguna. Puede utilizar dos campos en la respuesta del enlace de código de diálogo para modificar la solicitud que se envía a Amazon Kendra: + `kendraQueryFilterString`: utilice esta cadena para especificar los filtros de atributos para la solicitud de Amazon Kendra. Puede filtrar la consulta utilizando cualquiera de los campos definidos en el índice. Para obtener información sobre la estructura de la cadena de filtro, consulte [Usar atributos de documentos para filtrar consultas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering) en la *Guía para desarrolladores de Amazon Kendra*. Si la cadena de filtro especificada no es válida, aparecerá una excepción `InvalidLambdaResponseException`. La cadena `kendraQueryFilterString` invalida cualquier otra cadena de consulta especificada en el campo `queryFilterString` configurado para la intención. + `kendraQueryRequestPayload`: utilice esta cadena para especificar una consulta de Amazon Kendra. La consulta puede utilizar cualquiera de las características de Amazon Kendra. Si no especifica una consulta válida, aparecerá una excepción `InvalidLambdaResponseException`. Para obtener más información, consulte [Consulta](https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html) en la *Guía para desarrolladores de Amazon Kendra*. Una vez que haya creado el filtro o la cadena de consulta, envíe la respuesta a Amazon Lex V2 con el campo `dialogAction` de la respuesta establecido en `delegate`. Amazon Lex V2 envía la consulta a Amazon Kendra y, a continuación, devuelve la respuesta a la consulta al enlace de código de cumplimentación. ### Usar el enlace de código de cumplimentación en la respuesta Una vez que Amazon Lex V2 envía una consulta a Amazon Kendra, la respuesta se devuelve a la función de Lambda de cumplimentación `AMAZON.KendraSearchIntent`. El evento de entrada del enlace de código contiene la respuesta completa de Amazon Kendra. Los datos de consulta tienen la misma estructura que los datos devueltos por la operación `Query` de Amazon Kendra. Para obtener más información, consulte [Sintaxis de la respuesta a la consulta](https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax) en la *Guía para desarrolladores de Amazon Kendra*. El enlace de código de cumplimentación es opcional. Si no existe o si el enlace de código no devuelve un mensaje en la respuesta, Amazon Lex V2 utilizará la declaración `closingResponse` con las respuestas. # Ejemplo: Creación de un bot de preguntas frecuentes sobre un índice de Amazon Kendra En este ejemplo, se crea un bot de Amazon Lex V2 que utiliza un índice de Amazon Kendra para proporcionar respuestas a las preguntas de los usuarios. El bot de preguntas frecuentes (FAQ) se encarga de administrar el diálogo con el usuario. Este bot utiliza la intención `AMAZON.KendraSearchIntent` para consultar el índice y presentar la respuesta al usuario. Este es un resumen de cómo creará su bot de preguntas frecuentes utilizando un índice de Amazon Kendra: 1. Crear un bot con el que sus clientes puedan interactuar para obtener respuestas. 1. Crear una intención personalizada. Como las `AMAZON.KendraSearchIntent` y `AMAZON.FallbackIntent` son intenciones de respaldo, su bot necesita al menos otra intención que contenga al menos un enunciado. Esta intención permitirá compilar el bot, pero no se utilizará de ninguna otra manera. Por lo tanto, su bot de preguntas frecuentes contendrá al menos tres intenciones, como se muestra en la siguiente imagen: ![\[Un bot de preguntas frecuentes de Kendra con tres intenciones\]](http://docs.aws.amazon.com/es_es/lexv2/latest/dg/images/kendra-faqbot/kendra-intents.png) 1. Agregar la intención `AMAZON.KendraSearchIntent` al bot y configurarlo para que funcione con el [índice de Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html). 1. Pruebe el bot realizando una consulta y verificando que los resultados de su índice de Amazon Kendra sean documentos que respondan a la consulta. **Requisitos previos** Para poder utilizar este ejemplo, primero debe crear un índice de Amazon Kendra. Para obtener más información, consulte [Introducción a la consola de Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/gs-console.html) en la *Guía para desarrolladores de Amazon Kendra*. Para este ejemplo, seleccione el conjunto de datos de muestra (**documentación de AWS de muestra**) como origen de datos. **Para crear un bot de preguntas frecuentes** 1. Inicie sesión en la consola de administración de AWS y abra la consola de Amazon Lex en [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/). 1. En el panel de navegación, seleccione **Bots**. 1. Seleccione **Crear bot**. 1. Para el **Método de creación**, seleccione **Crear un bot en blanco**. 1. En la sección **Configuración del bot**, asígnele un nombre que indique su finalidad, como **KendraTestBot**, y una descripción opcional. El nombre debe ser exclusivo en su cuenta. 1. En la sección **Permisos de IAM**, seleccione **Crear un rol con permisos básicos de Amazon Lex**. Esto creará un rol de [AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) con los permisos que Amazon Lex V2 necesita para ejecutar el bot. 1. En la sección **Ley de Protección de la Privacidad en Línea para Niños (COPPA)**, seleccione **No**. 1. En las secciones **Tiempo de espera de la sesión inactiva** y **Configuración avanzada**, deje la configuración predeterminada y seleccione **Siguiente**. 1. Ahora se encuentra en la sección **Añadir idioma al bot**. En el menú de **Interacción por voz**, seleccione **Ninguna. Esta es solo una aplicación basada en texto**. No cambie la configuración predeterminada del resto de los campos. 1. Seleccione **Listo**. Amazon Lex V2 crea su bot y una intención predeterminada llamada **NewIntent**, y lo lleva a la página para configurar esta intención. Para compilar un bot correctamente, debe crear al menos una intención independiente de la `AMAZON.FallbackIntent` y la `AMAZON.KendraSearchIntent`. Esta intención es necesaria para compilar el bot de Amazon Lex V2, pero no se usa para la respuesta de preguntas frecuentes. Esta intención debe contener al menos un ejemplo de enunciado y el enunciado no debe aplicarse a ninguna de las preguntas que haga el cliente. **Para crear la intención necesaria:** 1. En la sección **Detalles de la intención**, dele un nombre a la intención, como **RequiredIntent**. 1. En la sección **Ejemplos de enunciados**, escriba un enunciado en el cuadro situado junto a **Añadir enunciado**, como **Required utterance**. A continuación, seleccione **Añadir enunciado**. 1. Seleccione **Guardar intención**. Cree la intención para buscar un índice de Amazon Kendra y los mensajes de respuesta que debe devolver. **Para crear un AMAZON. KendraSearchIntent mensaje de intención y respuesta:** 1. Seleccione **Volver a la lista de intenciones** en el panel de navegación para volver a la página **Intenciones** de su bot. Seleccione **Añadir intención** y seleccione **Usar intención integrada** en el menú desplegable. 1. En el cuadro que aparece, seleccione el menú en **Intención integrada**. En la barra de búsqueda, escriba **AMAZON.KendraSearchIntent** y selecciónela de la lista. 1. Asigne a la entrada un nombre, como **KendraSearchIntent**. 1. En el menú desplegable **Índice de Amazon Kendra**, seleccione el índice donde desee buscar la intención. El índice que creó en la sección **Requisitos previos** debería estar disponible. 1. Seleccione **Agregar**. 1. En el editor de intenciones, desplácese hacia abajo hasta la sección **Cumplimentación**, seleccione la flecha derecha para expandir la sección y añada el siguiente mensaje en el cuadro que aparece debajo de **En caso de cumplimentación exitoso**: ``` I found a link to a document that could help you: ((x-amz-lex:kendra-search-response-document-link-1)). ``` ![\[Añadir la respuesta de cumplimiento\]](http://docs.aws.amazon.com/es_es/lexv2/latest/dg/images/kendra-faqbot/kendra-fulfillment-response.gif) Para obtener más información sobre la respuesta de búsqueda de Amazon Kendra, consulte [Usar la respuesta de búsqueda](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-kendra-search.html#kendra-search-response). 1. Seleccione **Guardar intención** y, luego, **Compilar** para generar el bot. Cuando el bot esté listo, el banner de la parte superior de la pantalla se volverá verde y mostrará un mensaje de confirmación. Por último, utilice la ventana de prueba de la consola para probar las respuestas del bot. **Para probar el bot de preguntas frecuentes:** 1. Una vez que el bot se haya creado correctamente, seleccione **Probar**. 1. Introduzca **What is Amazon Kendra?** en la ventana de prueba de la consola. Compruebe que el bot responde con un enlace. 1. Para obtener más información sobre la configuración`AMAZON.KendraSearchIntent`, consulte [https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-kendra-search.html](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-kendra-search.html)y [KendraConfiguration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_KendraConfiguration.html). # AMAZON.PauseIntent Responde a las palabras y frases que permiten al usuario pausar una interacción con un bot para poder volver a ella más adelante. La aplicación o función de Lambda necesita guardar los datos de intención en las variables de sesión, o bien, debe usar la operación [GetSession](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_GetSession.html) para recuperar los datos de intención cuando reanude la intención actual. Enunciados comunes: + Pause + Pausar eso # AMAZON.QnAIntent **nota** Para aprovechar las características de la IA generativa debe cumplir los siguientes requisitos previos Para obtener información sobre el precio de uso de Amazon Bedrock, consulte [Precios de Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/). Active las capacidades de IA generativa para la configuración regional de su bot. Para ello, siga los pasos que se indican en [Optimización de la creación y el rendimiento de bots Lex V2 con IA generativa](generative-features.md). Responde a las preguntas de los clientes mediante FM de Amazon Bedrock para buscar y resumir respuestas a preguntas frecuentes. Esta intención se activa cuando un enunciado no está clasificado en ninguna de las otras intenciones presentes en el bot. Tenga en cuenta que esta intención no se activará en el caso de enunciados omitidos cuando se obtenga un valor de slot. Una vez reconocida, la `AMAZON.QnAIntent` utiliza el modelo de Amazon Bedrock especificado para buscar en la base de conocimiento de Amazon Bedrock configurada y responder a la pregunta del cliente. **aviso** No se puede utilizar la `AMAZON.QnAIntent` y la `AMAZON.KendraSearchIntent` en la misma configuración regional del bot. Están disponibles las siguientes opciones de almacén de conocimientos. Debe haber creado ya el almacén de conocimientos e indexado los documentos que contiene. + OpenSearch Dominio de servicio: contiene documentos indexados. Para crear un dominio, sigue los pasos que se indican en [Creación y gestión de dominios OpenSearch de Amazon Service](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/createupdatedomains.html). + Índice de Amazon Kendra: contiene documentos de preguntas frecuentes indexados. Para crear un índice de Amazon Kendra, siga los pasos que se indican en [Crear un índice](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html). + Base de conocimiento de Amazon Bedrock: contiene orígenes de datos indexados. Para configurar una base de conocimiento de Amazon Bedrock, siga los pasos que se indican en [Creación de una base de conocimiento](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html). Si selecciona esta intención, configure los siguientes campos y, a continuación, seleccione **Agregar** para agregar la intención. + **Modelo de Bedrock**: elija el proveedor y el modelo fundacional que desea utilizar para esta intención. Asegúrese de comprobar los últimos modelos disponibles y el calendario de obsolescencia, y planifique las migraciones en consecuencia. Para obtener más información, consulte el ciclo de vida [del modelo](https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html#versions-for-eol). + **Almacén de conocimientos**: elija el origen desde el que desea que el modelo extraiga información para responder a las preguntas de los clientes. Estos son los estados disponibles: + **OpenSearch**— Configure los siguientes campos. + **Punto de conexión del dominio**: proporciona el punto de conexión del dominio que creó para el dominio o que le proporcionaron después de crear el dominio. + **Nombre del índice**: proporcione el índice para realizar búsquedas. Para obtener más información, consulta [Indexación de datos en Amazon OpenSearch Service](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/indexing.html). + Elija cómo desea devolver la respuesta al cliente. + **Respuesta exacta**: cuando esta opción está habilitada, el valor del campo Respuesta se usa tal como está para la respuesta del bot. El modelo fundacional configurado de Amazon Bedrock se utiliza para seleccionar el contenido exacto de la respuesta tal como está, sin síntesis ni resumen del contenido. Especifique el nombre de los campos de pregunta y respuesta que se configuraron en la OpenSearch base de datos. + **Incluir campos**: devuelve una respuesta generada por el modelo mediante los campos que especifique. Especifique el nombre de un máximo de cinco campos que se configuraron en la OpenSearch base de datos. Utilice punto y coma (;) para separar campos. + **Amazon Kendra**: configure los siguientes campos. + **Índice de Amazon Kendra**: seleccione el índice de Amazon Kendra que desea que busque su bot. + **Filtro de Amazon Kendra**: para crear un filtro, selecciona esta casilla. Para obtener más información sobre el formato JSON del filtro de búsqueda de Amazon Kendra, consulte [Usar atributos de documentos para filtrar los resultados de búsqueda](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering). + **Respuesta exacta**: para permitir que el bot devuelva la respuesta exacta de Amazon Kendra, seleccione esta casilla. De lo contrario, el modelo de Amazon Bedrock que seleccione generará una respuesta en función de los resultados. **nota** Para utilizar esta función, primero debe añadir las preguntas frecuentes a su índice siguiendo los pasos que se indican en [Añadir preguntas frecuentes (FAQs) a un índice](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html). + **Base de conocimiento de Amazon Bedrock**: si elige esta opción, especifique el ID de la base de conocimiento de Amazon Bedrock. Puede buscar el ID en la página de detalles de la base de conocimiento de Amazon Bedrock en la consola o enviando una solicitud [GetKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetKnowledgeBase.html). + **Respuesta exacta**: cuando esta opción está habilitada, el valor del campo Respuesta se usa tal como está para la respuesta del bot. El modelo fundacional configurado de Amazon Bedrock se utiliza para seleccionar el contenido exacto de la respuesta tal como está, sin síntesis ni resumen del contenido. Para utilizar la respuesta exacta en la base de conocimientos de Amazon Bedrock, debe hacer lo siguiente: + Cree archivos JSON individuales y que cada archivo contenga un campo de respuesta con la respuesta exacta que debe devolverse al usuario final. + Al indexar estos documentos en la base de conocimientos de Bedrock, establezca la **Estrategia de fragmentación** en **No fragmentar**. + Defina el campo de respuesta en Amazon Lex V2 como el campo de respuesta en Bedrock Knowledge Base. Las respuestas del Qn se AIntent almacenarán en los atributos de la solicitud, tal y como se muestra a continuación: + `x-amz-lex:qnA-search-response`— La respuesta del Qn AIntent a la pregunta o al enunciado. + `x-amz-lex:qnA-search-response-source`: señala el documento o la lista de documentos utilizados para generar la respuesta. + `x-amz-lex:qna-additional-context`— El contexto adicional utilizado por el Qn AIntent para generar la respuesta. **Configuraciones del modelo adicionales** Cuando AIntent se invoca Amazon.qn, utiliza una plantilla de mensaje predeterminada que combina las instrucciones y el contexto con la consulta del usuario para crear el mensaje que se envía al modelo para generar la respuesta. También puede proporcionar una petición personalizada o actualizar la predeterminada para que se ajuste a sus necesidades. Puede diseñar la plantilla de petición con las siguientes herramientas: **Marcadores de posición rápidos**: variables predefinidas en Amazon.qn AIntent para Amazon Bedrock que se rellenan dinámicamente en tiempo de ejecución durante la llamada a Bedrock. En la petición del sistema, puede ver estos marcadores de posición rodeados por el símbolo `$`. En la siguiente lista se describen los marcadores de posición que puede utilizar. | Variable | Se sustituye por | Modelo | ¿Obligatorio? | | --- | --- | --- | --- | | \$1query\$1results\$1 | Los resultados recuperados para la consulta del usuario del almacén de conocimientos. | Modelo de roca madre seleccionado | Sí | | \$1output\$1instruction\$1 | Instrucciones subyacentes para formatear la generación de respuestas y las citas. Depende del modelo. Si define sus propias instrucciones de formato, le sugerimos que elimine este marcador de posición. | Modelo de roca madre seleccionado | No | | \$1contexto\$1adicional\$1 | El contexto adicional utilizado por el Qn para generar la respuesta AIntent | Modelo de roca madre seleccionado | No | | \$1locale\$1 | El idioma en el que el bot responderá a las consultas de los clientes | Modelo Bedrock seleccionado | No | La **petición predeterminada** que se utiliza es: ``` $query_results$ $additional_context$ Please only follow the instructions in tags below. Given the conversation history, and : (1) first, identify the user query intent and classify it as one of the categories: FAQ_QUERY, OTHER_QUERY, GIBBERISH, GREETINGS, AFFIRMATION, CHITCHAT, or MISC; (2) second, if the intent is FAQ_QUERY, predict the most relevant grounding passage(s) by providing the passage id(s) or output CANNOTANSWER; (3) then, generate a concise, to-the-point FAQ-style response in $locale$ locale ONLY USING the grounding content in and ; or output CANNOTANSWER if the user query/request cannot be directly answered with the grounding content. DO NOT mention about the grounding passages such as ids or other meta data; do not create new content not presented in . Do NOT respond to query that is ill-intented or off-topic; (4) lastly, provide the confidence level of the above prediction as LOW, MID or HIGH. $output_instruction$ ``` **\$1output\$1instruction\$1** se sustituye por: ``` Give your final response in the following form: FAQ_QUERY or OTHER_QUERY or GIBBERISH or GREETINGS or AFFIRMATION or CHITCHAT or MISC a concise FAQ-style response or CANNOTANSWER passage_id or CANNOTANSWER LOW or MID or HIGH ``` **nota** Si decide no utilizar las instrucciones predeterminadas, cualquier resultado que proporcione el LLM se devolverá tal cual al usuario final. Las instrucciones de salida deben contener etiquetas y e instrucciones para que el LLM devuelva los passageIds a fin de proporcionar la respuesta y la atribución de la fuente. **Soporte contextual adicional a través de los atributos de la sesión** Puede transferir contexto adicional `AMAZON.QnAIntent` al tiempo de ejecución mediante el atributo session`x-amz-lex:qna-additional-context`. Esto le permite proporcionar información complementaria que el modelo puede utilizar junto con los resultados del almacén de conocimientos al generar una respuesta. El contexto adicional se inserta en la plantilla de solicitud a través del `$additional_context$` marcador de posición. **Ejemplo:** ``` {"sessionAttributes": {"x-amz-lex:qna-additional-context":"Our support hours are Monday through Friday, 8AM-8PM EST"}} ``` **Compatibilidad con el filtrado de metadatos de la base de conocimiento de Amazon Bedrock con atributos de sesión** Puede pasar los filtros de metadatos de la base de conocimiento de Amazon Bedrock como parte del atributo de sesión `x-amz-lex:bkb-retrieval-filter`. ``` {"sessionAttributes":{"x-amz-lex:bkb-retrieval-filter":"{\"equals\":{\"key\":\"insurancetype\",\"value\":\"farmers\"}} ``` **nota** Debe utilizar la base de conocimientos de Amazon Bedrock como almacén de datos para AIntent que Qn utilice este filtro. Para obtener más información, consulte [https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html#:~:text=Metadata%20and%20filtering](https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html#:~:text=Metadata%20and%20filtering) **Configuraciones de inferencia** Puede definir las configuraciones de inferencia que se utilizarán al realizar la llamada a LLM mediante el atributo de sesión: + temperatura: tipo Integer + topP + maxTokens **Ejemplo:** ``` {"sessionAttributes":{"x-amz-lex:llm-text-inference-config":"{\"temperature\":0,\"topP\":1,\"maxTokens\":200}"}} ``` **Las barreras de protección para Bedrock son compatibles con el tiempo de compilación y los atributos de sesión** + Al usar la consola en el momento de la compilación, proporcione el y el GuardrailsIdentifier . GuardrailsVersion Obtenga más información en la sección Additional Model Configurations. + Mediante los atributos de sesión: también puede definir la configuración de las barreras de protección mediante los atributos de sesión: `x-amz-lex:bedrock-guardrails-identifier` y `x-amz-lex:bedrock-guardrails-version`. Para obtener más información sobre el uso de barreras de protección de Bedrock, consulte [Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html). # AMAZON.QnAIntent (multiple use support) Puede elegir tener varios Amazon.qn AIntents dentro de una configuración regional. Amazon Lex V2 admite hasta 5 Amazon.QN AIntents dentro de una configuración regional de bots. Amazon.qn se AIntent puede activar si se cumple uno de los siguientes casos: + Si la configuración regional de un bot contiene solo 1 Amazon.qn AIntent y esa intención no contiene expresiones de muestra, se activa cuando una expresión no está clasificada en ninguna de las otras intenciones presentes en el bot. Esta intención se activa cuando un enunciado no está clasificado en ninguna de las otras intenciones presentes en el bot. Tenga en cuenta que esta intención no se activará en el caso de enunciados omitidos cuando se obtenga un valor de slot. **nota** Si la respuesta del FM no es satisfactoria o falla la llamada al FM, Amazon Lex V2 invoca la `AMAZON.FallbackIntent`. + Si Amazon.qn AIntent contiene ejemplos de expresiones, solo se activa cuando Amazon Lex V2 reconoce que el usuario quiere iniciar esa intención en función de las entradas del usuario. **nota** Si la respuesta del FM no es satisfactoria o falla la llamada al FM, Amazon Lex V2 invoca el siguiente paso al fallo, definido en el bloque de cumplimiento. **nota** Si `botLocale` tiene más de 1 Amazon.QNAIntent, cada Amazon.QN AIntent debe tener al menos un ejemplo de expresión. # AMAZON.QinConnectIntent **nota** Para utilizar las capacidades de IA generativa con Amazon Q In Connect, debe cumplir los siguientes requisitos previos: Diríjase a la consola de Amazon Connect y cree su instancia; si aún no tiene una, consulte [Comenzar a utilizar Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-get-started.html). Habilita Amazon Q en Connect para tu instancia; consulta [Habilitar Amazon Q en Connect para tu instancia](https://docs.aws.amazon.com/connect/latest/adminguide/enable-q.html). AMAZON. QinConnectIntent responde a las preguntas de los clientes mediante la evolución mejorada por LLM de Amazon Connect Wisdom, que ofrece recomendaciones en tiempo real para ayudar a los clientes y agentes del centro de contacto a resolver los problemas de los clientes de forma rápida y precisa. Esta intención se activa cuando un enunciado no está clasificado en ninguna de las otras intenciones presentes en el bot. Tenga en cuenta que esta intención no se activará en el caso de enunciados omitidos cuando se obtenga un valor de slot. Una vez reconocido, el AMAZON. QinConnectIntent, utiliza el dominio Q in Connect especificado para buscar en la base de conocimientos de Amazon Bedrock configurada y responder a la pregunta del cliente. **nota** No puedes usar AMAZON. QinConnectIntent junto con Amazon.qn AIntent en la misma configuración regional del bot. Si seleccionas otro idioma además del inglés estadounidense, debes personalizar las instrucciones del autoservicio (`SELF_SERVICE_PRE_PROCESSING`y`SELF_SERVICE_ANSWER_GENERATION`) para que respondan en el idioma especificado. Para obtener más información sobre cómo personalizar tu mensaje, consulta Cómo [personalizar Amazon Q en Connect](https://docs.aws.amazon.com/connect/latest/adminguide/customize-q.html#ai-prompts-customize-q). Si seleccionas esta intención, tendrás que configurar los siguientes campos y, a continuación, seleccionar **Guardar intención** para añadir la intención al bot. + Configuración de Amazon Q In Connect: proporcione el nombre de recurso de Amazon (ARN) del asistente Amazon Q in Connect. Patrón de ARN del asistente: .`^arn:[a-z-]*?:wisdom:[a-z0-9-]*?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}){0,2}$>` Las respuestas del se QinConnectIntent almacenarán en los atributos de la solicitud, tal y como se muestra a continuación: + `x-amz-lex:q-in-connect-response`— La respuesta QinConnectIntent a la pregunta o al enunciado. **Atributos de sesión devueltos desde QinConnectIntent** La interacción con la QinConnect intención proporciona datos adicionales sobre la conversación a través de los atributos de la sesión. 1. `x-amz-lex:q-in-connect:session-arn`— Un identificador único para la sesión creada con Amazon Q In Connect durante la conversación. 1. `x-amz-lex:q-in-connect:conversation-status`— El estado actual de la conversación con el QinConnect asistente o el dominio. Hay tres valores posibles para este estado: + `CLOSED` + `READY` + `PROCESSING` 1. `x-amz-lex:q-in-connect:conversation-status-reason`— Proporciona el motivo del estado actual informado con el atributo anterior. De lo contrario, las razones posibles son las siguientes: + `SUCCESS`— Indica que al cliente no le queda nada que preguntar y que la pregunta se ha respondido correctamente. + `FAILED`— Indica un error al responder a la pregunta del cliente. En su mayoría, se deben a la falta de comprensión de la pregunta del cliente. + `REJECTED`: indica que el asistente se niega a responder a la pregunta del cliente y recomienda que la pregunta se aborde fuera de la interacción con el bot, por ejemplo, hablando con una persona o un agente, para obtener más información. **nota** Cuando QinConnectIntent se invoca un bot con durante las interacciones con los clientes impulsadas por una instancia de Amazon Connect, es necesario crear el arn de sesión y pasarlo desde la instancia de Amazon Connect. Para crear una sesión, Amazon Connect Flows se puede configurar con Amazon Q en el paso Connect. **Limitaciones** + No puede utilizar AMAZON. QinConnectIntent junto con intenciones sin expresiones específicas, como AMAZON.QN, AMAZON. AIntent BedrockAgentIntent en la misma configuración regional del bot. + Cuando QinConnectIntent se invoca un bot con durante una interacción con un cliente impulsada por una instancia de Amazon Connect, es necesario crear el arn de sesión y pasarlo desde la instancia de Amazon Connect. Para crear una sesión, Amazon Connect Flows se puede configurar con el paso Amazon Q In Connect. + No puede haber más de un AMAZON. QinConnectIntent por configuración regional del bot. + El dominio Amazon Q in Connect utilizado con AMAZON. QinConnectIntent debe estar en la misma región de AWS que el bot Amazon Lex V2. **Permisos** Si el QinConnect Intent se utiliza en un bot de Amazon Lex V2 y el bot utiliza un rol vinculado a servicios (SLR), el servicio Amazon Lex V2 tiene los permisos para actualizar las políticas correspondientes del rol e integrarlo con el asistente Q in Connect. Si el bot utiliza una función de IAM personalizada, el usuario tendrá que añadir estos permisos manualmente a su función de IAM. El rol vinculado al servicio se actualizará con los siguientes permisos si se añade la QinConnect intención. Se agregará una nueva política de QinConnect acceso: ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Sid": "QInConnectAssistantPolicy", "Action": [ "wisdom:CreateSession", "wisdom:GetAssistant" ], "Resource": [ "arn:aws:wisdom:*:accountId:assistant/assistantId", "arn:aws:wisdom:*:accountId:assistant/assistantId/*" ] }, { "Effect": "Allow", "Sid": "QInConnectSessionsPolicy", "Action": [ "wisdom:SendMessage", "wisdom:GetNextMessage" ], "Resource": [ "arn:aws:wisdom:*:accountId:session/assistantId/*" ] }, { "Sid": "QInConnectKmsCMKPolicy", "Effect": "Allow", "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": [ "arn:aws:kms:region:accountId:key/keyId" ], "Condition": { "StringEquals": { "aws:ResourceAccount": "accountId", "kms:ViaService": "wisdom.region.amazonaws.com", "kms:EncryptionContext:aws:wisdom:assistant:arn": ["arn:aws:wisdom:region:accountId:assistant/assistantId"] } } } ] } ``` **nota** La `QInConnectKmsCMKPolicy` declaración solo es obligatoria si utiliza una clave de KMS gestionada por el cliente con el asistente Amazon Q in Connect. **Política de confianza** ``` { "Effect": "Allow", "Sid": "LexV2InternalTrustPolicy", "Principal": { "Service": "lexv2.aws.internal" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "accountId" }, "ArnLike": { "aws:SourceArn": "arn:aws:lex:*:accountId:bot-alias/botId/*" } } } ``` # AMAZON.RepeatIntent Responde a palabras y frases que permiten al usuario repetir el mensaje anterior. La aplicación debe usar una función de Lambda para guardar la información de intención anterior en las variables de sesión, o bien, debe usar la operación [GetSession](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_GetSession.html) para obtener la información de intención anterior. Enunciados comunes: + repetir + dilo otra vez + repite # AMAZON.ResumeIntent Responde a palabras y frases que permiten al usuario reanudar un intento previamente pausado. La aplicación o función de Lambda debe gestionar la información necesaria para reanudar la intención anterior. Enunciados comunes: + resumir + continuar + seguir adelante # AMAZON.StartOverIntent Responde a palabras y frases que permiten al usuario dejar de procesar la intención actual y volver a empezar desde el principio. Puede utilizar la función de Lambda o la operación `PutSession` para volver a obtener el valor del primer slot. Enunciados comunes: + empezar de nuevo + reiniciar + empezar de nuevo # AMAZON.StopIntent Responde a las palabras y frases que indican que el usuario quiere dejar de procesar la intención actual y finalizar la interacción con un bot. La aplicación o función de Lambda debe borrar todos los atributos y valores de tipo de slot existentes y, a continuación, finalizar la interacción. Enunciados comunes: + parar + apagar + calla