Playground
O Playground é onde você testa o agente conversando com ele, do jeito que um cliente conversaria, mas sem enviar nenhuma mensagem real. É a forma segura de validar um ajuste na persona, no conhecimento ou nas ferramentas antes de colocá-lo no ar.
Onde fica
Em cada agente, pelo botão Playground no cabeçalho, ou direto em /ia/agentes/[id]/playground.
O que dá para testar
A tela tem duas colunas: o chat de teste à esquerda e um painel de trace à direita.
- No topo do chat você escolhe um cliente para simular (“Sem cliente identificado (anônimo)” ou um assinante real da sua base) e tem um botão Reset para limpar a conversa. O campo é uma busca: digite nome, telefone ou documento e o resultado vem da sua base (até 20 resultados); sem digitar nada, aparecem os 50 primeiros assinantes por nome. O telefone mostrado na busca vem sempre mascarado.
- Você digita como se fosse o cliente e o agente responde usando o pipeline real: a mesma persona, o mesmo conhecimento e as mesmas ferramentas que ele usaria em produção.
- Escolha o cliente a simular (ou deixe anônimo).
- Mande uma mensagem como se fosse ele.
Enterenvia;Shift+Enterquebra linha. - Leia a resposta e confira o painel de trace para entender como ela foi montada.
Abrir não é o mesmo que testar. Ver a tela do Playground exige só a permissão de ver agentes; mandar uma mensagem exige a permissão de editar agentes, porque as ferramentas rodam de verdade no seu sistema. Se você consegue abrir o Playground mas o primeiro envio dá erro de permissão, é essa a causa.
As mensagens na conversa
Cada mensagem que aparece no chat vem identificada por de onde saiu: Preâmbulo, Aviso de repasse, Apresentação (quando outro agente assume a conversa), Aviso de escalonamento, Resposta ou Fora do horário, e por quem a escreveu (o modelo, o padrão da plataforma, ou o texto que você escreveu no agente). Isso ajuda a distinguir o que é o modelo “decidindo” do que é o produto falando sozinho por código.
Quando o agente passa a conversa para outro agente
Se o agente decide passar a conversa para outro agente de IA (por exemplo, a triagem passando para o financeiro), ou devolvê-la à triagem, a troca acontece dentro do teste, como aconteceria no WhatsApp: sai o Aviso de repasse, quem assumiu se apresenta e continua respondendo as próximas mensagens. Valem as mesmas regras do atendimento real, então o agente só passa a conversa para um agente que está ligado e disponível.
Nada é gravado em conversa do Atendimento. O botão Reset, ou trocar o agente no seletor, recomeça o teste com o agente escolhido na tela.
O painel de trace
O painel lateral abre o passo a passo de cada resposta: a mensagem de entrada, o que o modelo gerou, as ferramentas que foram chamadas, o canal final e a latência. É a melhor forma de descobrir por que o agente respondeu de um jeito, e ajustar a base ou a persona a partir disso.
As ferramentas executam de verdade. Uma mensagem de teste que leva o agente a chamar uma tool aciona a ação real no seu sistema, inclusive abrir chamado, enviar 2ª via ou, se habilitadas, ações que mexem na conexão (reiniciar ONU, estender vencimento). Teste com um cliente de referência e cuidado com ações irreversíveis.
O que o Playground não é
- Não fala com clientes reais. Nada do que você digita aqui vira mensagem de WhatsApp ou ligação para o cliente. É uma simulação da sua ponta.
- Não é o canal de atendimento. As conversas de verdade ficam no Atendimento e no histórico.
Próximo passo
→ Entenda seu agente → Boas práticas