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á. # Noções básicas sobre o fluxo de trabalho de pesquisa de locutores do SDK do Amazon Chime Nesta seção, mostramos um exemplo de fluxo de dados e do programa para uma análise de pesquisa de locutor do SDK do Amazon Chime. A função de pesquisa de locutor envolve a criação de uma incorporação de voz, que pode ser usada para comparar a voz de um chamador com os dados de voz armazenados anteriormente. A coleta, o uso, o armazenamento e a retenção de identificadores biométricos e informações biométricas na forma de uma impressão de voz digital podem exigir o consentimento informado do chamador por meio de uma autorização por escrito. Esse consentimento é exigido por várias leis estaduais, incluindo leis de biometria em Illinois, Texas, Washington e outras leis estaduais de privacidade. Antes de usar o atributo de pesquisa de locutor, você deve fornecer todos os avisos e obter todos os consentimentos, conforme exigido por lei e de acordo com os [Termos de serviço da AWS](https://aws.amazon.com/service-terms/) que regem o uso do atributo. O diagrama a seguir mostra um exemplo de fluxo de dados por meio de uma tarefa de análise de pesquisa de locutor. As descrições numeradas abaixo do diagrama descrevem cada etapa do processo. O diagrama pressupõe que você já tenha configurado um conector de voz do SDK do Amazon Chime com uma configuração da análise de chamadas que tenha um `VoiceAnalyticsProcessor`. Para obter mais informações, consulte [Gravar chamadas do conector de voz](record-vc-calls.md). ![Um diagrama mostrando o fluxo de dados por meio de uma análise de pesquisa de locutor.](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/speaker-search-workflow-2.png) 1. Você ou um administrador do sistema criam um domínio de perfil de voz para armazenar incorporações de voz e perfis de voz. Para obter mais informações sobre a criação de domínios de perfil de voz, consulte [Criação de domínios de perfil de voz](https://docs.aws.amazon.com/chime-sdk/latest/ag/create-vp-domain.html) no *Guia do administrador do SDK do Amazon Chime*. Você também pode usar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfileDomain.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfileDomain.html). 1. Um chamador liga usando um número de telefone atribuído a um conector de voz do SDK do Amazon Chime. Ou um atendente usa um número do conector de voz para fazer uma chamada de saída. 1. O serviço conector de voz do SDK do Amazon Chime cria uma ID da transação e a associa à chamada. 1. Supondo que seu aplicativo assine EventBridge eventos, seu aplicativo chama a [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API com a configuração do pipeline de insights de mídia e os ARNs do Kinesis Video Stream para a chamada do Voice Connector. Para obter mais informações sobre o uso EventBridge, consulte[Noções básicas sobre fluxos de trabalho de analytics baseada em machine learning do SDK do Amazon Chime](ml-based-analytics.md). 1. Seu aplicativo: como um sistema interativo de resposta de voz, ou atendente, notifica o chamador sobre a gravação de chamadas e o uso de incorporações de voz para análise de voz e solicita seu consentimento para participar. 1. Depois que o chamador der consentimento, sua aplicação ou o agente poderá chamar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html) por meio do [ SDK de voz](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) se você tiver um Voice Connector e um ID de transação. Ou, se você tiver um ID de pipeline do Media Insights em vez de um ID de transação, chame a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html) no [ SDK de pipelines de mídia](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html). Depois que o chamador fornece o consentimento, seu aplicativo ou o atendente chama a API `StartSpeakerSearchTask`. Você deve passar o ID do Voice Connector, o ID da transação e o ID do domínio do perfil de voz para a API. Uma ID da tarefa de pesquisa de locutor é retornada para identificar a tarefa assíncrona. **nota** Antes de invocar a API `StartSpeakerSearchTask` em qualquer um dos SDKs, você deve fornecer todos os avisos necessários e obter todos os consentimentos necessários, conforme exigido por lei e de acordo com os [Termos de serviço da AWS](https://aws.amazon.com/service-terms/). 1. O sistema acumula 10 segundos da voz do chamador. O chamador deve falar por pelo menos esse período de tempo. O sistema não captura nem analisa o silêncio. 1. O pipeline do Media Insights compara a fala com os perfis de voz no domínio e lista as 10 principais correspondências de alta confiança. Se não encontrar uma correspondência, o Voice Connector cria um perfil de voz. 1. O serviço de pipeline do Media Insights envia um evento de notificação para os destinos de notificação configurados. 1. O chamador continua falando e fornece mais 10 segundos de fala sem silêncio. 1. O pipeline do Media Insights gera uma incorporação de voz de inscrição que você pode usar para criar um perfil de voz ou atualizar um perfil de voz existente. 1. O serviço de pipeline do Media Insights envia uma notificação `VoiceprintGenerationSuccessful` para os destinos de notificação configurados. 1. Sua aplicação chama as APIs [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html) ou [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html) para criar ou atualizar o perfil. 1. Sua aplicação chama a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetSpeakerSearchTask.html) conforme necessário para receber o status mais recente da tarefa de pesquisa de locutores.