Aqui você tem o glossário completo de termos do Cortex. Este guia está organizado por categorias para facilitar a compreensão de todos os elementos, conceitos e ferramentas que compõem a construção, configuração e execução de seus agentes conversacionais com inteligência artificial.
🏗️ Estrutura do fluxo
Termo | O que é |
Cortex | O produto onde são construídos os agentes conversacionais. |
Fluxo Cortex | O conjunto completo que é montado na tela: todos os seus nós, ramos e configuração. É a unidade que é publicada e que o Flowbuilder invoca. |
Tela | A superfície visual onde são compostos os nós do fluxo. |
Nó Cortex | Um momento da conversa com seu próprio prompt, ferramentas e base de conhecimento. Recebe a mensagem do cliente, raciocina com um LLM e responde ou transfere para outro nó. |
Nó Início | Ponto de entrada obrigatório e único do fluxo. Não é configurado, não é eliminado nem é duplicado. |
Nó Fim | Ponto de encerramento da conversa. Cada um tem um ramo de finalização e é exposto como saída no Flowbuilder. |
Ramo de condição | Conexão entre dois nós com uma condição escrita em linguagem natural. O LLM avalia em runtime se é apropriado seguir por ela. |
Ramo de finalização | Rótulo do Nó Fim que identifica o cenário de saída (por exemplo "Consulta agendada"). |
Fluxo multi-nó | Fluxo com mais de um Nó Cortex, onde a conversa é transferida entre nós especializados. |
⚙️ Configuração
Termo | O que é |
Configuração Global | Painel lateral onde são definidos os parâmetros que se aplicam a todo o fluxo: instruções gerais, etapas, campos, tipificações, rótulos e fuso horário. |
Prompt | As instruções do Nó Cortex: que papel desempenha, o que pode fazer e como deve responder. Nos FRDs aparece como "Conversation Goal" ou "Instruções do agente". |
Campo de salvamento | Dado estruturado que o nó captura durante a conversa (nome, email, produto de interesse). É referenciado no prompt digitando |
Etapa do funil | Ponto do funil comercial ao qual a conversa chegou. É classificada automaticamente de acordo com uma condição em linguagem natural. |
Tipificação | Classificação do estado de progresso da autogestão. Não encerra a conversa nem gera saídas. Existe apenas o tipo acompanhamento. |
Rótulo | Característica do cliente ou da conversa, acumulável sem limite. Serve para segmentação e relatórios. |
Builder | A pessoa que constrói e configura o fluxo. |
🧠 Conhecimento e ferramentas
Termo | O que é |
Base de conhecimento | Documentos carregados no nó que são consultados com RAG para responder perguntas. Para informações que não mudam frequentemente. |
RAG | Geração aumentada por recuperação. O sistema busca os fragmentos relevantes dos documentos e os injeta no contexto antes de o LLM responder. |
Chunk | Fragmento em que um documento é dividido para busca. O que é recuperado e passado ao LLM são chunks, não o documento inteiro. |
Tabela dinâmica | Fonte de dados estruturados conectada a uma API ou ao Google Sheets. Para informações que mudam: estoque, preços, disponibilidade. |
Aplicação externa | Serviço de terceiros conectado por OAuth (Slack, Gmail, Google Calendar, HubSpot) cujas ações o nó pode executar. Nos FRDs aparece como "ferramentas do Composio". |
HTTP Request | Chamada configurável para uma API externa, com variáveis do fluxo na URL, headers e body. |
Code Tool | Script JavaScript que é executado em um ambiente isolado, para lógica de negócios própria: cálculos, validações, transformações. |
MCP Server | Servidor externo que expõe um conjunto de ferramentas através do protocolo MCP. O LLM decide qual invocar de acordo com o contexto. |
Variável de ambiente | Valor salvo no nível do workspace (tokens, URLs base) que é referenciado com |
⚡ Runtime
Termo | O que é |
Runtime | O momento em que o fluxo está sendo executado com um cliente real, diferentemente do momento de configuração. |
Turno | Uma troca: mensagem do cliente e resposta do nó. |
Thread | A conversa completa com um cliente, do primeiro mensagem até o encerramento. |
Handoff | Transferência da conversa de um Nó Cortex para outro. Inclui uma razão que justifica a transferência. |
LLM-as-judge | Modelo leve que avalia a conversa contra uma condição e retorna um veredicto. É usado para tipificações, rótulos, etapas, detecção de spam e critérios de avaliação. |
Recuperação | Mensagem automática que tenta reengajar um cliente que parou de responder, usando o contexto do que estava sendo discutido. |
Saída operativa | Saída padrão do nó no Flowbuilder que não depende dos Nós Fim: atribuição a humano, erro de contexto, inatividade, spam detectado. |
🧪 Teste e publicação
Termo | O que é |
Rascunho | A versão que está sendo editada. É a que o simulador usa. |
Publicado | A versão que roda em produção quando o Flowbuilder invoca o fluxo. |
Simulador | Chat incorporado para testar o fluxo manualmente sem expô-lo aos clientes. |
Avaliação multi-turno | Teste automatizado que executa muitas conversas e as avalia de acordo com critérios definidos. Pode usar conversas simuladas ou tráfego real. |
Personalidade | Perfil de cliente simulado que a IA usa para gerar as mensagens do usuário durante uma avaliação (educado, frustrado, apressado). |
Critério | Dimensão de qualidade que é medida em uma avaliação (alucinações, relevância, escolha de ferramentas). Pode ser numérico ou passou/não passou. |
Fale a mesma língua que sua IA! 🚀
Use este glossário como seu manual de referência para dominar todos os conceitos do Cortex. Entender esses termos é o primeiro passo para desenhar, configurar e escalar agentes conversacionais verdadeiramente inteligentes. ✅