Deepgram 音声モデルの設定

Deepgram は、リアルタイムおよびバッチ処理をサポートする高度な AI speech-to-text機能を提供するサードパーティーの音声認識サービスです。Deepgram は、さまざまなオーディオ条件、複数の言語、さまざまなユースケースの特殊なモデルにわたって精度を向上させます。Deepgram のサービスの詳細については、https://deepgram.com/ を参照してください。Deepgram を音声認識モデルの設定として使用するには、1 回限りのセットアッププロセスを完了して Deepgram API キーを設定し、AWS Secrets Manager に安全に保存する必要があります。

重要

Deepgram はサードパーティーのサービスであり、GDPR、FedRAMP、AWS のサービスが準拠するその他のコンプライアンス標準などの特定の規制フレームワークに準拠していない可能性があります。この統合を使用する前に、Deepgram のコンプライアンスドキュメントと組織の要件を確認してください。

Deepgram API キーの作成

Amazon Lex V2 で Deepgram を使用する前に、Deepgram から API キーを取得する必要があります。

Deepgram API キーを作成するには:

1. https://console.deepgram.com/ で Deepgram コンソールにログインします。

2. 左側のナビゲーションペインで、API キーを選択します。

3. 新しい API キーの作成を選択します。

4. 手順に従って API キーを作成し、次のセクションで使用するようにコピーします。

重要

API キーを安全に保存してください。次のセクションで AWS Secrets Manager を設定するには、これが必要です。

AWS Secrets Manager での API キーの保存

Deepgram API キーに安全にアクセスするには、Amazon Lex V2 用の AWS Secrets Manager に保存する必要があります。 Amazon Lex シークレットには、 をキーapiTokenとし、 Deepgram API キーを値とする単一のキーと値のペアが含まれている必要があります。

重要

シークレットで使用する対称 KMS キーを作成する必要があります。デフォルトの AWS マネージド KMS キーは Amazon Lex V2 では機能しません。 V2

Deepgram API キーを Secrets Manager に保存するには:

1. AWS Secrets Manager のコンソールを「https://console.aws.amazon.com/secretsmanager/」で開きます。

2. 新しいシークレットを保存 を選択します。

3. [Secret type] (シークレットタイプ) で、[Other type of secret] (他の種類のシークレット) を選択します。

4. 次のいずれかの方法を使用してシークレットを設定します。

   • キーと値のペアメソッド: キーと値のペアの下に、 をキーapiTokenとして、 Deepgram API キーを値として 1 つのキーと値のペアを追加します。

   • プレーンテキストメソッド: プレーンテキストに、次の構造を持つ JSON オブジェクトを入力します。

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

5. [次へ] を選択します。

6. シークレットの名前を入力し、次へを選択します。

7. (オプション) 必要に応じてシークレットローテーションを設定し、次へを選択します。

8. シークレット設定を確認し、保存を選択します。

9. シークレットを作成したら、シークレットに移動し、ARN をコピーします。この ARN は、ボットを設定するときに必要になります。

Secrets Manager のリソースポリシーの設定

Amazon Lex V2 が Deepgram API キーを取得できるようにするには、シークレットにリソースポリシーをアタッチする必要があります。

以下は、Amazon Lex V2 がシークレットを取得できるようにするリソースポリシーの例です。

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

を実際の AWS アカウント ID <YOUR_ACCOUNT_ID>に置き換え、デプロイに必要な ARN パターンでリージョンを調整します。

Deepgram を使用するようにボットを設定する

Secrets Manager で Deepgram API キーを設定したら、音声認識に Deepgram を使用するように Amazon Lex V2 ボットを設定できます。

ボットの Deepgram を設定するには:

1. Amazon Lex V2 コンソールで、ボットに移動し、設定するロケールを選択します。

2. 音声モデル設定で、Deepgram を選択します。

3. Deepgram 設定の追加フィールドが表示されます。

   • モデル ID (オプション) - 特定のモデルを使用する場合は、Deepgram モデル ID を指定します。使用可能なモデルについては、Deepgram モデルのドキュメントを参照してください。空白のままにすると、API のデフォルトモデルが使用されます。

   • シークレット ARN (必須) - Deepgram API キーを含む AWS Secrets Manager で作成したシークレットの ARN を入力します。

4. 変更を保存して、Deepgram 音声モデル設定をボットロケールに適用します。

これで、音声認識に Deepgram を使用するようにボットが設定されました。ボットをテストして、音声認識が Deepgram 統合で期待どおりに機能していることを確認します。

Deepgram 統合のトラブルシューティング

Deepgram 統合で問題が発生した場合は、以下を確認してください。

• API キーの有効性: Deepgram API キーが有効で、有効期限が切れていないことを確認します。

• シークレット設定: AWS Secrets Manager のシークレットに正しいキー名 (apiToken) と API キー値が含まれていることを確認します。

• リソースポリシー: シークレットのリソースポリシーがAmazon Lex V2 が正しいアカウント ID と ARN パターンでアクセスすることを許可していることを確認します。

• KMS キー: デフォルトの AWS マネージドキーではなく、カスタマーマネージド対称 KMS キーを使用していることを確認します。

• モデル ID: モデル ID を指定した場合は、それが有効な Deepgram モデル識別子であることを確認します。

サポートの詳細については、Amazon Lex V2 CloudWatch ログを参照するか、AWS サポートにお問い合わせください。