O sistema valida o fluxo em segundo plano de forma contínua e bloqueia a publicação quando encontra erros que quebrariam a execução.
⚙️ Como funciona a validação contínua
A validação é executada automaticamente em segundo plano, sem necessidade de ativação manual. Não há um botão de "Validar"! O resultado é atualizado em tempo real e se reflete em um botão flutuante localizado no canto inferior direito do canvas.
Estado do botão | Significado |
Azul | O fluxo é válido. Ao clicar, se compila e abre o simulador. |
Vermelho com badge | Há erros críticos. O badge (indicador numérico) mostra quantos. Ao clicar se desdobra a lista detalhada. |
Carregando | O sistema está compilando o fluxo neste instante. |
🚫 Erros que bloqueiam a compilação
Essas três regras estruturais impedem compilar o fluxo. Se não forem cumpridas, você não conseguirá simulá-lo nem publicá-lo.
Regra | O que valida | Mensagem de erro exibida |
V-01 | Todo Nó Cortex deve ter um prompt (Instruções). | "O nó '{etiqueta}' não tem um objetivo de conversa" |
V-02 | Todo ramo conectador deve ter uma expressão de condição. | "A condição '{etiqueta}' não tem expressão de condição" |
V-03 | Todo nó "folha" (o final do caminho) deve ser um Nó Fim. | "O nó '{etiqueta}' deve se conectar a um nó End" |
🚀 Validações exclusivas ao pressionar "Publicar"
Além das regras de compilação, ao tentar publicar seu agente, o sistema realiza verificações adicionais de segurança:
1. Nome do fluxo
O fluxo não pode ser publicado com o nome padrão nem com um nome de menos de 3 caracteres. O sistema pedirá: "Antes de publicar, dê um nome ao seu agente que o identifique claramente", e moverá o foco para o campo correspondente para que você o edite.
💡 Dica operacional: O motivo não é estético. Um fluxo chamado "Novo agente" é impossível de identificar depois na lista geral, nos relatórios de métricas e na rastreabilidade.
2. WhatsApp Flows sem configurar corretamente
A publicação é bloqueada se você ativou o formato de WhatsApp Flow mas não adicionou nenhum formulário à lista, ou se adicionou um Flow mas deixou sua "descrição de uso" vazia.
3. Referências quebradas em integrações
O sistema alertará e bloqueará a publicação se um MCP Server faz referência a uma variável de ambiente ou conexão de autenticação que não existe. O mesmo ocorre se um Code Tool tenta usar um campo de salvamento excluído. (Isso geralmente acontece ao importar um fluxo de outro workspace).
🔗 Validação do lado de Flowbuilder
Um fluxo Cortex pode estar impecável estruturalmente, mas ainda assim falhar em produção se o nó que o invoca de Flowbuilder estiver mal configurado.
Ao tentar publicar um flow completo em Flowbuilder, o sistema valida rigorosamente que todos os Nós Cortex tenham um agente selecionado, que esse agente exista e que esteja publicado. Se faltar algum, a publicação é bloqueada com o seguinte detalhe:
"Os seguintes nós não têm agente selecionado: {Nó A}, {Nó B}. Selecione um agente em cada um antes de publicar."
Cada item da lista terá um botão de "Ir ao nó" para localizá-lo rapidamente no canvas.
(Nota: Esta mesma validação ocorre ao "Salvar", mas apenas como um aviso não bloqueante, permitindo que você continue trabalhando).
💡 Importância: Sem essa validação cruzada, o erro só apareceria quando um cliente real tenta interagir, provocando a temida "falha silenciosa".
⚠️ Avisos que NÃO bloqueiam (mas você deve atender)
Esses avisos permitem que você continue trabalhando e publicando, mas ignorá-los é a causa mais frequente de comportamentos erráticos em sua Inteligência Artificial.
Aviso na tela | Por que importa corrigi-lo |
Condições de ramo com >80% de similaridade | O LLM se confundirá e transferirá para o nó errado de forma inconsistente. |
Ramos de finalização muito similares | A conversa se encerrará e será desviada pela saída operativa errada. |
Descrições de uso de WA Flows similares | O nó enviará um formulário que não corresponde à situação do cliente. |
Condição que referencia um campo inexistente | Essa condição nunca será cumprida, deixando uma parte do seu fluxo inacessível. |
Lance em produção com total tranquilidade! 🚀
As validações de Cortex atuam como sua rede de segurança pessoal, garantindo que seu fluxo esteja estruturalmente saudável, não quebre as regras dos canais e esteja perfeitamente conectado com Flowbuilder antes de o primeiro cliente dizer "Olá". ✅