O prompt é o coração do seu agente; define o comportamento exato do Nó Cortex. É escrito no painel direito, pode ser expandido para um editor completo e conta com um assistente de IA que ajuda a gerar uma primeira versão estruturada.
📍 Onde escrever?
Para acessar o campo de instruções, o caminho é:
Canvas → Selecionar Nó Cortex → Painel direito → Aba (Tab) Geral → Objetivo da conversa.
📝 O editor de Prompts
Você tem duas formas de trabalhar com o texto das suas instruções, dependendo de quanto tempo seu prompt for.
1. Textarea inline (Painel lateral)
O campo diretamente no painel pode ser aumentado e diminuído verticalmente arrastando o handle (controle) do canto inferior direito.
Altura mínima: Aproximadamente 6 linhas.
Altura máxima: Aproximadamente 20 linhas (a partir daí, o scroll interno é habilitado).
Memória: O tamanho que você escolher é lembrado de forma independente para cada nó.
2. Modal de edição (Tela completa)
Como os prompts costumam ser longos, o painel lateral pode ficar desconfortável. O modal abre um editor grande e focado, que ocupa pelo menos 70% da altura da tela. Inclui realce de sintaxe para variáveis, contador de caracteres no rodapé e salvamento automático como rascunho a cada 30 segundos para evitar perda de dados.
Ação | Como realizá-la |
Abrir o modal | Clique no ícone de expandir (canto superior direito do campo) ou |
Buscar e substituir |
|
Salvar e fechar |
|
Fechar sem salvar | Tecla |
⚡ Inserir campos e ferramentas
Dentro do prompt, você conta com dois atalhos de teclado muito úteis que abrem menus filtráveis (você pode continuar digitando para reduzir a lista). Em runtime, essas referências são resolvidas automaticamente com o valor capturado ou a instrução da ferramenta.
Atalho | O que abre | O que insere no texto |
| Os campos de salvamento configurados no nó. | Uma referência ao campo, por exemplo: |
| As ferramentas (Tools) conectadas ao nó. | Uma referência à ferramenta, por exemplo: |
🏗️ Como estruturar o prompt
Um prompt desorganizado confunde a IA. A estrutura recomendada é dividida em sete seções claras:
Papel e objetivo: O que é o nó e para que existe.
Contexto: Informação chave do negócio, indústria, público e tom da marca.
Capacidades e ferramentas: O que pode fazer e com o que conta para conseguir.
Fluxo de conversa: Os passos ordenados a seguir (se aplicável) com suas respectivas condições.
Regras e restrições: O que NÃO fazer, limites operativos e políticas rigorosas.
Exemplos: Casos concretos de uma mensagem do cliente e a resposta exata esperada.
Formato de resposta: Como deve estruturar visualmente cada mensagem.
🏆 As 3 regras de ouro para um bom prompt
Essas três regras são as que mais impacto têm no resultado final:
Instruções concretas e verificáveis: "Responda em no máximo 3 frases" pode ser verificado pelo sistema; "Seja cordial" é muito subjetivo.
Pelo menos dois exemplos: Inclua exemplos claros para cada comportamento crítico ou saída.
Instruções positivas: "Faça uma pergunta por mensagem" funciona muito melhor para o LLM que "Não faça mais de uma pergunta por mensagem".
💡 Dica de Arquitetura: Se seu prompt ultrapassa 400 linhas, é muito provável que esse nó esteja tentando fazer muitas coisas ao mesmo tempo. Nesse caso, é melhor dividi-lo em vários nós especializados.
⚠️ Aviso de Configuração Global: O tom, o idioma e as regras que se aplicam a todo o fluxo devem ir na Configuração Global, NÃO no prompt de cada nó. Repeti-los aqui consome tokens desnecessários em todas as rodadas e obriga você a replicar cada mudança manualmente.
🪄 O Assistente de IA
Se você não sabe por onde começar, o Assistente de IA pega uma descrição simples em linguagem natural do que você precisa e gera um prompt estruturado seguindo todas as boas práticas.
Como usar (Passo a passo)
Clique no botão Assistente IA (acessível a partir do campo de instruções).
Escreva em linguagem natural o que o nó deve fazer (Ex. "Que atenda clientes de suporte técnico e escale com um humano se não conseguir resolver").
Revise o prompt gerado. O novo aparecerá marcado visualmente para se distinguir do que já estava escrito.
Aceite, edite manualmente, reverta ou regenere o texto dando instruções adicionais ao assistente.
O que o Assistente IA leva em conta?
O assistente é inteligente e usa o contexto do seu nó para gerar instruções precisas:
Ferramentas conectadas: Inclui instruções sobre quando e como usá-las, considerando seus inputs e formatos.
Campos de salvamento: Adiciona instruções automáticas para coletar esses dados.
Bases de conhecimento: Ajusta o prompt para que o nó as consulte quando apropriado.
Guardrails (Barreiras de segurança): Gera automaticamente restrições operativas, tópicos proibidos e diretrizes para evitar alucinações. Você pode indicar tópicos que o nó deve recusar e o Assistente IA os incluirá como regras explícitas.
Torne-se um arquiteto de IA! 🚀
Escrever bons prompts é o superpoder definitivo no Cortex. Use o editor em tela completa, conte com o Assistente de IA para estruturar suas ideias e siga as regras de ouro para conseguir que seus agentes respondam sempre com precisão e naturalidade. ✅