Impostazione della preferenza del modello vocale Deepgram - Amazon Lex
Creazione di una chiave API DeepgramArchiviazione della chiave API in AWS Secrets ManagerConfigurazione della politica delle risorse per Secrets ManagerConfigurazione del bot per l'utilizzo di DeepgramRisoluzione dei problemi di integrazione con Deepgram

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Impostazione della preferenza del modello vocale Deepgram

Deepgram è un servizio di riconoscimento vocale di terze parti che fornisce speech-to-text funzionalità avanzate basate sull'intelligenza artificiale con supporto per l'elaborazione in tempo reale e in batch. Deepgram offre una maggiore precisione in varie condizioni audio, più lingue e modelli specializzati per diversi casi d'uso. Per ulteriori informazioni sulle offerte di Deepgram, consulta/. https://deepgram.com Per utilizzare Deepgram come preferenza del modello di riconoscimento vocale, devi completare un processo di configurazione una tantum per configurare la tua chiave API Deepgram e archiviarla in modo sicuro in AWS Secrets Manager.

Importante

Deepgram è un servizio di terze parti e potrebbe non essere conforme a determinati quadri normativi come GDPR, FedRAMP o altri standard di conformità a cui i servizi AWS aderiscono. Consulta la documentazione di conformità di Deepgram e i requisiti della tua organizzazione prima di utilizzare questa integrazione.

Creazione di una chiave API Deepgram

Prima di poter utilizzare Deepgram con Amazon Lex V2, devi ottenere una chiave API da Deepgram.

Per creare una chiave API Deepgram:

  1. Accedi alla console Deepgram all'indirizzohttps://console.deepgram.com/.

  2. Nel riquadro di navigazione a sinistra, scegli API Keys.

  3. Scegli Crea una nuova chiave API.

  4. Segui le istruzioni per creare la chiave API e copiarla per utilizzarla nella sezione successiva.

Importante

Archivia la chiave API in modo sicuro. Ti servirà per configurare AWS Secrets Manager nella sezione successiva.

Archiviazione della chiave API in AWS Secrets Manager

È necessario archiviare la chiave API Deepgram in AWS Secrets Manager for Amazon Lex V2 per accedervi in modo sicuro. Il segreto deve contenere una singola coppia chiave-valore apiToken come chiave e la tua chiave API Deepgram come valore.

Importante

È necessario creare una chiave KMS simmetrica da utilizzare con il segreto. La chiave AWS managed KMS predefinita non funzionerà con Amazon Lex V2.

Per archiviare la tua chiave API Deepgram in Secrets Manager:

  1. Apri la console AWS Secrets Manager all'indirizzo https://console.aws.amazon.com/secretsmanager/.

  2. Scegli Archivia un nuovo segreto.

  3. Per Secret type (Tipo di segreto), scegli Other type of secret (Altro tipo di segreto).

  4. Configura il segreto utilizzando uno dei seguenti metodi:

    • Metodo delle coppie chiave/valore: in Coppie chiave/valore, aggiungi una singola coppia chiave-valore apiToken come chiave e la tua chiave API Deepgram come valore.

    • Metodo di testo semplice: in Plaintext, inserisci un oggetto JSON con la seguente struttura:

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

  5. Scegli Next (Successivo).

  6. Inserisci un nome per il tuo segreto e scegli Avanti.

  7. (Facoltativo) Se necessario, configura la rotazione segreta, quindi scegli Avanti.

  8. Controlla la configurazione segreta e scegli Store.

  9. Dopo aver creato il segreto, accedi al tuo segreto e copia l'ARN. Avrai bisogno di questo ARN per configurare il tuo bot.

Configurazione della politica delle risorse per Secrets Manager

Per consentire ad Amazon Lex V2 di recuperare la tua chiave API Deepgram, devi allegare una politica delle risorse al tuo segreto.

Di seguito è riportato un esempio di politica delle risorse che consente ad Amazon Lex V2 di recuperare il segreto:


{
  "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/*/*"
        }
      }
    }
  ]
}

Sostituiscilo <YOUR_ACCOUNT_ID> con l'ID del tuo account AWS effettivo e modifica la regione nel modello ARN in base alle esigenze della distribuzione.

Configurazione del bot per l'utilizzo di Deepgram

Dopo aver configurato la chiave API Deepgram in Secrets Manager, puoi configurare il tuo bot Amazon Lex V2 per utilizzare Deepgram per il riconoscimento vocale.

Per configurare Deepgram per il tuo bot:

  1. Nella console Amazon Lex V2, accedi al tuo bot e seleziona le impostazioni locali che desideri configurare.

  2. Per la preferenza del modello Speech, scegli Deepgram.

  3. Appariranno campi aggiuntivi per la configurazione di Deepgram:

    • ID modello (opzionale): specifica un ID del modello Deepgram se desideri utilizzare un modello specifico. Per i modelli disponibili, consulta la documentazione del modello Deepgram. Se lasciato vuoto, verrà utilizzato il modello predefinito dell'API.

    • ARN segreto (obbligatorio): inserisci l'ARN del segreto che hai creato in AWS Secrets Manager che contiene la tua chiave API Deepgram.

  4. Salva le modifiche per applicare la preferenza del modello vocale Deepgram alle impostazioni locali del bot.

Il tuo bot è ora configurato per utilizzare Deepgram per il riconoscimento vocale. Metti alla prova il tuo bot per assicurarti che il riconoscimento vocale funzioni come previsto con l'integrazione Deepgram.

Risoluzione dei problemi di integrazione con Deepgram

Se riscontri problemi con l'integrazione con Deepgram, controlla quanto segue:

  • Validità della chiave API: assicurati che la tua chiave API Deepgram sia valida e non sia scaduta.

  • Configurazione segreta: verifica che il segreto in AWS Secrets Manager contenga il nome della chiave (apiToken) e il valore della chiave API corretti.

  • Politica delle risorse: verifica che la politica delle risorse sul tuo account segreto consenta ad Amazon Lex V2 di accedervi con l'ID account e il pattern ARN corretti.

  • Chiave KMS: assicurati di utilizzare una chiave KMS simmetrica gestita dal cliente, non la chiave gestita AWS predefinita.

  • ID modello: se hai specificato un ID modello, verifica che sia un identificatore del modello Deepgram valido.

Per ulteriore supporto, consulta i CloudWatch log di Amazon Lex V2 o contatta AWS Support.