O que é e para que serve
O Playground é um chat de teste integrado à tela de configuração do seu Agente IA. Ele permite conversar com o agente como se você fosse um cliente, sem conectar nenhum canal e sem que nenhum cliente real veja essas conversas.
Funciona como um ambiente isolado da produção. “Produção” é quando o agente já atende clientes reais em um canal conectado, como WhatsApp, Instagram ou Messenger.
Por que você precisa disso: sem o Playground, a única forma de saber como seu agente responde é conectá-lo a um canal real. Isso significa que qualquer erro de configuração, como um tom inadequado ou uma resposta incorreta, chega diretamente aos seus clientes.
Para que você usa:
- Validar como seu agente responde antes de conectá-lo a um canal.
- Testar mudanças no comportamento dele (instruções, tom e respostas) e ver o resultado na hora.
- Repetir o mesmo teste quantas vezes precisar, sem consumir créditos.
- Configurar seu agente desde o primeiro dia, mesmo antes de conectar seu primeiro canal.
Antes de começar
Requisitos:
✓ Ter o Agente IA configurado
💡 Observação importante: você não precisa ativar nada. Se o Agente IA estiver configurado, o Playground já está disponível na tela de configuração. As conversas do Playground não consomem créditos da sua assinatura.
Atenção: as conversas do Playground são isoladas, mas a configuração não. O Playground usa a mesma configuração do seu agente. Se o seu agente já estiver conectado a um canal, as alterações que você salvar também se aplicam às conversas com seus clientes.
Como usar o Playground passo a passo
Passo 1 — Acessar a configuração do agente
No menu lateral, acesse Assistência IA → Agente IA.
Passo 2 — Localizar o Playground
O Playground aparece como um chat integrado à tela de configuração do agente.
Passo 3 — Escrever como se você fosse um cliente
Digite no chat uma pergunta real, como um cliente faria. Por exemplo: “Vocês têm este tênis no tamanho 40?”
Passo 4 — Ajustar e testar de novo
Se a resposta não for a esperada, altere a configuração do agente e digite a pergunta novamente. Use o botão de reiniciar conversa para começar do zero e testar com um contexto limpo.
💡 Importante: se o seu agente já atende clientes em um canal conectado, as alterações que você salvar se aplicam imediatamente a essas conversas.
Como funciona na prática
Playground vs. canal conectado
| Playground | Canal conectado | |
|---|---|---|
| Quem conversa com o agente? | Você, como cliente simulado | Seus clientes reais |
| Precisa de um canal conectado? | Não | Sim |
| Consome créditos? | Não | Sim |
| É possível reiniciar a conversa? | Sim, com um botão | Não |
| Para que é usado? | Testar e ajustar | Atender clientes |
O que muda entre os dois são as conversas, não a configuração: o agente é o mesmo nos dois casos.
O que testar primeiro
Comece pelos cenários mais frequentes do seu negócio:
| Cenário | O que validar | Exemplo de pergunta |
|---|---|---|
| Estoque e variações | Que o agente identifique corretamente tamanhos, cores e modelos | “Tem a camiseta preta no tamanho M?” |
| Políticas de devolução | Que as instruções sejam precisas e o tom, empático | “Chegou um produto com defeito, como faço a devolução?” |
| Promoções vigentes | Que o agente aplique corretamente os descontos | “Tem desconto pagando no Pix?” |
| Informações que o agente não tem | Que ele não invente dados e ofereça uma alternativa | “Vocês fazem envio para outro país?” |
Boas práticas
1. Escreva como seus clientes escrevem. Use mensagens curtas, informais e com erros de digitação. Se você testar apenas com perguntas perfeitas, não saberá como o agente responde em uma conversa real.
2. Reinicie a conversa entre os testes. O agente leva em conta as mensagens anteriores. Se você testar um cenário novo sem reiniciar, o resultado pode ser influenciado pelo teste anterior.
3. Mude uma coisa de cada vez. Se você alterar o tom e as instruções ao mesmo tempo, não saberá qual das mudanças melhorou ou piorou a resposta.
4. Se o seu agente já está em produção, faça mudanças pequenas. Como a configuração é a mesma, cada alteração que você salvar chega aos seus clientes. Prefira ajustes pontuais e verifique-os no Playground logo em seguida.
5. Teste de novo depois de cada treinamento. Sempre que você carregar novas URLs ou arquivos, verifique no Playground se o agente usa as informações novas.
6. Valide antes de conectar o canal. Revise pelo menos os cenários da tabela “O que testar primeiro” antes que o agente atenda clientes reais.
Problemas comuns e soluções
1. Não vejo o Playground na tela de configuração
Causa possível: o Agente IA não está configurado.
Solução: conclua a configuração do agente em Assistência IA → Agente IA. O Playground aparece quando o agente está configurado.
2. O agente responde com informações desatualizadas ou incorretas
Causa possível: as informações não estão carregadas nas fontes de conhecimento.
Solução: revise as URLs e os arquivos com os quais você treinou o agente e atualize o que for necessário. Depois, teste novamente no Playground.
3. As respostas parecem influenciadas por testes anteriores
Causa possível: a conversa mantém o contexto das mensagens anteriores.
Solução: clique no botão de reiniciar conversa e teste novamente.
Perguntas frequentes
As alterações que testo no Playground se aplicam ao meu agente?
Sim. O Playground testa a configuração atual do seu agente. Se o seu agente já estiver conectado a um canal, as alterações que você salvar também se aplicam às conversas com seus clientes. Faça os ajustes com cuidado e valide cada alteração no Playground.
As conversas do Playground consomem créditos?
Não. Você pode usar o Playground quantas vezes precisar sem consumir créditos da sua assinatura.
Meus clientes podem ver as conversas do Playground?
Não. As conversas do Playground são isoladas: só você as vê.
Preciso conectar um canal para usar o Playground?
Não. Você pode configurar e testar o agente antes de conectar WhatsApp, Instagram ou Messenger.
Preciso ativar o Playground?
Não. Ele fica disponível automaticamente para todos os usuários que têm o Agente IA configurado.
Posso começar um teste do zero?
Sim. Use o botão de reiniciar conversa para apagar o contexto e começar de novo.
