Passar para o conteúdo principal

🧠 O Nó Cortex e seu painel de configuração

Descubra tudo sobre o Nó Cortex e seu painel de configuração. Aprenda como o bloco principal do seu fluxo recebe mensagens, raciocina com Inteligência Artificial e toma as decisões corretas em cada etapa da conversa. 🚀

É o bloco principal do fluxo; recebe a mensagem do cliente, raciocina usando um modelo de linguagem (LLM), consulta o que precisa e responde ou transfere a conversa para o nó apropriado.

🏁 O Nó Início

Todo novo fluxo é criado automaticamente com um Nó Início. É o ponto de entrada obrigatório do cliente e existe exatamente um por cada fluxo.

Características principais:

  • Intocável: Não pode ser eliminado nem duplicado.

  • Sem configuração: Ao selecioná-lo, nenhum painel de propriedades se abre à direita.

  • Saída única: Tem um único conector (handle) de saída.

  • Ação rápida: Seu botão "+" cria e conecta diretamente seu primeiro Nó Cortex à tela.


🤖 O Nó Cortex

É aqui que você realmente define o comportamento do seu assistente. Cada Nó Cortex representa um "momento" específico da conversa, com um papel e objetivo únicos.


🗂️ O que é configurado no nó

Campo

Obrigatório

Descrição

Instruções do nó

Sim

O prompt. É um texto longo que define o papel da IA, seu alcance e como deve se comportar naquele momento.

LLM

Sim

O modelo de inteligência artificial que executa o nó. Você pode escolher entre modelos de Gemini, OpenAI e outras opções mais econômicas conforme sua necessidade.

Ferramentas

Não

Aplicações externas, requisições HTTP, Code Tools e MCP Servers aos quais o nó pode acessar.

Bases de Conhecimento

Não

Documentos estáticos (RAG) e tabelas dinâmicas que o nó pode consultar para encontrar respostas.

Salvamento de Campos

Não

Dados estruturados que o nó deve capturar durante a conversa (ex. email, nome).

👁️ Indicadores visuais (Badges)

Para que você não tenha que abrir o painel constantemente, o nó mostra badges (pequenas etiquetas visuais) com a quantidade de ferramentas, bases de conhecimento e campos que você configurou.

🚨 Importante: Se um nó não tiver o prompt (Instruções), aparecerá um badge de erro em cor vermelha no canto inferior direito. Um fluxo com um nó sem prompt não pode ser compilado nem publicado.


🔀 Como o nó decide para onde transferir?

Diferentemente dos fluxos tradicionais, aqui você não precisa criar nós intermediários cheios de regras. Cada Nó Cortex conhece automaticamente as condições de roteamento dos nós conectados a ele (tanto seus nós "irmãos" quanto "filhos").

Quando o nó detecta que a solicitação do cliente sai de seu alcance e não consegue resolvê-la, transfere a conversa de forma inteligente para o nó que corresponde de acordo com as condições lidas.

  • Regra de Fallback (Retorno): Se o nó não encontrar um irmão para rotear, ou simplesmente não tem irmãos conectados, a conversa volta automaticamente para o nó "pai".

  • Rastreabilidade: Cada transferência interna inclui um campo chamado Razão, o qual justifica por que a IA decidiu fazer a transferência. Isso fica gravado para que você possa auditá-lo depois.

💡 Dica de ouro: Essa capacidade é a que evita que um cliente fique preso em um nó inadequado. Seu sucesso depende diretamente de quão bem escritas estejam as condições de seus ramos em linguagem natural.


🎛️ O painel de configuração

O painel lateral direito é dinâmico: sempre mostra a configuração do elemento que você tem selecionado na tela. Seu conteúdo mudará automaticamente ao clicar em diferentes partes de seu fluxo.

O que está selecionado na tela

O que o painel direito mostra

Um Nó Cortex

Três abas (tabs): Geral, Base de Conhecimento e Ferramentas.

Um Nó Fim

O campo para escrever o ramo de finalização (saída operativa).

Um ramo (linha conectora)

A configuração de sua condição em linguagem natural.


🛠️ Execução de ferramentas

O Nó Cortex é completamente autônomo. Pode executar ações em serviços externos diretamente de sua própria configuração, sem necessidade de enviar a informação para nós intermediários. O modelo de IA (LLM) é quem decide quando e como invocar cada ferramenta baseando-se no contexto atual da conversa e na descrição que você deu àquela ferramenta.


Domine o cérebro do seu fluxo! 🚀

Entender a anatomia e configuração do Nó Cortex permite que você crie agentes modulares, dando a cada etapa da conversa as instruções e ferramentas exatas que precisa para oferecer um atendimento fluido e sem atritos. ✅

Respondeu à sua pergunta?