Configuration des préférences du modèle vocal Deepgram - Amazon Lex
Création d'une clé d'API DeepgramStockage de la clé d'API dans AWS Secrets ManagerConfiguration de la politique de ressources pour Secrets ManagerConfiguration de votre bot pour utiliser DeepgramRésolution des problèmes d'intégration à Deepgram

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration des préférences du modèle vocal Deepgram

Deepgram est un service de reconnaissance vocale tiers qui fournit des speech-to-text fonctionnalités avancées basées sur l'IA avec prise en charge du traitement en temps réel et par lots. Deepgram offre une précision améliorée dans diverses conditions audio, dans plusieurs langues et dans des modèles spécialisés pour différents cas d'utilisation. Pour plus d'informations sur les offres de Deepgram, consultez https://deepgram.com/. Pour utiliser Deepgram comme modèle de reconnaissance vocale préféré, vous devez effectuer un processus de configuration unique pour configurer votre clé d'API Deepgram et la stocker en toute sécurité dans AWS Secrets Manager.

Important

Deepgram est un service tiers qui peut ne pas respecter certains cadres réglementaires tels que le RGPD, FedRAMP ou d'autres normes de conformité auxquelles les services AWS adhèrent. Consultez la documentation de conformité de Deepgram et les exigences de votre organisation avant d'utiliser cette intégration.

Création d'une clé d'API Deepgram

Avant de pouvoir utiliser Deepgram avec Amazon Lex V2, vous devez obtenir une clé d'API auprès de Deepgram.

Pour créer une clé d'API Deepgram :

  1. Connectez-vous à la console Deepgram à l'adresse https://console.deepgram.com/.

  2. Dans le volet de navigation de gauche, choisissez API Keys.

  3. Choisissez Créer une nouvelle clé d'API.

  4. Suivez les instructions pour créer la clé d'API et copiez-la pour l'utiliser dans la section suivante.

Important

Stockez votre clé d’API en toute sécurité. Vous en aurez besoin pour configurer AWS Secrets Manager dans la section suivante.

Stockage de la clé d'API dans AWS Secrets Manager

Vous devez stocker votre clé d'API Deepgram dans AWS Secrets Manager pour Amazon Lex V2 pour y accéder en toute sécurité. Le secret doit contenir une seule paire clé-valeur avec apiToken comme clé et votre clé d'API Deepgram comme valeur.

Important

Vous devez créer une clé KMS symétrique à utiliser avec le secret. La clé KMS gérée par AWS par défaut ne fonctionnera pas avec Amazon Lex V2.

Pour enregistrer votre clé d'API Deepgram dans Secrets Manager :

  1. Ouvrez la console AWS Secrets Manager à l'adresse https://console.aws.amazon.com/secretsmanager/.

  2. Choisissez Store a new secret (Stocker un nouveau secret).

  3. Pour Secret type (Type de secret), choisissez Other type of secret (Autre type de secret).

  4. Configurez le secret à l'aide de l'une des méthodes suivantes :

    • Méthode des paires clé/valeur : sous paires clé/valeur, ajoutez une seule paire clé-valeur avec apiToken comme clé et votre clé d'API Deepgram comme valeur.

    • Méthode en texte brut : sous Texte en clair, entrez un objet JSON avec la structure suivante :

      
{
  "apiToken": "your-deepgram-api-key-here"
}

  5. Choisissez Suivant.

  6. Entrez le nom de votre secret et choisissez Next.

  7. (Facultatif) Configurez une rotation secrète si nécessaire, puis choisissez Next.

  8. Passez en revue votre configuration secrète et choisissez Store.

  9. Une fois le secret créé, naviguez jusqu'à votre secret et copiez l'ARN. Vous aurez besoin de cet ARN lors de la configuration de votre bot.

Configuration de la politique de ressources pour Secrets Manager

Pour permettre à Amazon Lex V2 de récupérer votre clé d'API Deepgram, vous devez associer une politique de ressources à votre secret.

Voici un exemple de politique de ressources qui permet à Amazon Lex V2 de récupérer le secret :


{
  "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>Remplacez-le par votre identifiant de compte AWS actuel et ajustez la région dans le modèle ARN selon les besoins de votre déploiement.

Configuration de votre bot pour utiliser Deepgram

Après avoir configuré votre clé d'API Deepgram dans Secrets Manager, vous pouvez configurer votre bot Amazon Lex V2 pour utiliser Deepgram pour la reconnaissance vocale.

Pour configurer Deepgram pour votre bot :

  1. Dans la console Amazon Lex V2, accédez à votre bot et sélectionnez les paramètres régionaux que vous souhaitez configurer.

  2. Pour les préférences relatives au modèle vocal, choisissez Deepgram.

  3. Des champs supplémentaires apparaîtront pour la configuration de Deepgram :

    • ID de modèle (facultatif) - Spécifiez un identifiant de modèle Deepgram si vous souhaitez utiliser un modèle spécifique. Pour connaître les modèles disponibles, consultez la documentation du modèle Deepgram. Si ce champ est laissé vide, le modèle par défaut de l'API sera utilisé.

    • ARN secret (obligatoire) - Entrez l'ARN du secret que vous avez créé dans AWS Secrets Manager et qui contient votre clé d'API Deepgram.

  4. Enregistrez vos modifications pour appliquer la préférence du modèle vocal Deepgram aux paramètres régionaux de votre bot.

Votre bot est désormais configuré pour utiliser Deepgram pour la reconnaissance vocale. Testez votre bot pour vous assurer que la reconnaissance vocale fonctionne comme prévu avec l'intégration de Deepgram.

Résolution des problèmes d'intégration à Deepgram

Si vous rencontrez des problèmes avec votre intégration à Deepgram, vérifiez les points suivants :

  • Validité de la clé d'API : assurez-vous que votre clé d'API Deepgram est valide et n'a pas expiré.

  • Configuration secrète : vérifiez que votre secret dans AWS Secrets Manager contient le nom de clé (apiToken) et la valeur de clé d'API corrects.

  • Politique en matière de ressources : vérifiez que la politique en matière de ressources associée à votre secret autorise Amazon Lex V2 à y accéder avec l'identifiant de compte et le modèle ARN corrects.

  • Clé KMS : assurez-vous d'utiliser une clé KMS symétrique gérée par le client, et non la clé gérée par AWS par défaut.

  • ID de modèle : si vous avez spécifié un identifiant de modèle, vérifiez qu'il s'agit d'un identifiant de modèle Deepgram valide.

Pour obtenir une assistance supplémentaire, consultez les CloudWatch journaux Amazon Lex V2 ou contactez le support AWS.