Configurando a preferência do modelo de fala do Deepgram

O Deepgram é um serviço terceirizado de reconhecimento de fala que fornece speech-to-text recursos avançados baseados em IA com suporte para processamento em tempo real e em lote. O Deepgram oferece maior precisão em várias condições de áudio, vários idiomas e modelos especializados para diferentes casos de uso. Para obter mais informações sobre as ofertas da Deepgram, consultehttps://deepgram.com/. Para usar o Deepgram como sua preferência de modelo de reconhecimento de fala, você precisa concluir um processo de configuração único para configurar sua chave de API do Deepgram e armazená-la com segurança no AWS Secrets Manager.

Importante

O Deepgram é um serviço terceirizado e pode não estar em conformidade com determinadas estruturas regulatórias, como GDPR, FedRAMP ou outros padrões de conformidade aos quais os serviços da AWS aderem. Revise a documentação de conformidade do Deepgram e os requisitos de sua organização antes de usar essa integração.

Criação de uma chave de API do Deepgram

Antes de usar o Deepgram com o Amazon Lex V2, você precisa obter uma chave de API do Deepgram.

Para criar uma chave de API do Deepgram:

1. Faça login no console do Deepgram em https://console.deepgram.com/.

2. No painel de navegação esquerdo, escolha Chaves de API.

3. Escolha Criar uma nova chave de API.

4. Siga as instruções para criar a chave de API e copiá-la para uso na próxima seção.

Importante

Armazene a chave de API em segurança. Você precisará dele para configurar o AWS Secrets Manager na próxima seção.

Armazenamento da chave de API no AWS Secrets Manager

Você deve armazenar sua chave de API do Deepgram no AWS Secrets Manager para Amazon Lex V2 para acessá-la com segurança. O segredo deve conter um único par de valores-chave apiToken como chave e sua chave da API Deepgram como valor.

Importante

Você deve criar uma chave KMS simétrica para usar com o segredo. A chave padrão do KMS gerenciado pela AWS não funcionará com o Amazon Lex V2.

Para armazenar sua chave de API Deepgram no Secrets Manager:

1. Abra o console do AWS Secrets Manager em https://console.aws.amazon.com/secretsmanager/.

2. Selecione Armazenar um novo segredo.

3. Em Tipo de segredo, escolha Outro tipo de segredo.

4. Configure o segredo usando um dos seguintes métodos:

   • Método de pares de chave/valor: em Pares de chave/valor, adicione um único par de valores-chave apiToken como chave e sua chave da API Deepgram como valor.

   • Método de texto sem formatação: em Texto sem formatação, insira um objeto JSON com a seguinte estrutura:

     
     {
       "apiToken": "your-deepgram-api-key-here"
     }
                             

5. Escolha Próximo.

6. Insira um nome para seu segredo e escolha Avançar.

7. (Opcional) Configure a rotação secreta, se necessário, e escolha Avançar.

8. Revise sua configuração secreta e escolha Armazenar.

9. Depois que o segredo for criado, navegue até seu segredo e copie o ARN. Você precisará desse ARN ao configurar seu bot.

Configurando a política de recursos para o Secrets Manager

Para permitir que o Amazon Lex V2 recupere sua chave de API do Deepgram, você precisa anexar uma política de recursos ao seu segredo.

Veja a seguir um exemplo de política de recursos que permite ao Amazon Lex V2 recuperar o segredo:

{
  "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>Substitua pelo ID real da sua conta da AWS e ajuste a região no padrão ARN conforme necessário para sua implantação.

Configurando seu bot para usar o Deepgram

Depois de configurar sua chave de API do Deepgram no Secrets Manager, você pode configurar seu bot Amazon Lex V2 para usar o Deepgram para reconhecimento de fala.

Para configurar o Deepgram para seu bot:

1. No console do Amazon Lex V2, navegue até seu bot e selecione a localidade que você deseja configurar.

2. Para a preferência do modelo de fala, escolha Deepgram.

3. Campos adicionais aparecerão para a configuração do Deepgram:

   • ID do modelo (opcional) - Especifique um ID do modelo Deepgram se quiser usar um modelo específico. Para ver os modelos disponíveis, consulte a documentação do modelo Deepgram. Se deixado em branco, o modelo padrão da API será usado.

   • ARN secreto (obrigatório) — Insira o ARN do segredo que você criou no AWS Secrets Manager que contém sua chave de API do Deepgram.

4. Salve suas alterações para aplicar a preferência do modelo de fala do Deepgram à localidade do seu bot.

Seu bot agora está configurado para usar o Deepgram para reconhecimento de fala. Teste seu bot para garantir que o reconhecimento de fala esteja funcionando conforme o esperado com a integração do Deepgram.

Solução de problemas da integração do Deepgram

Se você encontrar problemas com sua integração com o Deepgram, verifique o seguinte:

• Validade da chave de API: certifique-se de que sua chave de API do Deepgram seja válida e não tenha expirado.

• Configuração secreta: verifique se seu segredo no AWS Secrets Manager contém o nome da chave (apiToken) e o valor da chave de API corretos.

• Política de recursos: confirme se a política de recursos do seu segredo permite que o Amazon Lex V2 o acesse com o ID da conta e o padrão ARN corretos.

• Chave KMS: certifique-se de usar uma chave KMS simétrica gerenciada pelo cliente, não a chave gerenciada padrão da AWS.

• ID do modelo: se você especificou um ID de modelo, verifique se é um identificador de modelo válido do Deepgram.

Para obter suporte adicional, consulte os CloudWatch registros do Amazon Lex V2 ou entre em contato com o AWS Support.