设置 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 的合规文档和贵组织的要求。

创建 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 密钥不适用于亚马逊 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。