View a markdown version of this page

設定 Deepgram 語音模型偏好設定 - Amazon Lex
區域端點選取建立 Deepgram API 金鑰在 AWS Secrets Manager 中存放 API 金鑰設定 Secrets Manager 的資源政策設定您的機器人以使用 Deepgram故障診斷 Deepgram 整合

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

設定 Deepgram 語音模型偏好設定

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

重要

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

區域端點選取

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 提供者的端點和區域。

建立 Deepgram API 金鑰

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

若要建立 Deepgram API 金鑰：

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

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

  3. 選擇建立新的 API 金鑰。

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

重要

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

在 AWS Secrets Manager 中存放 API 金鑰

您必須將 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/ 的 AWS Secrets Manager 主控台。

  2. 選擇存放新的機密。

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

  4. 使用下列其中一種方法來設定秘密：

    • 索引鍵/值對方法：在索引鍵/值對下，將單一索引鍵/值對新增apiToken為索引鍵，並將 Deepgram API 索引鍵新增為值。

    • 純文字方法：在純文字下，輸入具有下列結構的 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/*/*"
        }
      }
    }
  ]
}

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

設定您的機器人以使用 Deepgram

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

若要為機器人設定 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 金鑰：確保您使用的是客戶管理的對稱 KMS 金鑰，而不是預設的 AWS 受管金鑰。

  • 模型 ID：如果您指定模型 ID，請確認它是有效的 Deepgram 模型識別符。

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