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/. 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.

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/.

2. En el panel de navegación izquierdo, elija API Keys.

3. Selecciona Crear una nueva clave de API.

4. 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/.

2. Elija Almacenar un secreto nuevo.

3. En Secret type (Tipo de secreto), elija Other type of secret (Otro tipo de secreto).

4. 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"
     }
                             

5. Elija Siguiente.

6. Introduce un nombre para tu secreto y selecciona Siguiente.

7. (Opcional) Configura la rotación secreta si es necesario y, a continuación, selecciona Siguiente.

8. Revisa tu configuración secreta y selecciona Almacenar.

9. 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": "<YOUR_ACCOUNT_ID>"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:lex:us-east-1:<YOUR_ACCOUNT_ID>:bot-alias/*/*"
        }
      }
    }
  ]
}
        

<YOUR_ACCOUNT_ID>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.

2. Para preferir el modelo de voz, selecciona Deepgram.

3. 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. 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.

4. 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.