Einstellung der Deepgram-Sprachmodellpräferenz

Deepgram ist ein Spracherkennungsdienst eines Drittanbieters, der fortschrittliche KI-gestützte speech-to-text Funktionen mit Unterstützung für Echtzeit- und Batch-Verarbeitung bietet. Deepgram bietet eine verbesserte Genauigkeit bei verschiedenen Audiobedingungen, mehreren Sprachen und speziellen Modellen für verschiedene Anwendungsfälle. Weitere Informationen zu den Angeboten von Deepgram finden Sie unterhttps://deepgram.com/. Um Deepgram als bevorzugtes Spracherkennungsmodell zu verwenden, müssen Sie einen einmaligen Einrichtungsprozess durchführen, um Ihren Deepgram-API-Schlüssel zu konfigurieren und ihn sicher in AWS Secrets Manager zu speichern.

Wichtig

Deepgram ist ein Drittanbieter-Service und entspricht möglicherweise nicht bestimmten regulatorischen Rahmenbedingungen wie der DSGVO, FedRAMP oder anderen Compliance-Standards, an die sich AWS-Services halten. Lesen Sie die Compliance-Dokumentation von Deepgram und die Anforderungen Ihres Unternehmens, bevor Sie diese Integration verwenden.

Einen Deepgram-API-Schlüssel erstellen

Bevor Sie Deepgram mit Amazon Lex V2 verwenden können, benötigen Sie einen API-Schlüssel von Deepgram.

Um einen Deepgram-API-Schlüssel zu erstellen:

1. Loggen Sie sich unterhttps://console.deepgram.com/in die Deepgram-Konsole ein.

2. Wählen Sie im linken Navigationsbereich API Keys aus.

3. Wählen Sie Neuen API-Schlüssel erstellen aus.

4. Folgen Sie den Anweisungen, um den API-Schlüssel zu erstellen, und kopieren Sie ihn zur Verwendung im nächsten Abschnitt.

Wichtig

Bewahren Sie Ihren API-Schlüssel sicher auf. Sie benötigen es, um AWS Secrets Manager im nächsten Abschnitt zu konfigurieren.

Speichern des API-Schlüssels in AWS Secrets Manager

Sie müssen Ihren Deepgram-API-Schlüssel in AWS Secrets Manager for Amazon Lex V2 speichern, um sicher darauf zugreifen zu können. Das Geheimnis muss ein einzelnes Schlüssel-Wert-Paar mit dem Schlüssel und Ihrem Deepgram-API-Schlüssel apiToken als Wert enthalten.

Wichtig

Sie müssen einen symmetrischen KMS-Schlüssel erstellen, der zusammen mit dem Secret verwendet werden soll. Der standardmäßige AWS-verwaltete KMS-Schlüssel funktioniert nicht mit Amazon Lex V2.

So speichern Sie Ihren Deepgram-API-Schlüssel in Secrets Manager:

1. Öffnen Sie die AWS Secrets Manager Manager-Konsole unter https://console.aws.amazon.com/secretsmanager/.

2. Wählen Sie Store a new secret (Ein neues Secret speichern).

3. Als Secret-Typ wählen Sie Anderer Secret-Typ aus.

4. Konfigurieren Sie das Geheimnis mit einer der folgenden Methoden:

   • Methode für Schlüssel/Wert-Paare: Fügen Sie unter Schlüssel/Wert-Paare ein einzelnes Schlüssel-Wert-Paar mit apiToken als Schlüssel und Ihrem Deepgram-API-Schlüssel als Wert hinzu.

   • Klartext-Methode: Geben Sie unter Klartext ein JSON-Objekt mit der folgenden Struktur ein:

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

5. Wählen Sie Weiter aus.

6. Geben Sie einen Namen für Ihr Geheimnis ein und wählen Sie Weiter.

7. (Optional) Konfigurieren Sie bei Bedarf die geheime Rotation und wählen Sie dann Weiter.

8. Überprüfen Sie Ihre geheime Konfiguration und wählen Sie Speichern aus.

9. Nachdem das Geheimnis erstellt wurde, navigieren Sie zu Ihrem Geheimnis und kopieren Sie den ARN. Sie benötigen diesen ARN, wenn Sie Ihren Bot konfigurieren.

Konfiguration der Ressourcenrichtlinie für Secrets Manager

Damit Amazon Lex V2 Ihren Deepgram-API-Schlüssel abrufen kann, müssen Sie Ihrem Secret eine Ressourcenrichtlinie hinzufügen.

Im Folgenden finden Sie ein Beispiel für eine Ressourcenrichtlinie, die es Amazon Lex V2 ermöglicht, das Geheimnis abzurufen:

{
  "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>Ersetzen Sie es durch Ihre tatsächliche AWS-Konto-ID und passen Sie die Region im ARN-Muster nach Bedarf für Ihre Bereitstellung an.

Konfiguration Ihres Bots für die Verwendung von Deepgram

Nachdem Sie Ihren Deepgram-API-Schlüssel in Secrets Manager eingerichtet haben, können Sie Ihren Amazon Lex V2-Bot so konfigurieren, dass er Deepgram für die Spracherkennung verwendet.

Um Deepgram für Ihren Bot zu konfigurieren:

1. Navigieren Sie in der Amazon Lex V2-Konsole zu Ihrem Bot und wählen Sie das Gebietsschema aus, das Sie konfigurieren möchten.

2. Wählen Sie unter Sprachmodellpräferenz die Option Deepgram aus.

3. Für die Deepgram-Konfiguration werden zusätzliche Felder angezeigt:

   • Modell-ID (optional) — Geben Sie eine Deepgram-Modell-ID an, wenn Sie ein bestimmtes Modell verwenden möchten. Die verfügbaren Modelle finden Sie in der Deepgram-Modelldokumentation. Wenn dieses Feld leer gelassen wird, wird das Standardmodell der API verwendet.

   • Geheimer ARN (erforderlich) — Geben Sie den ARN des Geheimnisses ein, das Sie in AWS Secrets Manager erstellt haben und das Ihren Deepgram-API-Schlüssel enthält.

4. Speichern Sie Ihre Änderungen, um die Deepgram-Sprachmodellpräferenz auf Ihr Bot-Gebietsschema anzuwenden.

Ihr Bot ist jetzt so konfiguriert, dass er Deepgram für die Spracherkennung verwendet. Testen Sie Ihren Bot, um sicherzustellen, dass die Spracherkennung mit der Deepgram-Integration wie erwartet funktioniert.

Fehlerbehebung bei der Deepgram-Integration

Wenn Sie Probleme mit Ihrer Deepgram-Integration haben, überprüfen Sie Folgendes:

• Gültigkeit des API-Schlüssels: Stellen Sie sicher, dass Ihr Deepgram-API-Schlüssel gültig und nicht abgelaufen ist.

• Geheime Konfiguration: Stellen Sie sicher, dass Ihr Geheimnis in AWS Secrets Manager den richtigen Schlüsselnamen (apiToken) und API-Schlüsselwert enthält.

• Ressourcenrichtlinie: Vergewissern Sie sich, dass die Ressourcenrichtlinie für Ihr Geheimnis Amazon Lex V2 den Zugriff darauf mit der richtigen Konto-ID und dem richtigen ARN-Muster ermöglicht.

• KMS-Schlüssel: Stellen Sie sicher, dass Sie einen vom Kunden verwalteten symmetrischen KMS-Schlüssel verwenden, nicht den standardmäßigen AWS-verwalteten Schlüssel.

• Modell-ID: Wenn Sie eine Modell-ID angegeben haben, stellen Sie sicher, dass es sich um eine gültige Deepgram-Modell-ID handelt.

Weitere Support erhalten Sie in den Amazon Lex CloudWatch V2-Protokollen oder wenden Sie sich an den AWS-Support.