Documentação de Teste de Agentes do SipPulse AI
1. Abrindo um Chat com um Agente
A plataforma SipPulse AI permite testar e interagir com vários agentes conversacionais. Esta seção aborda como acessar e iniciar uma sessão de chat com um agente.
Acessando o Painel de Agentes
- Navegue até a interface de gerenciamento de agentes do SipPulse AI
- O painel principal exibe todos os agentes disponíveis com as seguintes informações:
- NOME: O identificador do agente e código de referência interno
- DESCRIÇÃO: Breve explicação do propósito do agente
- MODELO: O modelo de IA que alimenta o agente (ex: gpt-4o-mini, gemini-2.0-flash)
- FERRAMENTAS: Ações disponíveis para cada agente
Iniciando uma Sessão de Chat
Para abrir um chat com qualquer agente:
- Localize o agente desejado na lista (ex: "Agente de Cobrança")
- Clique no ícone de chat na coluna FERRAMENTAS ou selecione "Open chat" no menu suspenso
- Uma nova interface de chat será aberta, exibindo:
- O nome e identificação do agente
- Uma janela de conversa onde as mensagens aparecerão
- Detalhes de conexão (WebRTC, ID da sala)
- Informações do modelo e métricas de conversação
Sistema de Threads de Conversação
Cada interação com um agente é organizada em uma thread única, independentemente do canal de comunicação utilizado:
Identificação de Threads:
- Cada conversa recebe um identificador de thread único (ex: "thr_0196abae07c176dfa05db3b298")
- Este identificador aparece na interface e é utilizado para rastreamento interno
Monitoramento Multichannel:
- O sistema permite acompanhar todas as conversas independentemente do meio utilizado
- As threads podem ser iniciadas e continuadas através de diferentes canais:
- WebRTC (para chamadas de vídeo/áudio via navegador)
- SIP API (para integração com sistemas telefônicos)
- Playground (para testes via interface web)
Histórico Unificado:
- Todas as interações são registradas na mesma thread, criando um histórico contínuo
- Na interface, é possível visualizar as conversas anteriores por data e horário
- As mensagens exibem indicadores do canal utilizado (ex: "WebRTC User")
Gestão de Conversas:
- É possível filtrar e buscar conversas específicas utilizando seus identificadores de thread
- Conversas fechadas podem ser reabertas clicando na opção indicada
2. Importância dos Testes Extensivos de Agentes de Voz
Uma das etapas mais críticas no desenvolvimento de soluções com agentes conversacionais é a realização de testes abrangentes antes da entrada em operação. Esta prática é fundamental pelos seguintes motivos:
Avaliação de Desempenho e Confiabilidade
- Verificação de fluxos de conversação: Garante que o agente responda corretamente a diversas entradas e cenários
- Medição do percentual de execuções corretas: Permite quantificar a confiabilidade do agente em situações reais
- Identificação de pontos de falha: Ajuda a descobrir e corrigir problemas antes do contato com clientes reais
Análise de Custo-Benefício
- Custo por interação: Os testes permitem calcular o custo médio de cada atendimento
- Otimização de prompts: Possibilita ajustes para reduzir consumo de tokens mantendo qualidade
- Planejamento financeiro: Fornece dados para estimar custos operacionais em escala
Troubleshooting Eficiente
- Histórico de threads como ferramenta investigativa: O sistema de threads proporciona rastreabilidade completa das interações, sendo fundamental para:
- Identificar padrões de erro ou comportamentos inesperados
- Analisar conversas problemáticas específicas
- Comparar versões diferentes do mesmo agente
- Documentar casos de uso para referência futura
- Facilitar o refinamento contínuo dos agentes com base em interações reais
Este processo de teste e análise iterativa é essencial para garantir que os agentes de voz do SipPulse AI ofereçam experiências confiáveis, eficientes e com custo controlado quando implementados em ambientes de produção.