Deepgram 스피치 모델 기본 설정 지정 - Amazon Lex
Deepgram API 키 생성AWS Secrets Manager에 API 키 저장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. https://console.deepgram.com/ Deepgram 콘솔에 로그인합니다.

  2. 왼쪽 탐색 창에서 API 키를 선택합니다.

  3. 새 API 키 생성을 선택합니다.

  4. 지침에 따라 API 키를 생성하고 다음 섹션에서 사용할 수 있도록 복사합니다.

중요

API 키를 안전하게 저장합니다. 다음 섹션에서 AWS Secrets Manager를 구성하는 데 필요합니다.

AWS Secrets Manager에 API 키 저장

안전하게 액세스하려면 Deepgram API 키를 Amazon Lex V2용 AWS Secrets Manager에 저장해야 합니다. 보안 암호에는 키로를 사용하고 값으로 Deepgram API 키를 apiToken 사용하는 단일 키-값 페어가 포함되어야 합니다.

중요

보안 암호와 함께 사용할 대칭 KMS 키를 생성해야 합니다. 기본 AWS 관리형 KMS 키는 Amazon Lex V2에서 작동하지 않습니다.

Secrets Manager에 Deepgram API 키를 저장하려면

  1. 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/*/*"
        }
      }
    }
  ]
}

를 실제 AWS 계정 ID<YOUR_ACCOUNT_ID>로 바꾸고 배포에 필요한 대로 ARN 패턴으로 리전을 조정합니다.

Deepgram을 사용하도록 봇 구성

Secrets Manager에서 Deepgram API 키를 설정한 후 음성 인식에 Deepgram을 사용하도록 Amazon Lex V2 봇을 구성할 수 있습니다.

봇에 대해 Deepgram을 구성하려면:

  1. Amazon Lex V2 콘솔에서 봇으로 이동하여 구성할 로캘을 선택합니다.

  2. 음성 모델 기본 설정에서 딥그램을 선택합니다.

  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 키: 기본 AWS 관리형 키가 아닌 고객 관리형 대칭 KMS 키를 사용하고 있는지 확인합니다.

  • 모델 ID: 모델 ID를 지정한 경우 유효한 Deepgram 모델 식별자인지 확인합니다.

추가 지원은 Amazon Lex V2 CloudWatch 로그를 참조하거나 AWS Support에 문의하십시오.