Playground de Chat #

O que é o Try Out? #

Experimentar é o ambiente de teste seguro onde você testa e refina as respostas do seu agente de IA sem afetar as conversas reais. Nada do que você faz no Experimentar envia uma mensagem para um contato real ou altera qualquer chat ativo.

Pense nisso como uma sala de prática para o seu agente de IA. Você digita mensagens como se fosse um contato, vê como o agente responde, ajusta suas instruções logo ao lado do chat e tenta novamente — tudo sem nenhum risco. As instruções que você salva aqui se tornam um rascunho: o chat de Teste (Try Out) as utiliza imediatamente, mas as conversas reais continuam sendo executadas com a sua última configuração publicada até que você clique em Publicar para o ambiente ativo na barra âmbar no topo do editor. Reescritas produzidas pelo Otimizar com IA ou por um feedback negativo (polegar para baixo) funcionam da mesma maneira — teste o rascunho aqui, publique-o quando estiver satisfeito (veja Otimizar com IA abaixo).

O Try Out aparece em três lugares, e todos eles são o mesmo chat de teste subjacente:

• Dentro de um Agente de IA, como a aba Experimentar — é aqui que a maioria das contas realiza testes.
• Dentro do assistente de integração guiada, como a etapa Testar e Ajustar, para que você possa conversar com seu novo agente antes que ele entre em operação pela primeira vez.

Acessando o Try Out #

A partir de um Agente de IA #

1. Abra Agentes de IA na barra lateral, em Estúdio de IA.
2. Clique no Agente que você deseja testar.
3. Clique na aba Experimentar.

O chat de teste abre imediatamente e é executado no próprio Agente. Não há nada para anexar e nada para configurar primeiro — um Agente novo pode ser testado no momento em que você escreve sua primeira instrução. Cada Agente mantém sua própria conversa de teste, portanto, testar um Agente nunca aparece no tópico de outro, e duplicar um Agente dá à cópia seu próprio tópico limpo.

Sua conversa de teste anterior pode parecer vazia a partir de 15 de agosto de 2026. As conversas de teste agora ficam no próprio Agente, portanto, um tópico em que você estava participando antes dessa data não é transferido e o Experimentar inicia você do zero. Nada mais muda: suas instruções, perguntas frequentes, conhecimento e mídia permanecem intocados, e otimizar seu Agente a partir de um feedback negativo que você deu em uma resposta anterior ainda funciona exatamente como antes. Basta enviar sua mensagem de teste novamente para continuar de onde parou.

A partir de um chat ao vivo (o loop de reprodução) #

A maneira mais rápida de corrigir uma conversa que não saiu como esperado é reproduzi-la no Teste (Try Out), ajustar seu agente e ver a correção ser aplicada imediatamente. Veja “Corrigindo um Chat ao Vivo com o Teste” abaixo.

Corrigindo um Chat ao Vivo com o Teste (Loop de Reprodução) #

Quando uma conversa real não sai como esperado, reproduza-a, ajuste seu agente e confirme a correção — tudo em um único ciclo:

1. Abra o chat que apresentou problemas em Chats.
2. Clique no menu de três pontos no canto superior direito do cabeçalho da conversa.
3. Selecione Testar no Playground. Você será levado diretamente para o Teste (Try Out) do agente que gerencia esse chat, com a conversa real copiada para o tópico de teste para que você possa reproduzi-la exatamente de onde parou.
4. Role até a resposta da IA que deu errado (ou reproduza-a como sua primeira mensagem de teste).
5. Clique no ícone de polegar para baixo abaixo dessa resposta. Isso abrirá a caixa de diálogo de feedback que você usará para corrigi-la.
6. Descreva o que estava errado ou edite as instruções diretamente no painel ao lado do chat — o mesmo painel abordado abaixo.
7. Envie a mesma mensagem de teste novamente (ou use o ícone de reiniciar a partir daqui em sua própria mensagem, descrito abaixo) para ver a nova resposta do agente com as instruções atualizadas. Ajuste e teste novamente quantas vezes precisar.
8. Assim que a resposta parecer correta, clique em Salvar no painel de instruções e, em seguida, em Publicar para o ambiente ativo na barra âmbar no topo do editor — o próximo contato real que fizer a mesma pergunta receberá a resposta corrigida.

Nota sobre salvar: o painel de instruções grava no mesmo local que a etapa dedicada de Instruções de IA do editor, portanto, o painel e essa etapa nunca podem divergir — salvar aqui é salvar lá. Os salvamentos são feitos como rascunho: o chat de Teste (Try Out) utiliza o rascunho imediatamente, e as conversas reais só mudam quando você publica. A conversa de teste em si (as mensagens que você digita como o contato fictício) sempre permanece local no Teste (Try Out) e nunca é enviada para um contato real — apenas as instruções que você salva e publica explicitamente são compartilhadas.

Testando Respostas do Bot #

Uma vez no Teste (Try Out):

1. Digite uma mensagem de teste no compositor, como se você fosse o contato fazendo uma pergunta.
2. A IA gera uma resposta com base na configuração atual do seu agente.
3. Revise a resposta para ver se ela atende às suas expectativas. Qualquer link que a IA incluir é clicável e abre em uma nova guia, para que você possa verificar se ele leva para onde deveria.

Envie várias mensagens de teste para simular uma conversa inteira. Isso ajuda você a verificar como o agente lida com:

• Perguntas comuns dos clientes — “Qual é o seu horário de funcionamento?” “Quanto custa?”
• Solicitações de agendamento — “Gostaria de agendar uma consulta para a próxima semana.”
• Casos extremos — “Posso obter um reembolso?” ou solicitações incomuns que seus contatos possam enviar.
• Cenários de transferência — situações em que o bot deve reconhecer que não pode ajudar e alertar um membro da equipe humana.

Dica: Não teste apenas as perguntas óbvias. Tente erros de digitação, solicitações vagas e mensagens fora do tópico para ver como seu agente lida com elas. Contatos reais raramente fazem perguntas perfeitamente formuladas.

O Painel de Instruções #

Ao lado do chat de teste, um painel mostra as instruções de IA do seu agente — os mesmos campos da etapa de Instruções de IA do editor — para que você possa ajustar o manual e testar novamente de imediato, sem precisar trocar de página.

• O modo de campos mostra cada seção de instrução (persona e objetivo, contexto de negócios, comportamento na conversa, escalonamento, etc.) como sua própria caixa editável.
• Editar como texto alterna para um editor de texto simples para todo o manual, para edições em massa mais rápidas — volte para Editar como campos a qualquer momento.
• Salvar só se torna ativo depois que você realmente altera algo, e salva a alteração como um rascunho, conforme explicado acima — publique quando as respostas parecerem corretas.
• Ocultar instruções recolhe o painel para que o chat de teste ocupe toda a largura — útil quando você está apenas passando por mensagens de teste e não precisa editar nada.

FAQs, mídia e o restante da configuração de um agente residem em suas próprias etapas dedicadas (FAQs e Conhecimento, Mídia e assim por diante) em vez de dentro do próprio painel de Teste — edite-os lá, depois volte ao Teste e reenvie sua mensagem de teste para ver a alteração refletida.

A mídia é reproduzida diretamente no Try Out. Quando o bot decide enviar um item da Biblioteca de Mídia durante uma conversa de teste, a imagem, vídeo, áudio ou documento aparece no chat de teste exatamente como o contato o receberia (junto com uma pequena nota da ferramenta “Enviou a mídia ‘…’”). Nenhuma mensagem real sai da sua conta. Uma peculiaridade do sandbox: as visualizações em conversas de teste antigas expiram após 7 dias e exibem uma pequena nota de “visualização expirada” — peça ao bot novamente para ver o arquivo atualizado.

Fazendo Melhorias em Tempo Real #

O verdadeiro poder do Teste (Try Out) é o seu ciclo de teste e melhoria:

1. Envie uma mensagem de teste e leia a resposta da IA.
2. Identifique um problema — talvez o tom esteja formal demais, a resposta esteja incompleta ou o agente não saiba sobre seu novo serviço.
3. Edite as instruções no painel ao lado do chat (ou o FAQ, na etapa de FAQs e Conhecimento).
4. Envie a mesma mensagem de teste novamente e veja como a resposta melhora.
5. Repita até que a resposta seja exatamente o que você deseja.

Exemplo: Você pergunta “Vocês oferecem frete grátis?” e o agente responde “Não tenho certeza sobre os detalhes de envio.” Você adiciona uma entrada no FAQ: “P: Vocês oferecem frete grátis? R: Sim, oferecemos frete grátis em pedidos acima de $50.” Envie a mesma pergunta novamente e o agente dará a resposta correta.

Testando vários cenários após uma edição #

O recurso Experimentar executa uma conversa por vez. Não existe um conjunto salvo de conversas de teste que seja reexecutado com um clique após você alterar as instruções, e a plataforma não avisa por conta própria quando uma edição piora as respostas. Mantenha uma lista curta dos cenários que são importantes para você (saudação, objeção de preço, entrega, agendamento) e repita cada um antes de clicar em Publicar ao vivo. O ícone de lápis em uma mensagem de teste (abaixo) retrocede até aquele ponto, permitindo que uma etapa seja reexecutada sem precisar redigitar o chat, e o Histórico de versões no editor do agente restaura uma versão publicada anteriormente como rascunho caso uma alteração tenha resultado em um desempenho pior. Para conversas ao vivo, uma queda na qualidade aparece em seus Resumos Diários.

Ações por Mensagem #

Enquanto o agente está ocioso (não está gerando uma resposta no momento), cada mensagem no tópico de teste mostra suas ações ao lado — não é necessário passar o mouse:

• Nas suas próprias mensagens (de teste): um lápis para editar — isso retrocede a conversa para antes dessa mensagem e carrega o texto de volta no compositor para você alterar e reenviar — um ícone de seta para reiniciar a partir daqui, que reenvia a mesma mensagem literalmente para uma nova resposta da IA, e um ícone de lixeira para excluir essa mensagem junto com a resposta da IA a ela (para que você nunca fique com uma resposta para uma pergunta que não existe mais).
• Nas respostas do agente: um ícone de feedback negativo abre a caixa de diálogo de feedback descrita no loop de repetição acima, para que você possa sinalizar uma resposta ruim e corrigir a instrução que a causou. Funciona em qualquer Agente que você possa testar — não há nada para conectar primeiro — e a reescrita que ele produz chega como um rascunho que você revisa e publica, da mesma forma que o Otimizar com IA abaixo.

Use Recomeçar, no cabeçalho do painel de chat, para redefinir toda a conversa de teste e começar do zero.

Iniciando a Conversa #

O Teste começa com você: digite sua primeira mensagem de teste como o testador e o agente a responderá. Não há opção “fazer a IA abrir” aqui, porque uma mensagem de abertura pertence à Transmissão que a envia, não ao Agente — o editor do Agente não tem uma etapa de mensagem de abertura para testar.

Exportando o Chat de Teste #

Clique em Exportar chat no cabeçalho do painel de chat para baixar a conversa de teste como um arquivo de texto. O arquivo usa o mesmo layout de uma exportação de chat do WhatsApp, uma linha por mensagem com a data, hora e remetente:

27/09/2026, 14:05 - Contact: What are your opening hours on Saturday?
27/09/2026, 14:05 - AI: We're open from 9:00 to 17:00 on Saturdays.
27/09/2026, 14:06 - [Action] AI alerted a human

Suas mensagens são rotuladas como Contato e as respostas do agente como IA. A exportação também inclui as ações do agente, como alertar um humano, encerrar o chat, agendar um acompanhamento ou chamar uma função, cada uma em sua própria linha [Ação] com a mesma redação que você vê no chat de teste, para que qualquer pessoa (ou qualquer IA) lendo o arquivo possa dizer se o agente transferiu a conversa. Um arquivo ou imagem que a IA enviou aparece como <Media omitted>. O botão fica cinza até que a conversa tenha pelo menos uma mensagem. Útil para compartilhar um teste com um colega ou para manter um registro de antes e depois ao alterar as instruções do agente.

Editando o Contato de Teste #

Clique em Editar Contato no cabeçalho do painel de chat para abrir os detalhes do contato de teste — nome, e-mail, telefone, tags e notas. Como a IA lê os campos de um contato ao responder, editá-los aqui é a forma de testar a personalização: dê ao contato de teste um nome e uma tag, depois faça uma pergunta que dependa disso e confirme se a resposta do agente captura isso corretamente.

Otimizar com IA #

Além do polegar para baixo por resposta, clique em Otimizar com IA no cabeçalho do painel de chat a qualquer momento para abrir a mesma ferramenta de reescrita sem precisar apontar para uma resposta ruim específica — útil quando você deseja melhorar o tom ou a cobertura de forma geral, em vez de corrigir uma resposta exata.

O botão está lá em todo Agente, sem nada para configurar primeiro: um novinho em folha, uma cópia que você acabou de duplicar ou um que chegou na sua conta já pronto. Descreva o que deve mudar e você terá a mesma revisão lado a lado de antes — cada edição proposta é mostrada como está agora em comparação com o que a IA sugere, com adições, edições e remoções de FAQ listadas separadamente, e nada é aplicado a menos que você aceite.

O feedback sobre como o Agente envia, não apenas o que ele diz, altera a configuração de correspondência em vez de adicionar uma regra. “Responder apenas em uma mensagem” define Máximo de mensagens por resposta como 1 (e ativa Impor máximo de mensagens), “responder mais rápido” reduz o Tempo de espera mínimo e o Tempo de espera máximo, “não responder após as 18h” ajusta o Horário de funcionamento, e uma solicitação de menos respostas de IA por chat altera o Máximo de mensagens de IA por chat. Cada configuração que é alterada aparece como sua própria linha na mesma revisão, com o valor atual de um lado e o proposto do outro, para que você possa aceitar ou rejeitar exatamente como uma alteração de texto. Os valores que ele pode definir são os mesmos que você mesmo pode inserir nas guias Configurações do Bot e Horário de funcionamento do Agente. A redação, o tom e a duração das respostas permanecem no texto do playbook.

O que você aceita é salvo como um rascunho no Agente para você revisar: o chat de Teste começa a usá-lo imediatamente para que você possa testar a reescrita, enquanto suas conversas ativas continuam inalteradas. Quando as respostas parecerem corretas, clique em Publicar para ativo no banner âmbar na parte superior do editor do Agente — ou Descartar para abandonar a reescrita e voltar ao que você tinha. Veja Agentes de IA.

Casos de Uso #

Corrigindo Respostas Incorretas do Bot #

Um contato lhe disse que o bot forneceu informações erradas sobre seus preços. Abra o chat desse contato, use Testar no Playground, digite a mesma pergunta e veja o que o agente diz. Em seguida, atualize o FAQ com o preço correto, retorne ao Testar e teste novamente.

Adicionando uma Nova Promoção #

Você acabou de lançar uma promoção de feriado e quer que o agente a mencione. Adicione a promoção à seção relevante de suas instruções (por exemplo, “Estamos com uma promoção de feriado de 20% até 31 de dezembro”). Teste algumas perguntas como “Existem ofertas atuais?” e verifique se o agente menciona a promoção naturalmente. Salve quando parecer correto.

Preparando-se para um Novo Serviço #

Sua empresa adicionará um novo serviço no próximo mês. Antes que os contatos comecem a perguntar sobre isso, adicione entradas de FAQ que cubram perguntas comuns (preço, disponibilidade, o que está incluído). Teste várias maneiras pelas quais os contatos podem perguntar sobre isso e confirme se o agente responde com precisão.

Testando antes de entrar em produção #

Antes de ativar um agente para contatos reais (ou iniciar uma transmissão), use o recurso Experimentar para percorrer toda a experiência que um contato teria — desde a mensagem inicial até fazer perguntas, agendar um compromisso e lidar com solicitações incomuns. Isso detecta problemas antes que contatos reais os encontrem.

Testando um Agente a partir da API ou de um Assistente de IA #

Você pode executar a mesma conversa de Teste sem abrir o aplicativo, através da API ou de um assistente de IA conectado via MCP (por exemplo, o Claude):

1. Envie uma mensagem de teste (send_agent_try_out_message, POST /v1/agents/{agentId}/try-out/test-message) com o que o cliente de teste diz.
2. Aguarde alguns segundos e, em seguida, leia a conversa (get_agent_try_out_messages, GET /v1/agents/{agentId}/try-out/messages). A resposta chega por conta própria após uma breve pausa; enquanto agent_responding for verdadeiro, o agente ainda está trabalhando nela.
3. Recomece com reset_agent_try_out (POST /v1/agents/{agentId}/try-out/reset), o mesmo que Reiniciar no aplicativo. Para agentes que escrevem primeiro, start_agent_try_out inicia a mensagem de abertura.

Cada entrada na conversa é uma mensagem (do testador ou do agente) ou uma ação que o agente executou: um alerta humano, encerramento do chat, um acompanhamento, um agendamento ou uma de suas funções personalizadas. As ações mostram o nome da ferramenta e se ela funcionou, para que você possa verificar o comportamento do agente, não apenas suas palavras.

Mensagens de teste enviadas através da API ou de um assistente de IA usam créditos na taxa normal de resposta de IA. Testar no aplicativo permanece gratuito.

Agências: conecte-se com a chave de API da conta da sua agência e passe sub_account_id para testar o agente de um cliente diretamente, sem copiá-lo para sua própria conta. A chave da conta de um cliente só alcança aquele cliente específico.

Dicas para testes eficazes #

• Teste uma variedade de perguntas — vá além do óbvio. Experimente casos extremos, erros de digitação e solicitações inesperadas.
• Simule conversas com várias mensagens — contatos reais geralmente enviam várias mensagens seguidas antes que o bot responda. Teste como o agente lida com sequências de mensagens.
• Verifique o tom e a formatação — certifique-se de que as respostas soem naturais e correspondam à voz da sua marca.
• Verifique links e recursos — se o agente compartilhar links, confirme se estão corretos e funcionando.
• Teste no idioma do contato — se o seu agente oferecer suporte a vários idiomas, teste perguntas em cada um deles.
• Mantenha notas sobre o que você alterou — se você fizer vários ajustes em uma sessão, anote o que mudou para que possa desfazer algo específico, se necessário.

Precisa de ajuda? #

Se você tiver dúvidas sobre o Try Out ou precisar de ajuda para otimizar seu agente de IA, entre em contato através do nosso suporte por e-mail.