View a markdown version of this page

设置 Deepgram 语音模型首选项 - Amazon Lex
区域端点选择创建 Deepgram API 密钥将 API 密钥存储在 AWS Secrets Manager 中为 Secrets Manager 配置资源策略将你的机器人配置为使用 Deepgram排查 Deepgram

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

设置 Deepgram 语音模型首选项

Deepgram 是一项第三方语音识别服务，它提供先进的 AI 驱动 speech-to-text功能，并支持实时和批量处理。Deepgram 在各种音频条件、多种语言和针对不同用例的专用模型中提供了更高的准确性。有关 Deepgram 产品的更多信息，请参阅 https://deepgram.com/。要使用 Deepgram 作为您的语音识别模型首选项，您需要完成一次性设置过程来配置 Deepgram API 密钥并将其安全地存储在 AWS Secrets Manager 中。

重要

Deepgram 是一项第三方服务，可能不符合某些监管框架，例如 GDPR、FedRAMP 或 AWS 服务所遵守的其他合规标准。在使用此集成之前，请查看 Deepgram 的合规文档和贵组织的要求。

区域端点选择

Amazon Lex V2 会根据你的 AWS 区域自动选择相应的 Deepgram API 终端节点，以优化性能和数据局部性：

  • 欧洲区域：对于部署在带有eu-前缀（例如、和eu-central-1）的 AWS 区域的机器人 eu-west-1eu-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 提供商的终端节点和区域。

创建 Deepgram API 密钥

在将 Deepgram 与 Amazon Lex V2 配合使用之前，你需要从 Deepgram 获取 API 密钥。

要创建 Deepgram API 密钥，请：

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

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

  3. 选择创建新 API 密钥。

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

重要

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

将 API 密钥存储在 AWS Secrets Manager 中

你必须将你的 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/。

  2. 选择存储新密钥。

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

  4. 使用以下方法之一配置密钥：

    • 键/值对方法：在键/值对下，添加一个键值对，以密钥为键，以你的 Deepg apiToken ram API 密钥为值。

    • 纯文本方法：在 P laintext 下，输入具有以下结构的 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（必填）-输入你在 AWS Secrets Manager 中创建的包含你的 Deepgram API 密钥的密钥的 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。