As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# 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/.](https://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.
## Seleção de endpoints regionais
O Amazon Lex V2 seleciona automaticamente o endpoint de API Deepgram apropriado com base na sua região da AWS para otimizar o desempenho e a localidade dos dados:
+ **Regiões da UE:** Para bots implantados em regiões da AWS com o `eu-` prefixo (como`eu-west-1`, e`eu-central-1`)`eu-west-2`, o Amazon Lex V2 usa o endpoint Deepgram EU (). `api.eu.deepgram.com`
+ **Todas as outras regiões:** para bots implantados em todas as outras regiões da AWS, o Amazon Lex V2 usa o endpoint global do Deepgram (). `api.deepgram.com`
Essa seleção de endpoint é automática e atualmente não pode ser personalizada. A mesma chave de API do Deepgram funciona com os dois endpoints. O Amazon Lex V2 não suporta o `apiTokenRegion` parâmetro que o Amazon Connect fornece para configuração personalizada de endpoints. Para obter mais informações sobre as opções de configuração de endpoints do Amazon Connect, consulte [Endpoints e regiões para provedores de STT terceirizados no Guia do administrador do Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/endpoints-regions-third-party-stt.html).
## 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/](https://console.deepgram.com/).
1. No painel de navegação esquerdo, escolha **Chaves de API**.
1. Escolha **Criar uma nova chave de API**.
1. 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/](https://console.aws.amazon.com/secretsmanager/).
1. Selecione **Armazenar um novo segredo**.
1. Em **Tipo de segredo**, escolha **Outro tipo de segredo**.
1. 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"
}
```
1. Escolha **Próximo**.
1. Insira um nome para seu segredo e escolha **Avançar**.
1. (Opcional) Configure a rotação secreta, se necessário, e escolha **Avançar**.
1. Revise sua configuração secreta e escolha **Armazenar**.
1. 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": ""
},
"ArnLike": {
"aws:SourceArn": "arn:aws:lex:us-east-1::bot-alias/*/*"
}
}
}
]
}
```
``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.
1. Para a **preferência do modelo de fala**, escolha **Deepgram**.
1. 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](https://developers.deepgram.com/docs/model). 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.
1. 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.