Testando Agentes
A plataforma SipPulse AI oferece o Agent Playground — um ambiente de teste unificado onde você pode interagir com seus agentes via texto e voz na mesma interface. Valide seus agentes aqui antes de implantá-los em canais de produção como WhatsApp, SIP, Telegram ou widgets web.
Acessando o Agent Playground
- Navegue até Agentes e selecione um agente
- Clique no nome do agente ou em ⋮ → Abrir Playground
Agent Playground
O Agent Playground combina interação por texto e voz em uma única interface. Você pode alternar entre os modos durante uma conversa sem perder o contexto.
Layout da Interface
| Região | Localização | Função |
|---|---|---|
| Lista de Threads | Painel esquerdo | Histórico de conversas com paginação e filtros por trigger |
| Fluxo de Mensagens | Centro | Onde você interage com o Agente por texto ou voz |
| Barra de Controle | Parte superior | Gerencia a conversa (nova, atualizar, encerrar, reabrir, info) |
| Sidebar de Informações | Painel direito (alternar com ℹ️) | Métricas de contexto, custos, status, modelo e ferramentas |
Barra de Controle
| Ícone | Ação | Observações |
|---|---|---|
| ➕ | Nova conversa | Cria um thread em branco |
| 🔄 | Atualizar | Recarrega mensagens |
| ⏹ | Encerrar conversa | Marca como Fechada. Executa Pós-Análise se configurada |
| ▶️ | Reabrir conversa | Aparece apenas quando fechada |
| ℹ️ | Informações | Mostra/oculta a Sidebar de Informações |
Enviando Imagens
Você pode anexar imagens diretamente no chat do agente para testar capacidades de visão.
Como anexar:
- Clique no ícone de anexo na área de entrada do chat
- Ou arraste e solte um arquivo de imagem no chat
Requisitos:
- O modelo do agente deve suportar visão (ex: GPT-4o, Claude Sonnet)
- Formatos suportados: PNG, JPG, JPEG, GIF, WebP
A imagem é enviada junto com sua mensagem de texto. O modelo processa tanto o texto quanto o conteúdo visual para gerar a resposta.
INFO
Se o modelo selecionado não suporta visão, o botão de anexo não fica disponível.
Alternando entre Texto e Voz
O Playground suporta alternância de modo integrada:
- Modo texto: Digite mensagens normalmente no campo de entrada
- Modo voz: Clique no botão de microfone para iniciar uma sessão de voz
Você pode alternar entre os modos a qualquer momento — o contexto da conversa é preservado. Ao iniciar uma sessão de voz, a interface mostra um visualizador de microfone e exibe a transcrição da sua fala junto com as respostas do agente.
TIP
Chamadas de ferramentas (tool calls) feitas pelo agente são exibidas em tempo real durante sessões de voz, para que você veja exatamente quais ações o agente está tomando enquanto fala.
Modo Voz
Para usar o modo voz, seu agente deve ter um modelo TTS e voz configurados na aba Configurações de Voz.
| Elemento | Função |
|---|---|
| Botão de Microfone | Iniciar/encerrar sessão de voz |
| Visualizador de Microfone | Indicador visual quando o mic está ativo |
| Estado do Agente | Mostra Idle, Listening, Thinking ou Speaking |
| Transcrição | Sua fala e respostas do agente aparecem como texto no fluxo de mensagens |
Fluxo da sessão de voz:
- Clique no botão de microfone para conectar
- Fale normalmente — sua fala é transcrita automaticamente
- O agente responde com áudio e texto simultaneamente
- Tool calls aparecem em tempo real durante o processamento
- Clique no botão de microfone novamente para desconectar
INFO
O agente usa TTS streaming por sentença, o que significa que a reprodução de áudio começa antes da resposta completa ser gerada. Isso reduz a latência percebida.
Lista de Threads e Histórico
O painel esquerdo mostra seus threads de conversa com:
- Paginação para navegar em muitos threads
- Filtro por trigger para mostrar threads por origem (UI, API, WhatsApp, SIP, etc.)
- Badges de status indicando o estado do thread (Pendente, Ativo, Em execução, Fechado)
- Indicador de carregamento ao alternar entre threads
Você também pode acessar seu histórico completo de conversas na página History na barra lateral.
Sidebar de Informações
A 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). Canais externos tornam o campo de entrada somente leitura. |
| Status | Estado atual do thread |
| Modelo | LLM utilizado nesta conversa |
| Contexto | Tokens usados / limite do modelo |
| Custo total | Custo de tokens de entrada + saída |
| Velocidade | Média de tokens/s na geração |
| Ferramentas | Tool calls disponíveis para esta conversa |
| Pós-Análise | Resultado estruturado, se configurado e conversa encerrada |
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.
INFO
No modo voz, alterações nas configurações de sessão só têm efeito antes de conectar. Desconecte primeiro se precisar modificá-las.
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.
Testes de Texto
- 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.
Testes de Voz
- 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.
- Confirme que tool calls aparecem corretamente durante sessões de voz.
Pós-Análise
Ao encerrar uma conversa, 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.