Testar e publicar
Como testar o Bot de atendimento com simulação segura, entender por que o bot respondeu assim, rodar a suíte de cenários, publicar versões e voltar a uma versão anterior
Antes de colocar uma mudança no ar, você pode testar o bot conversando com ele como se fosse o cliente. Quando estiver satisfeito, publique uma versão — e, se algo der errado, volte a uma versão anterior.
Testar
Clique em Testar, no cabeçalho do construtor, para abrir o painel de teste ao lado da configuração. Ele tem duas abas: Conversa e Suíte de cenários.
O teste é uma simulação: nada é enviado a clientes reais. O bot usa o mesmo motor do atendimento, mas as bordas são simuladas — as mensagens aparecem só no painel, o chamado criado é fictício (numerado como #SIM-1, #SIM-2…) e não existe de verdade, e as ferramentas MCP devolvem um resultado simulado. A leitura da base de conhecimento e da memória é real, somente leitura: nada é gravado.
Cada mensagem testada consome a cota de IA da assinatura. Se a cota acabar, o teste não roda.
Conversar com o bot
Escolha o que testar
No seletor do topo do painel, escolha Rascunho (sua configuração atual, ainda não publicada) ou Publicado (a versão no ar). O rascunho precisa estar válido: erros de validação impedem o teste.
Defina o contexto (opcional)
Abra Contexto da simulação para ajustar o cenário:
| Campo | Para quê |
|---|---|
| Contato identificado pelo número | Simula um cliente já reconhecido ou desconhecido |
| Nome do contato | Nome usado na conversa (por exemplo, Carlos (cliente de teste)) |
| Data e hora simuladas | Testa o horário de atendimento e os feriados. Vazio = agora |
| Aprovações de ferramenta | Define o que acontece nas ferramentas que exigem aprovação: O atendente aprova, O atendente recusa ou Ninguém responde (expira) |
| Resultado das ferramentas MCP | Resposta simulada de cada ferramenta MCP |
Mudanças no contexto valem ao reiniciar a conversa.
Escreva como o cliente
Digite em Escreva como o cliente… e veja as respostas, os botões e a conversa no estilo WhatsApp. Use Reiniciar conversa para começar do zero.
Por que respondeu assim
Em cada resposta do bot, abra Por que respondeu assim para ver o que aconteceu por trás:
| Campo | O que mostra |
|---|---|
| Skill | A skill acionada (ou Nenhuma) |
| Fluxo | O caminho percorrido no fluxo |
| Fontes | As fontes da base de conhecimento citadas |
| Base | As buscas feitas na base e quantos trechos voltaram |
| Skills | As skills que o bot carregou ("Carregou a skill …") |
| Ferramentas | As ferramentas chamadas e o resultado (ou o erro) |
| Diretrizes | As diretrizes aplicadas |
| Regra | A regra de prioridade que decidiu o chamado |
| Lacuna | O que faltou para o bot resolver sozinho, quando houve |
Quando uma resposta vier diferente do esperado, Por que respondeu assim mostra se faltou uma skill, uma fonte na base ou uma diretriz.
Simular cenário
Um cenário é uma conversa de teste guardada, com critérios de sucesso. Para rodar um cenário no chat, escolha-o em Simular cenário…: as falas do cliente são enviadas ao bot e o resultado aparece como Cenário passou ou Cenário falhou, com o motivo.
Para criar um cenário, converse com o bot na aba Conversa e clique em Salvar como cenário: dê um nome (por exemplo, "Pod em CrashLoopBackOff abre chamado urgente") e as falas do cliente viram um teste que entra na suíte.
Suíte de cenários
A aba Suíte de cenários roda todos os cenários de uma vez, contra o rascunho ou a versão publicada, e mostra quais passaram e quais falharam.
- Clique em Rodar suíte (ou Rodar de novo).
- Cada cenário mostra o resultado e, quando falha, o Esperado, o Obtido e a Causa provável. Ver conversa exibe a transcrição e Abrir Fluxo de atendimento leva ao ponto a ajustar.
- Ao adotar um modelo de fluxo, os cenários do segmento chegam junto, prontos para uso.
Os critérios que um cenário pode verificar:
| Critério | Verifica |
|---|---|
| Skill usada | Que uma skill específica foi acionada |
| Ferramenta chamada / Ferramenta não chamada | Que uma ferramenta foi (ou não) usada |
| Transbordo | Que a conversa foi transferida para uma pessoa |
| Chamado aberto | Que o chamado foi criado |
| Prioridade | A prioridade calculada |
| Resposta contém / Resposta não contém | Que um texto aparece (ou não) nas respostas, sem diferenciar acentos e maiúsculas |
| Cita a fonte | Que a resposta se apoiou na base de conhecimento |
| Máximo de perguntas | Que o bot não fez mais perguntas do que o limite |
Limites: uma execução roda até 30 cenários, a organização pode ter 3 execuções ao mesmo tempo e os resultados são guardados por 7 dias.
A simulação ainda não cobre o atendimento multi-organização (identificação por e-mail e código) nem mídia (áudio e imagem).
Publicar
Quando o rascunho estiver pronto, clique em Publicar no cabeçalho. O botão só fica ativo quando há alterações a publicar (ou quando ainda não há versão no ar).
Revise o que muda
A janela Publicar vN mostra, em O que muda, as alterações do rascunho em relação à versão no ar, agrupadas por área. Lembre: as conversas novas passam a usar esta versão; as em andamento terminam na versão anterior.
Rode a suíte (recomendado)
A janela sugere rodar a suíte de cenários antes de publicar, com o botão Rodar suíte.
Escreva a nota da versão
Em Nota da versão (até 200 caracteres), descreva a mudança — por exemplo, "Diretriz de hostname e triagem com 4 perguntas". A nota aparece no histórico; o bot não a vê.
Publique
Clique em Publicar. Se houver problemas, a janela lista os erros que impedem a publicação (corrija e tente de novo) e os avisos (que não bloqueiam).
Se o fluxo estiver vazio, a janela oferece Aplicar fluxo padrão e Abrir fluxo. Se o rascunho mudou desde que você abriu a janela, ou se não há nada a publicar, o OpsScript avisa.
Só quem tem a permissão de publicar consegue publicar versões. Editar e publicar são permissões separadas — veja Quem pode usar.
Versões e rollback
A seção Versões reúne tudo o que mudou. Tudo o que você altera fica em rascunho até publicar, e dá para voltar a qualquer versão.
Rascunho
O cartão Rascunho vN mostra quantas alterações não foram publicadas e o que mudou em relação à versão no ar, por área (persona, diretrizes, skills, conhecimento, ferramentas, fluxo, horário, transbordo, prioridade, avaliação, janela de 24h e assistente do atendente). Mudar só a posição dos nós no desenho não conta como alteração.
Descartar rascunho apaga as alterações não publicadas e volta à versão no ar. A janela de confirmação avisa quantas alterações serão perdidas.
Histórico
O Histórico lista as versões publicadas, com a marca No ar na atual. Abra uma versão para ver a nota, a data de Publicada em, a Origem (Pela tela, Agente externo (MCP), IA de configuração ou Migração das instruções antigas) e o que mudou em relação à versão anterior.
Voltar a uma versão anterior (rollback)
Em uma versão anterior, clique em Restaurar. A configuração dela volta a ser publicada como uma nova versão e o rascunho atual é substituído. As conversas em andamento terminam na versão em que começaram.
Restaurar substitui o rascunho. Itens que estavam desligados quando aquela versão foi publicada (diretrizes, skills, ferramentas) não fazem parte dela e não voltam.
Auditoria
O painel Auditoria mostra as últimas alterações no rascunho, quem fez e como: uma pessoa, a IA de configuração ou um agente externo (MCP).
Confirmações pedidas por agentes externos
Quando um agente externo conectado por MCP tenta uma ação sensível (publicar, voltar versão, remover itens, substituir o fluxo ou as regras de prioridade), ele não executa sozinho: um aviso Um agente externo pediu confirmação aparece com as opções Confirmar e Recusar, para quem tem permissão de publicar. O pedido expira em 24 horas. Veja Configurar com IA e automação.
Próximos passos
Regras do atendimento
Como configurar no Bot de atendimento a abertura de chamados com prioridade, horário de atendimento, transbordo para uma pessoa, assistente do atendente, avaliação CSAT e retomada depois de 24 horas
Configurar com IA e automação
Como usar o Configurar com IA para montar o Bot de atendimento por conversa, revisar o plano item a item, aplicar no rascunho e configurar o bot por agentes externos via MCP