本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 Deepgram 語音模型偏好設定
<a name="customizing-speech-deepgram-setup"></a>

Deepgram 是一種第三方語音辨識服務，可提供進階 AI 支援的speech-to-text功能，並支援即時和批次處理。Deepgram 可在各種音訊條件、多種語言和特殊模型中為不同的使用案例提供增強的準確性。如需 Deepgram 產品的詳細資訊，請參閱 https：//[https://deepgram.com/](https://deepgram.com/)。若要使用 Deepgram 做為語音辨識模型偏好設定，您需要完成一次性設定程序來設定 Deepgram API 金鑰，並將其安全地存放在 AWS Secrets Manager 中。

**重要**  
Deepgram 是第三方服務，可能不符合特定法規架構，例如 GDPR、FedRAMP 或其他 AWS 服務遵循的合規標準。使用此整合之前，請檢閱 Deepgram 的合規文件以及您組織的需求。

## 區域端點選取
<a name="deepgram-regional-endpoints"></a>

Amazon Lex V2 會根據您的 AWS 區域自動選取適當的 Deepgram API 端點，以最佳化效能和資料地區性：
+ **歐洲區域：**對於在字`eu-`首為 的 AWS 區域中部署的機器人 （例如 `eu-west-1`、 和 `eu-central-1`)`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)。

## 建立 Deepgram API 金鑰
<a name="deepgram-api-key-setup"></a>

您必須先從 Deepgram 取得 API 金鑰，才能搭配 Amazon Lex V2 使用 Deepgram。

若要建立 Deepgram API 金鑰：

1. 登入 Deepgram 主控台，網址為 https：//[https://console.deepgram.com/](https://console.deepgram.com/)。

1. 在左側導覽窗格中，選擇 **API 金鑰**。

1. 選擇**建立新的 API 金鑰**。

1. 依照指示建立 API 金鑰並複製，以供下一節使用。

**重要**  
請妥善儲存您的 API 金鑰。在下一節中，您將需要它來設定 AWS Secrets Manager。

## 在 AWS Secrets Manager 中存放 API 金鑰
<a name="secrets-manager-setup"></a>

您必須將 Deepgram API 金鑰存放在 Amazon Lex V2 的 AWS Secrets Manager 中，才能安全地存取它。秘密必須包含具有 `apiToken`做為金鑰的單一金鑰值對，以及具有 做為值的 Deepgram API 金鑰。

**重要**  
您必須建立對稱 KMS 金鑰以與秘密搭配使用。預設 AWS 受管 KMS 金鑰不適用於 Amazon Lex V2。

若要在 Secrets Manager 中存放 Deepgram API 金鑰：

1. 開啟位於 https：//[https://console.aws.amazon.com/secretsmanager/](https://console.aws.amazon.com/secretsmanager/) 的 AWS Secrets Manager 主控台。

1. 選擇**存放新的機密**。

1. 針對**機密類型**，選擇**其他類型的機密**。

1. 使用下列其中一種方法來設定秘密：
   + **索引鍵/值對方法：**在**索引鍵/值對**下，將單一索引鍵/值對新增`apiToken`為索引鍵，並將 Deepgram API 索引鍵新增為值。
   + **純文字方法：**在**純文字**下，輸入具有下列結構的 JSON 物件：

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

1. 選擇**下一步**。

1. 輸入秘密的名稱，然後選擇**下一步**。

1. （選用） 視需要設定秘密輪換，然後選擇**下一步**。

1. 檢閱您的秘密組態，然後選擇**儲存**。

1. 建立秘密後，導覽至您的秘密並複製 ARN。設定機器人時，您將需要此 ARN。

## 設定 Secrets Manager 的資源政策
<a name="secrets-manager-resource-policy"></a>

若要允許 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/*/*"
        }
      }
    }
  ]
}
```

`<YOUR_ACCOUNT_ID>` 將 取代為您實際的 AWS 帳戶 ID，並視需要調整部署 ARN 模式的區域。

## 設定您的機器人以使用 Deepgram
<a name="configuring-bot-deepgram"></a>

在 Secrets Manager 中設定 Deepgram API 金鑰後，您可以將 Amazon Lex V2 機器人設定為使用 Deepgram 進行語音辨識。

若要為機器人設定 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 整合
<a name="deepgram-troubleshooting"></a>

如果 Deepgram 整合發生問題，請檢查下列項目：
+ **API 金鑰有效性：**確保您的 Deepgram API 金鑰有效且尚未過期。
+ **秘密組態：**確認您的 AWS Secrets Manager 中的秘密包含正確的金鑰名稱 (`apiToken`) 和 API 金鑰值。
+ **資源政策：**確認秘密上的資源政策允許 Amazon Lex V2 以正確的帳戶 ID 和 ARN 模式存取它。
+ **KMS 金鑰：**確保您使用的是客戶管理的對稱 KMS 金鑰，而不是預設的 AWS 受管金鑰。
+ **模型 ID：**如果您指定模型 ID，請確認它是有效的 Deepgram 模型識別符。

如需其他支援，請參閱 Amazon Lex V2 CloudWatch 日誌或聯絡 AWS Support。