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á.
Tutorial: WebRTC com retransmissão TURN usando o Amazon Kinesis Video Streams
Neste tutorial, você cria uma conexão de voz WebRTC entre um cliente de navegador e um agente em AgentCore execução no Runtime, usando o TURN gerenciado pelo Amazon Kinesis Video Streams (KVS) para retransmissão de mídia. O agente processa áudio em tempo real usando um modelo básico da Amazon Bedrock para conversação de fala para fala.
Quando concluída, você terá uma conexão WebRTC ativa, na qual o áudio é transmitido bidirecionalmente entre o navegador e seu agente.
Este tutorial exige uma VPC com saída de internet para conectividade com endpoints KVS TURN. Para obter mais informações, consulte Considerações sobre acesso à Internet. Todos os outros pré-requisitos são atendidos pelo aplicativo de amostra. O exemplo usa a AgentCore CLI para implantação no AgentCore Runtime.
Para ver o aplicativo de amostra completo, consulte WebRTC Voice Agent with KVS TURN on.
Arquitetura
- Cliente de navegador
-
Uma página da web que captura o áudio do microfone usando a API WebRTC do navegador e reproduz a resposta de áudio do agente.
- AgentCore Tempo de execução
-
Hospeda o agente e se conecta à VPC do usuário por meio de uma interface de rede elástica (ENI) em uma sub-rede privada.
- Agente
-
Um aplicativo Python implantado no AgentCore Runtime que lida com a sinalização WebRTC e o gerenciamento de credenciais TURN por meio do
/invocationsendpoint e transmite áudio entre o cliente e um modelo básico. - VPC de usuário com saída de internet
-
Fornece conectividade de rede do agente ao servidor de retransmissão KVS TURN. Rotas de tráfego da ENI na sub-rede privada por meio de um gateway NAT e gateway de internet para alcançar os endpoints TURN.
- Servidor de retransmissão KVS TURN
-
Retransmite o tráfego de mídia entre o cliente do navegador e o agente. O agente obtém credenciais TURN temporárias do KVS usando a API. GetIceServerConfig
Como funciona
-
O cliente invoca o agente para obter as credenciais do KVS TURN e a configuração do servidor ICE.
-
O cliente cria uma oferta WebRTC e a envia ao agente. O agente cria uma conexão de mesmo nível configurada com os servidores KVS TURN e retorna uma resposta.
-
O cliente e o agente trocam candidatos ICE para estabelecer conectividade por meio do servidor TURN.
-
Uma vez conectado, o cliente transmite o áudio do microfone para o agente via WebRTC. O agente encaminha o áudio para um modelo da Amazon Bedrock Foundation e transmite a resposta falada do modelo de volta ao cliente.
