翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Deepgram 音声モデルの設定
Deepgram は、リアルタイムおよびバッチ処理をサポートする高度な AI speech-to-text機能を提供するサードパーティーの音声認識サービスです。Deepgram は、さまざまなオーディオ条件、複数の言語、さまざまなユースケースの特殊なモデルにわたって精度を向上させます。Deepgram のサービスの詳細については、[https://deepgram.com/](https://deepgram.com/) を参照してください。Deepgram を音声認識モデルの設定として使用するには、1 回限りのセットアッププロセスを完了して Deepgram API キーを設定し、AWS Secrets Manager に安全に保存する必要があります。
**重要**
Deepgram はサードパーティーのサービスであり、GDPR、FedRAMP、AWS のサービスが準拠するその他のコンプライアンス標準などの特定の規制フレームワークに準拠していない可能性があります。この統合を使用する前に、Deepgram のコンプライアンスドキュメントと組織の要件を確認してください。
## リージョンエンドポイントの選択
Amazon Lex V2 は、AWS リージョンに基づいて適切な Deepgram API エンドポイントを自動的に選択して、パフォーマンスとデータのローカル性を最適化します。
+ **EU リージョン:** `eu-`プレフィックス (`eu-west-1`、、 など`eu-central-1`) を持つ AWS リージョンにデプロイされたボットの場合`eu-west-2`、Amazon Lex V2 は Deepgram EU エンドポイント () を使用します`api.eu.deepgram.com`。
+ **他のすべてのリージョン:** 他のすべての AWS リージョンにデプロイされたボットの場合、Amazon Lex V2 はグローバル Deepgram エンドポイント () を使用します`api.deepgram.com`。
このエンドポイントの選択は自動であり、現在カスタマイズできません。同じ Deepgram API キーは両方のエンドポイントで機能します。Amazon Lex V2 は、Amazon Connect がカスタムエンドポイント設定に提供する `apiTokenRegion`パラメータをサポートしていません。Amazon Connect のエンドポイント設定オプションの詳細については、[「Amazon Connect 管理者ガイド」の「サードパーティー STT プロバイダーのエンドポイントとリージョン](https://docs.aws.amazon.com/connect/latest/adminguide/endpoints-regions-third-party-stt.html)」を参照してください。 Amazon Connect
## Deepgram API キーの作成
Amazon Lex V2 で Deepgram を使用する前に、Deepgram から API キーを取得する必要があります。
Deepgram API キーを作成するには:
1. [https://console.deepgram.com/](https://console.deepgram.com/) で Deepgram コンソールにログインします。
1. 左側のナビゲーションペインで、**API キー**を選択します。
1. **新しい API キーの作成** を選択します。
1. 手順に従って 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/](https://console.aws.amazon.com/secretsmanager/)」で開きます。
1. **新しいシークレットを保存** を選択します。
1. **[Secret type] (シークレットタイプ)** で、**[Other type of secret]** (他の種類のシークレット) を選択します。
1. 次のいずれかの方法を使用してシークレットを設定します。
+ **キーと値のペアメソッド:** **キーと値のペア**の下に、 をキー`apiToken`として、 Deepgram API キーを値として 1 つのキーと値のペアを追加します。
+ **プレーンテキストメソッド:** **プレーンテキスト**に、次の構造を持つ JSON オブジェクトを入力します。
```
{
"apiToken": "your-deepgram-api-key-here"
}
```
1. [**次へ**] を選択します。
1. シークレットの名前を入力し、**次へ**を選択します。
1. (オプション) 必要に応じてシークレットのローテーションを設定し、次**へ**を選択します。
1. シークレット設定を確認し、**保存**を選択します。
1. シークレットを作成したら、シークレットに移動し、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": ""
},
"ArnLike": {
"aws:SourceArn": "arn:aws:lex:us-east-1::bot-alias/*/*"
}
}
}
]
}
```
を実際の AWS アカウント ID ``に置き換え、デプロイに必要な ARN パターンでリージョンを調整します。
## Deepgram を使用するようにボットを設定する
Secrets Manager で Deepgram API キーを設定したら、音声認識に Deepgram を使用するように Amazon Lex V2 ボットを設定できます。
ボットの Deepgram を設定するには:
1. Amazon Lex V2 コンソールで、ボットに移動し、設定するロケールを選択します。
1. **音声モデル設定**で、**Deepgram** を選択します。
1. Deepgram 設定の追加フィールドが表示されます。
+ **モデル ID** (オプション) - 特定のモデルを使用する場合は、Deepgram モデル ID を指定します。使用可能なモデルについては、[Deepgram モデルのドキュメント](https://developers.deepgram.com/docs/model)を参照してください。空白のままにすると、API のデフォルトモデルが使用されます。
+ **シークレット ARN** (必須) - Deepgram API キーを含む AWS Secrets Manager で作成したシークレットの ARN を入力します。
1. 変更を保存して、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 サポートにお問い合わせください。