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.
# Configuración de la preferencia del modelo de voz de Deepgram
Deepgram es un servicio de reconocimiento de voz de terceros que proporciona speech-to-text capacidades avanzadas impulsadas por IA con soporte para el procesamiento por lotes y en tiempo real. Deepgram ofrece una precisión mejorada en diversas condiciones de audio, varios idiomas y modelos especializados para diferentes casos de uso. [Para obtener más información sobre las ofertas de Deepgram, consultehttps://deepgram.com/.](https://deepgram.com/) Para usar Deepgram como modelo de reconocimiento de voz preferido, debe completar un proceso de configuración único para configurar su clave de API de Deepgram y almacenarla de forma segura en AWS Secrets Manager.
**importante**
Deepgram es un servicio de terceros y es posible que no cumpla con determinados marcos normativos, como el RGPD, FedRAMP u otros estándares de conformidad a los que se adhieran los servicios de AWS. Revise la documentación de conformidad de Deepgram y los requisitos de su organización antes de utilizar esta integración.
## Selección de puntos finales regionales
Amazon Lex V2 selecciona automáticamente el punto de enlace de la API de Deepgram adecuado en función de su región de AWS para optimizar el rendimiento y la localidad de los datos:
+ **Regiones de la UE:** para los bots desplegados en las regiones de AWS con el `eu-` prefijo (como`eu-west-1`, y`eu-central-1`)`eu-west-2`, Amazon Lex V2 utiliza el punto de enlace Deepgram EU (`api.eu.deepgram.com`).
+ **Todas las demás regiones:** para los bots desplegados en todas las demás regiones de AWS, Amazon Lex V2 utiliza el punto de conexión global de Deepgram (`api.deepgram.com`).
La selección de este punto final es automática y actualmente no se puede personalizar. La misma clave de API de Deepgram funciona con ambos puntos finales. Amazon Lex V2 no admite el `apiTokenRegion` parámetro que Amazon Connect proporciona para la configuración de puntos de conexión personalizada. Para obtener más información sobre las opciones de configuración de puntos de conexión de Amazon Connect, consulte [Puntos de conexión y regiones para proveedores de STT de terceros](https://docs.aws.amazon.com/connect/latest/adminguide/endpoints-regions-third-party-stt.html) en la Guía del administrador de Amazon Connect.
## Crear una clave de API de Deepgram
Antes de poder utilizar Deepgram con Amazon Lex V2, debe obtener una clave de API de Deepgram.
Para crear una clave de API de Deepgram:
1. [Inicie sesión en la consola de Deepgram enhttps://console.deepgram.com/.](https://console.deepgram.com/)
1. En el panel de navegación izquierdo, elija **API Keys**.
1. Selecciona **Crear una nueva clave de API**.
1. Sigue las instrucciones para crear la clave de API y cópiala para utilizarla en la siguiente sección.
**importante**
Guarde su clave de API de forma segura. La necesitará para configurar AWS Secrets Manager en la siguiente sección.
## Almacenamiento de la clave de API en AWS Secrets Manager
Debe almacenar su clave de API de Deepgram en AWS Secrets Manager para Amazon Lex V2 para acceder a ella de forma segura. El secreto debe contener un único par clave-valor `apiToken` como clave y su clave de API de Deepgram como valor.
**importante**
Debe crear una clave KMS simétrica para usarla con el secreto. La clave de KMS administrada por AWS predeterminada no funcionará con Amazon Lex V2.
Para almacenar tu clave API de Deepgram en Secrets Manager:
1. Abra la consola de AWS Secrets Manager en [https://console.aws.amazon.com/secretsmanager/](https://console.aws.amazon.com/secretsmanager/).
1. Elija **Almacenar un secreto nuevo**.
1. En **Secret type** (Tipo de secreto), elija **Other type of secret** (Otro tipo de secreto).
1. Configure el secreto mediante uno de los siguientes métodos:
+ **Método de pares clave/valor:** en Pares **clave/valor, añada un único par clave-valor** como clave y su clave de API de Deepgram `apiToken` como valor.
+ **Método de texto sin formato:** en **Texto sin formato, introduzca un objeto JSON** con la siguiente estructura:
```
{
"apiToken": "your-deepgram-api-key-here"
}
```
1. Elija **Siguiente**.
1. **Introduce un nombre para tu secreto y selecciona Siguiente.**
1. (Opcional) Configura la rotación secreta si es necesario y, a continuación, selecciona **Siguiente**.
1. Revisa tu configuración secreta y selecciona **Almacenar**.
1. Una vez creado el secreto, navega hasta tu secreto y copia el ARN. Necesitarás este ARN al configurar tu bot.
## Configuración de la política de recursos para Secrets Manager
Para permitir que Amazon Lex V2 recupere su clave de API de Deepgram, debe adjuntar una política de recursos a su secreto.
El siguiente es un ejemplo de política de recursos que permite a Amazon Lex V2 recuperar el secreto:
```
{
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "LexTrust",
"Effect": "Allow",
"Principal": {
"Service": "lex.amazonaws.com"
},
"Action": "secretsmanager:GetSecretValue",
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:SourceAccount": ""
},
"ArnLike": {
"aws:SourceArn": "arn:aws:lex:us-east-1::bot-alias/*/*"
}
}
}
]
}
```
``Sustitúyalo por el ID de su cuenta de AWS real y ajuste la región en el patrón de ARN según sea necesario para su implementación.
## ¿Está configurando su bot para que utilice Deepgram
Tras configurar la clave API de Deepgram en Secrets Manager, puede configurar su bot Amazon Lex V2 para que utilice Deepgram para el reconocimiento de voz.
Para configurar Deepgram para tu bot:
1. En la consola Amazon Lex V2, navegue hasta el bot y seleccione la configuración regional que desee configurar.
1. Para **preferir el modelo de voz**, selecciona **Deepgram**.
1. Aparecerán campos adicionales para la configuración de Deepgram:
+ **ID de modelo** (opcional): especifique un ID de modelo de Deepgram si desea utilizar un modelo específico. Para ver los modelos disponibles, consulte la documentación del [modelo de Deepgram](https://developers.deepgram.com/docs/model). Si se deja en blanco, se utilizará el modelo predeterminado de la API.
+ **ARN secreto** (obligatorio): introduzca el ARN del secreto que creó en AWS Secrets Manager que contiene su clave de API de Deepgram.
1. Guarde los cambios para aplicar la preferencia del modelo de voz de Deepgram a la configuración regional de su bot.
Su bot ahora está configurado para usar Deepgram para el reconocimiento de voz. Pruebe su bot para asegurarse de que el reconocimiento de voz funciona como se espera con la integración de Deepgram.
## Solución de problemas de integración con Deepgram
Si tiene problemas con su integración con Deepgram, compruebe lo siguiente:
+ **Validez de la clave de API:** asegúrese de que su clave de API de Deepgram sea válida y no haya caducado.
+ **Configuración secreta:** compruebe que su secreto en AWS Secrets Manager contenga el nombre de clave (`apiToken`) y el valor de clave de API correctos.
+ **Política de recursos:** confirme que la política de recursos de su secreto permite a Amazon Lex V2 acceder a él con el ID de cuenta y el patrón de ARN correctos.
+ **Clave de KMS:** asegúrese de utilizar una clave de KMS simétrica gestionada por el cliente, no la clave gestionada por AWS predeterminada.
+ **ID de modelo:** si especificó un ID de modelo, compruebe que es un identificador de modelo de Deepgram válido.
Para obtener asistencia adicional, consulte los CloudWatch registros de Amazon Lex V2 o póngase en contacto con AWS Support.