Como rodar o pre-flight

Valide o bot com um checklist automático antes de colocá-lo em produção.

O que é o pre-flight

O pre-flight é um conjunto de testes automáticos que verifica se o bot está respondendo corretamente aos cenários mais importantes antes de uma nova versão ir ao ar. É como o checklist de um piloto antes de decolar: garante que tudo está em ordem antes de colocar passageiros a bordo.

O que você precisa

  • Uma suite de testes com pelo menos um caso de teste criado
  • Uma versão do bot publicada (ou em rascunho para validar antes de publicar)

Criando uma suite de testes

  1. Acesse Qualidade > Testes de Pre-flight
  2. Clique em Nova suite e dê um nome (ex: "Testes de lançamento v1")
  3. Adicione casos de teste clicando em Novo caso de teste
  4. Para cada caso, informe:
    • Pergunta ou mensagem — o que o usuário enviaria
    • Resultado esperado — o que o bot deve responder ou fazer
    • Tipo de teste — Resposta direta, Handoff, Ferramenta ou Baixa confiança
    • Crítico? — marque como crítico os testes que não podem falhar de jeito nenhum

Executando o pre-flight

  1. Abra a suite de testes
  2. Clique em Executar pre-flight
  3. O sistema vai testar cada caso automaticamente. Isso leva de alguns segundos a alguns minutos, dependendo do número de casos.
  4. Acompanhe o progresso na tela. Ao finalizar, o resultado geral aparece: Aprovado, Aprovado com avisos ou Bloqueado.

Interpretando o resultado

  • Aprovado — todos os testes passaram. O bot está pronto para produção.
  • Aprovado com avisos — alguns testes não-críticos falharam. Avalie se os avisos precisam ser corrigidos antes de ir ao ar.
  • Bloqueado — um ou mais testes críticos falharam. Corrija os problemas antes de publicar.

Quando rodar o pre-flight

  • Antes de publicar uma nova versão do bot
  • Após adicionar ou remover documentos da base de conhecimento
  • Após alterar a persona ou as instruções do bot
  • Após ativar ou desativar uma Custom Tool
  • Quando o Readiness estiver como Desatualizado (mais de 7 dias sem validação)