本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 设置 Deepgram 语音模型首选项
<a name="customizing-speech-deepgram-setup"></a>

Deepgram 是一项第三方语音识别服务，它提供先进的 AI 驱动 speech-to-text功能，并支持实时和批量处理。Deepgram 在各种音频条件、多种语言和针对不同用例的专用模型中提供了更高的准确性。有关 Deepgram 产品的更多信息，请参阅 [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-`前缀（例如、和`eu-central-1`）的 AWS 区域的机器人 `eu-west-1``eu-west-2`，Amazon Lex V2 使用 Deepgram 欧盟终端节点 (`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 与 Amazon Lex V2 配合使用之前，你需要从 Deepgram 获取 API 密钥。

要创建 Deepgram API 密钥，请：

1. 登录 Deepgram 控制台，网址为 [https://console.deepgram.com/](https://console.deepgram.com/)。

1. 在左侧导航窗格中，选择 **API 密钥**。

1. 选择**创建新 API 密钥**。

1. 按照说明创建 API 密钥并将其复制以供下一节使用。

**重要**  
安全存储 API 密钥。在下一节中，您将需要它来配置 AWS Secrets Manager。

## 将 API 密钥存储在 AWS Secrets Manager 中
<a name="secrets-manager-setup"></a>

你必须将你的 Deepgram API 密钥存储在 AWS Secrets Manager 中，Amazon Lex V2 才能安全地访问它。该密钥必须包含一个键值对，以密钥为密钥，值`apiToken`为你的 Deepgram API 密钥。

**重要**  
您必须创建一个对称 KMS 密钥才能与该密钥一起使用。默认的 AWS 托管 KMS 密钥不适用于 Amazon Lex V2。

要将你的 Deepgram API 密钥存储在 Secrets Manager 中

1. 打开 AWS Secrets Manager 控制台，网址为[https://console.aws.amazon.com/secretsmanager/](https://console.aws.amazon.com/secretsmanager/)。

1. 选择**存储新密钥**。

1. 对于**密钥类型**，请选择**其他密钥类型**。

1. 使用以下方法之一配置密钥：
   + **键/值对方法：**在**键/值对下，添加一个键值对**，以密钥为键，以你的 Deepg `apiToken` ram API 密钥为值。
   + **纯文本方法：**在 P **laintext** 下，输入具有以下结构的 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**（必填）-输入你在 AWS Secrets Manager 中创建的包含你的 Deepgram API 密钥的密钥的 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。