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.
# Uso de una descripción para crear un bot en Lex V2 con el generador de bots descriptivo
**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).
El generador de bots descriptivo le permite aprovechar el acceso de Amazon Bedrock a modelos de lenguaje de gran tamaño para mejorar la eficiencia del proceso de creación de bots. Se proporciona un mensaje en lenguaje natural que incluye el propósito del bot y las acciones que debe realizar. Amazon Lex V2 aprovecha las capacidades de Amazon Bedrock para generar intenciones y tipos de slots relevantes para el bot en función de la descripción. Cuando haya elegido las intenciones y los tipos de slots que desea conservar, puede iterar el bot para modificarlo según el caso de uso específico. El generador de bots descriptivo ahorra tiempo, ya que evita la necesidad de crear manualmente intenciones y tipos de slots para el bot.
El generador de bots descriptivo está disponible en configuraciones regionales en inglés (consulte las configuraciones regionales que comiencen por `en_` en la tabla de [Idiomas y configuraciones regionales compatibles con Amazon Lex V2](how-languages.md)).
Antes de crear el bot, haga lo siguiente:
1. Compruebe que su rol tiene los permisos correctos revisando los pasos que se indican en[Permisos necesarios para crear un bot con una descripción de lenguaje natural en Lex V2](nld-permissions.md).
1. Decida la descripción que desea utilizar. Puede consultar ejemplos de descripciones de bot en [Ejemplos de descripciones de bots para un generador de bots descriptivo](nld-examples.md).
Cree un bot utilizando lenguaje natural para describir lo que debería hacer el bot. Amazon Lex V2 invoca modelos de Amazon Bedrock para generar intenciones y tipos de slots que se adaptan al caso de uso de su bot. Puede crear el bot con la consola o la API.
------
#### [ Console ]
**Creación de un bot utilizando el generador de bots descriptivo**
1. Inicie sesión en la consola de administración de AWS y abra la consola Amazon Lex V2 en [https://console.aws.amazon.com/lexv2/casa](https://console.aws.amazon.com/lexv2/home).
1. En la página **Bots**, seleccione **Crear bot**.
1. Como **Método de creación**, seleccione **Generador de bots descriptivo - GenAI**.
1. Asigne un nombre a su bot y una descripción opcional, configure los permisos de IAM y elija si su bot está sujeto a COPPA. A continuación, seleccione **Siguiente**.
1. Seleccione un idioma para crear el bot, una voz para el bot y un umbral de confianza para la clasificación de intenciones (para obtener más información, consulte [Uso de puntuaciones de confianza en la intención para mejorar la selección de intenciones con Lex V2](using-intent-confidence-scores.md)).
1. En **Generador de bots descriptivos - GenAI**, proporcione una descripción del bot que desea crear. La descripción debe ser a la vez *detallada* y *precisa* para ayudar a generar intenciones adecuadas y suficientes para el bot. Incluya una lista de acciones para mejorar el proceso de creación de intenciones.
1. Seleccione un proveedor de modelos y un modelo en **Seleccionar modelo**.
1. Para crear el bot en otra configuración regional, seleccione **Agregar otro idioma**. Cuando haya terminado de agregar idiomas, seleccione **Listo**. Amazon Lex V2 crea el bot y el generador de bots descriptivo genera intenciones y slots para él. Cuando se ha generado la configuración regional, el aviso pasa de azul a verde. Seleccione **Revisar** para ver las intenciones generadas y los tipos de slots.
**nota**
Por el momento, el generador de bots descriptivo solo está disponible en configuraciones regionales en inglés. Sin embargo, puede copiar un bot a una configuración regional que no sea en inglés después de crearlo.
**Revisión de las intenciones generadas y los tipos de slots y su adición al bot**
1. Si hay intenciones y tipos de slots suficientes que son aplicables al caso de uso de su bot, puede revisar las intenciones generadas.
1. Revise las **Intenciones generadas**.
1. Seleccione una casilla situada junto a una intención para eliminarla de la lista de intenciones que se agregan al bot.
1. Elija un nombre de intención para ver los **Ejemplos de enunciados** y los **Slots** generados para la intención.
1. Todos los enunciados y los slots están seleccionados de manera predeterminada. Seleccione una casilla para eliminar ese elemento de la intención. Seleccione **Agregar a la selección** para mantener los elementos marcados en la intención.
1. Revise los **Tipos de slots generados**.
1. Seleccione una casilla junto a un tipo de slot para eliminarlo de la lista de intenciones que se agregan al bot.
1. Puede agregar valores a un tipo de slot después de agregarlo al bot
1. Cuando esté satisfecho con las intenciones y los tipos de slots, seleccione **Agregar intenciones y tipos de slots** en la parte superior de la página para agregar las intenciones y los tipos de slots a su bot.
1. Cuando terminen de agregarse los recursos, aparecerá un aviso de confirmación en verde. Vaya a **Intenciones** y **Tipos de slots** para editar los generados y agregar más valores.
1. Si las **Intenciones generadas** y los **Tipos de slots generados** son prácticamente inaplicables al bot que desea crear, siga estos pasos.
1. Seleccione **Nueva generación** en la sección **Detalles del generador de bots descriptivo**.
1. Vuelva a escribir el mensaje y seleccione **Volver a generar** para generar nuevas intenciones y tipos de slots. Los resultados varían si se utiliza un modelo diferente.
**importante**
No se garantiza que se generen las mismas intenciones y slots. Se le cobrará cada vez que vuelva a generar las intenciones y los tipos de slots.
------
#### [ API ]
**Creación del bot utilizando una descripción en lenguaje natural**
Cuando se utiliza el generador de bots descriptivo a través de la API, se crea una definición de bot en un archivo.zip en un bucket de Amazon S3. Descargue este archivo e importe la definición del bot en Amazon Lex V2 para crear el bot.
1. Envíe una [CreateBot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBot.html)solicitud para crear un bot nuevo. A continuación, envía una [CreateBotLocale](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotLocale.html)solicitud para crear una configuración regional para el bot.
1. Envía una [StartBotResourceGeneration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_StartBotResourceGeneration.html)solicitud especificando el ID, la versión y la configuración regional del bot. Puede utilizar `DRAFT` para la versión del bot. Proporcione su mensaje en el campo `generationInputPrompt`. La descripción debe ser a la vez *detallada* y *precisa* para ayudar a generar intenciones adecuadas y suficientes para el bot. Incluya una lista de acciones para mejorar el proceso de creación de intenciones.
1. Anote el `generationId` en la respuesta.
1. Envía una [DescribeBotResourceGeneration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeBotResourceGeneration.html)solicitud utilizando `generationId` lo que recibiste en la `StartBotResourceGeneration` respuesta. Incluya el ID, la versión y la configuración regional del bot.
1. Si el `generationStatus` de la respuesta de `DescribeBotResourceGeneration` es `Complete`, el campo `generatedBotLocaleUrl` también se rellenará. Utilice este URI de Amazon S3 para descargar la definición del bot siguiendo los pasos que se indican en [Descargar un objeto](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html).
**Comprobación e importación de la definición generada del bot**
1. Utilice este URI de Amazon S3 del `generationStatus` en la respuesta de `DescribeBotResourceGeneration` para descargar la definición del bot siguiendo los pasos que se indican en [Descargar un objeto](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html).
1. Puede modificar directamente el contenido generado para el caso de uso específico de su bot editando el archivo. También puede enviar otra solicitud de `StartBotResourceGeneration` para volver a generar intenciones y slots.
**importante**
No se garantiza que se generen las mismas intenciones y slots. Se le cobrará cada vez que vuelva a generar las intenciones y los tipos de slots.
1. Para importar la definición del bot, siga los pasos que se indican en [Importación de bots en Lex V2](import.md).
1. Tras la importación, puede modificar las intenciones y los espacios generados mediante las [UpdateSlotType](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateSlotType.html)operaciones [UpdateIntent[UpdateSlot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateSlot.html)](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html), y.
Para enumerar los metadatos de todos los elementos generados para una configuración regional de bots, utilice la [ListBotResourceGenerations](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListBotResourceGenerations.html)operación. Utilice cualquiera de los valores de `generationId` devueltos en una solicitud de `DescribeBotResourcGeneration` para recuperar el URI de Amazon S3 para una definición de bot generada.
------
**Topics**
+ [Ejemplos de descripciones de bots para un generador de bots descriptivo](nld-examples.md)
+ [Permisos necesarios para crear un bot con una descripción de lenguaje natural en Lex V2](nld-permissions.md)
# Ejemplos de descripciones de bots para un generador de bots descriptivo
Estos son algunos ejemplos útiles de descripciones de bots que puede utilizar con el generador de bots descriptivos de Amazon Lex V2.
| Industry | Mensaje de ejemplo |
| --- | --- |
| Servicios financieros | Somos un servicio de tarjetas financieras que ayuda a los usuarios a realizar tareas cuando reciben una nueva tarjeta, como activar la tarjeta, enviar un PIN por correo electrónico o por correo postal o verificar una nueva tarjeta (mediante un código postal). También les ayudamos en tareas relacionadas con su tarjeta actual, como solicitar información sobre las ventajas de una tarjeta de crédito, denunciar la pérdida de una tarjeta, solicitar una nueva, restablecer el PIN o pagar la factura de una tarjeta. |
| Servicios de alimentación | Quiero un bot que ayude a los clientes a encargar comida (utilizando ID de producto, cantidad y tamaño), comprobar el estado de un pedido y cancelar un pedido. Utilice ID de pedido para indexar los pedidos. |
| Aerolíneas | Somos un dominio de aerolíneas que ayuda a los usuarios a reservar billetes de avión, comprobar los detalles de una reserva, obtener el recibo de un vuelo reservado, consultar el estado del vuelo, reprogramar vuelos reservados, obtener detalles de vuelo y cancelar vuelos reservados. También se pueden generar intenciones adicionales si sirven de apoyo a funciones en la descripción del dominio. |
| Seguros | Objetivo: somos una compañía de seguros que vende pólizas de seguros de automóvil, hogar y rentas. Quiero un bot que pueda comprobar el estado de las reclamaciones, presentar una reclamación, realizar pagos y cancelar una póliza. Usamos policy\$1id y los cuatro últimos números del SSN para identificar y validar la cuenta. Espero que el bot tenga al menos las siguientes intenciones y espacios: autenticación: policy\$1id, últimos 4 SSNpolicy tipos: coche, vivienda, anualidadEstado de la póliza: comprobar el saldo, comprobar la fecha de vencimiento, comprobar la cobertura realizar un pago: pago único, cuotas, importe |
| Gestión de vehículos | Estamos creando un bot de búsqueda de vehículos retirados por la grúa que ayuda a los conductores a averiguar dónde se encuentra su automóvil. Este bot debería preguntar la dirección o la ubicación inicial del automóvil y detalles sobre este, como matrícula y marca, modelo y año de fabricación. El bot debería responder con la ubicación del estacionamiento donde se encuentra el automóvil y su horario. |
| Turismo | Soy agente de viajes y quiero un bot que ayude a mis clientes a reservar un viaje a Disney. Disney cuenta con varios parques de atracciones en todo el mundo, además de hoteles, restaurantes y espectáculos especiales que se pueden reservar. Los usuarios del bot deberían poder modificar o cancelar su reserva. Las reservas deben incluir como mínimo el parque, las fechas y el hotel. Incluir comidas o espectáculos es opcional y se puede agregar o cambiar más adelante. |
# Permisos necesarios para crear un bot con una descripción de lenguaje natural en Lex V2
+ Para acceder a esta característica en la consola de Amazon Lex V2, asegúrese de que su rol de consola tiene permisos de `bedrock:ListFoundationModels` y `bedrock:ListInferenceProfiles`.
+ El rol de IAM asociado al bot debe tener el permiso `bedrock:InvokeModel`. Si habilita la característica con la consola de Amazon Lex, la política se agregará automáticamente al rol de bot siempre que el bot utilice un rol vinculado a un servicio generado por Amazon Lex.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel"
],
"Resource": [
"arn:aws:bedrock:us-east-1::foundation-model/model-id"
]
}
]
}
```
------