Testando Agentes
A plataforma SipPulse AI oferece dois ambientes de teste para validar seus agentes antes de integrá-los a canais de produção como WhatsApp, SIP ou widgets Web:
- Chat Playground: Teste interações por texto
- Voice Playground: Teste interações por voz em tempo real
Acessando os Playgrounds
- Navegue até Agentes e selecione um agente
- Para acessar o Chat Playground: clique no nome do agente ou em ⋮ → Abrir Chat
- Para acessar o Voice Playground: clique em ⋮ → Playground de Voz
Alternando entre Playgrounds
Na página do agente, use os botões Chat e Voz no topo da área de conversação para alternar entre os modos.
Chat Playground
O Chat Playground é o seu ambiente para testar interações por texto, verificar respostas e validar o comportamento do agente passo a passo.
Anatomia da Interface
| Região | Localização | Função |
|---|---|---|
| Lista de Conversas | Canto esquerdo | Históricos independentes; úteis para testar variações |
| Fluxo de Mensagens | Centro | Local onde você conversa com o Agente em tempo real |
| Barra de Controle | Parte superior | Gerencia a conversa (nova, atualizar, encerrar, reabrir, informações) |
| Sidebar de Informações | Canto direito | Métricas de contexto, custos, status, modelo e ferramentas |
Barra de Controle
| Ícone | Ação | Observações |
|---|---|---|
| ➕ | Nova conversa | Cria um histórico em branco |
| 🔄 | Atualizar | Recarrega mensagens |
| ⏹ | Encerrar conversa | Marca como Fechada. Executa Pós-Análise se configurada |
| ▶️ | Reabrir conversa | Aparece apenas quando fechada. Permite continuar |
| ℹ️ | Informações | Mostra/oculta a Sidebar de Informações |
Lista de Conversas
- Retenção: Usuários do plano Free mantêm conversas por 7 dias
- Status visível: Indicador de um dos quatro estados:
Pendente— aguardando primeira interaçãoAtiva— aberta e aguardando respostaEm execução— o Agente está gerando respostaFechada— encerrada pelo usuário ou sistema
Sidebar de Informações
O Sidebar exibe as configurações do Agente no momento em que a conversa foi criada. Alterações posteriores não são aplicadas retroativamente.
| Campo | O que mostra |
|---|---|
| Acionado por | Canal de origem (UI, API, WhatsApp, SIP) |
| Status | Estado atual da conversa |
| Modelo | LLM utilizado naquela conversa |
| Contexto | Tokens usados / limite do modelo |
| Custo total | Soma de tokens convertida em moeda |
| Velocidade | Média de tokens/s na geração |
| Ferramentas | Lista das tools disponíveis |
| Pós-Análise | Resultado estruturado, se configurado |
Instruções Adicionais & Variáveis
Antes da primeira mensagem, você pode adicionar instruções adicionais que são concatenadas às Instruções do Sistema apenas para essa conversa.
Exemplos de uso:
- Passar contexto temporário: "Esta conversa é sobre o pedido #12345."
- Personalizar: "Você está falando com Mariana"
Se o agente possui variáveis nas instruções, preencha os valores antes de iniciar a conversa.
Voice Playground
O Voice Playground permite testar interações por voz em tempo real. Ideal para validar agentes que serão implantados via SIP ou outros canais de voz.
Pré-requisitos
Para usar o Voice Playground, seu agente deve ter:
- Modelo TTS configurado: Navegue até a aba Voz nas configurações do agente
- Voz TTS selecionada: Escolha a voz desejada para as respostas
Configuração Obrigatória
O botão Conectar permanece desabilitado se o agente não tiver configuração de voz (TTS).
Interface do Voice Playground
Área de Transcrição
Exibe em tempo real:
- Suas falas (transcritas automaticamente)
- Respostas do agente (texto e áudio)
Barra de Controle
| Elemento | Função |
|---|---|
| Permitir Microfone | Solicita permissão do navegador (primeiro uso) |
| Mute/Unmute | Silencia ou ativa seu microfone |
| Visualizador de Áudio | Mostra forma de onda do seu microfone |
| Indicador de Estado | Exibe o estado atual do agente |
| Conectar/Desconectar | Inicia ou encerra a sessão de voz |
Estados do Agente
Durante a conversa por voz, o indicador mostra o estado atual:
| Estado | Cor | Descrição |
|---|---|---|
| Idle | Cinza | Agente aguardando |
| Listening | Verde | Agente ouvindo sua fala |
| Thinking | Roxo | Agente processando resposta |
| Speaking | Azul | Agente falando |
Fluxo de Uso
Permitir Microfone
- Clique em "Permitir Microfone" na primeira vez
- Aceite a permissão do navegador
- O visualizador de áudio aparece quando ativo
Conectar ao Agente
- Clique em Conectar para iniciar a sessão
- O sistema conecta via LiveKit para áudio em tempo real
- Aguarde a conexão ser estabelecida
Conversar por Voz
- Fale normalmente pelo microfone
- Suas falas são transcritas automaticamente
- O agente responde por áudio e texto
Desconectar
- Clique em Desconectar para encerrar
- A conversa é salva na lista de conversas
Configurações de Sessão
Clique no ícone de configurações para acessar:
- Instruções adicionais: Contexto extra para esta sessão
- Variáveis: Valores das variáveis definidas no agente
Nota
Alterações nas configurações de sessão só têm efeito antes de conectar. Se já estiver conectado, desconecte primeiro.
Boas Práticas de Teste
Geral
- Teste antes de produção – cubra todos os cenários críticos e fluxos alternativos
- Compare modelos – algumas tarefas funcionam melhor em modelos maiores; outras exigem menor latência
- Monitore contexto e custo – revise se o Agente ultrapassa 75% do limite de tokens
- Valide ferramentas – certifique-se de que cada tool call retorna o formato esperado
- Documente aprendizados – registre falhas e ajustes para compor histórico de melhorias
Chat Playground
- Teste cenários de erro (respostas vazias, timeouts)
- Valide o comportamento com diferentes tipos de input
- Use instruções adicionais para simular contextos específicos
Voice Playground
- Teste em ambiente silencioso para melhor reconhecimento
- Valide a latência da resposta do agente
- Teste diferentes sotaques e velocidades de fala
- Confirme que a voz TTS selecionada é adequada para o caso de uso
- Verifique o comportamento quando você interrompe o agente
Pós-Análise
Ao encerrar uma conversa (tanto no Chat quanto no Voice Playground), o sistema executa automaticamente as análises estruturadas configuradas no Agente. O resultado aparece na Sidebar para consulta.
Para mais informações sobre análises estruturadas, consulte Análises Estruturadas.
Recursos Relacionados
- Configuração de Agentes – Referência completa de perfil, instruções, ferramentas e parâmetros
- Análises Estruturadas – Como criar métricas automáticas para cada conversa
- Implantação de Agentes – Conectar seu Agente a WhatsApp, HTTP API e mais
- Monitoramento de Conversas – Acompanhar conversas em tempo real