Como escrever instruções eficazes (guia de instruções)

O Mensagem do sistema campo no nó do Agente de IA em Nó latente define o papel, o comportamento e a tomada de decisões do agente. Essas instruções são escritas diretamente dentro do Mensagem do sistema seção nas configurações do agente. Este campo determina como o agente responde à entrada do usuário, quando chama ferramentas e como lida com ambiguidade ou dados ausentes.

Instruções estruturadas são essenciais para um comportamento previsível, útil e controlado dos agentes em áreas como suporte ao cliente, integração, automação, educação ou ferramentas internas. Isso é especialmente verdadeiro para agentes de IA criados e orquestrados em Nó latente, onde uma lógica de sistema clara é crucial para criar automações escaláveis.

Estrutura principal

On Nó latente, instruções eficazes geralmente consistem em seis blocos de construção:

1. Personalidade – Quem é o agente e como ele atua

2. Meio Ambiente – O contexto em que opera

3. Tom – O estilo de comunicação

4. Objetivo – O que o agente está tentando realizar

5. guardrails – O que o agente não deve fazer

6. Ferramentas – O que pode acessar e como

1. Personalidade

A personalidade do agente define sua identidade, atitude e traços comportamentais. Uma personalidade consistente faz com que as interações pareçam coerentes e intencionais.

Incluir:

• Nome e função

  Exemplo:

  “Você é Sarah, uma assistente de configuração paciente e experiente.”

• Traços essenciais

  Exemplo:

  “Você é empático, direto, curioso e sempre focado na clareza.”

• Âncoras de comportamento

  Exemplo:

  “Você reconhece as emoções do usuário brevemente e redireciona para soluções sem se demorar.”

• História de fundo (opcional)
  Inclua apenas se isso influenciar o comportamento do agente. Evite exageros.

**Exemplo – Personalidade expressiva:**
**

Você é John, um coach de bem-estar virtual e atencioso.
Você fala com calma e empatia, sempre validando as emoções do usuário.
Você os orienta em direção a técnicas de atenção plena ou afirmações positivas quando necessário.
Você é naturalmente intuitivo e atencioso.

2. Ambiente

Define o contexto situacional ou técnico em que o agente opera. Isso ajuda o agente a adaptar o tom, a verbosidade ou a estrutura do conteúdo.

Especificamos:

• Plataforma/canal (chat, aplicativo web, widget incorporado, etc.)

• Limitações (por exemplo, "você não pode ver a tela do usuário")

• Estado do usuário (por exemplo, "o usuário pode estar frustrado devido a falhas recentes")

Exemplo – Ambiente de suporte técnico:

Você está integrado ao widget de chat ao vivo de uma plataforma SaaS. Os usuários entram em contato com você enquanto usam o produto, frequentemente no meio de uma tarefa ou quando estão bloqueados. Você não tem acesso ao conteúdo da tela nem à telemetria. Considere que problemas técnicos são comuns e que os usuários podem estar estressados.

On Nó latenteOs agentes geralmente são executados dentro de fluxos de trabalho em tempo real, portanto, a descrição do seu ambiente deve refletir claramente esse contexto de automação.

3. Tom

O tom determina como o agente se comunica: o nível de formalidade, a escolha da linguagem, o ritmo e o ritmo linguístico.

Definir:

• Nível de formalidade e comprimento típico da frase

• Uso de afirmações ("Entendi", "Faz sentido")

• Se deve usar palavras de preenchimento, palavras de proteção, etc.

• Adaptar o tom ao estado emocional do usuário ou ao seu histórico técnico

Exemplo – Tom de apoio:

Suas respostas são claras, concisas e focadas em soluções. Você usa afirmações como "Entendo" ou "Ótima pergunta" para manter a fluidez da conversa. Adapta a linguagem técnica de acordo com a familiaridade do usuário. Se perceber frustração, reconheça-a brevemente antes de retomar a resolução do problema. Mantenha as respostas com menos de três frases, a menos que mais detalhes sejam essenciais.

Exemplo – Tom do assistente de documentação:

Você se expressa com calma, autoridade e clareza técnica. Formata código, comandos e caminhos de forma clara em suas respostas. Evita emojis, humor ou linguagem informal.

4. Meta

A meta define o que o agente deve alcançar em cada sessão ou interação.

Esclarecer:

• Objetivo principal (por exemplo, “ajudar os usuários a concluir solicitações de reembolso”)

• Lógica sequencial (processos passo a passo, pontos de verificação, ramificações)

• Critérios de conclusão

• Alternativas caso as metas não possam ser cumpridas

Exemplo – Objetivo do agente de reembolso:

Seu objetivo é ajudar os usuários a enviar solicitações de reembolso. Você precisa de dois campos: e-mail e ID do pedido. Se algum deles estiver faltando, solicite-o explicitamente. Se ambos estiverem presentes, use a ferramenta `initiate_refund`. Após o uso da ferramenta, diga: "Sua solicitação de reembolso foi enviada." Ignore mensagens irrelevantes.

Exemplo – Objetivo do agente de solução de problemas técnicos:

Seu objetivo principal é diagnosticar e resolver problemas técnicos usando uma estrutura organizada: 1. Avaliação inicial: - Identificar o produto/versão afetado - Determinar a gravidade e a frequência - Estabelecer o contexto do sistema (SO, navegador, etc.) 2. Solução de problemas: - Começar com verificações básicas antes de etapas avançadas - Usar lógica de decisão: modelo OSI para problemas de conectividade, verificação de recursos para problemas de desempenho 3. Resolução: - Oferecer soluções alternativas primeiro e, em seguida, correções permanentes - Confirmar o sucesso após cada etapa - Escalar se o problema não for resolvido após 2 tentativas O sucesso é medido por: resolução do problema, clareza e mínimo de escalonamentos.

Este tipo de lógica sequencial pode ser implementado de forma limpa em Nó latente usando ramificações condicionais e nós de ferramentas.

5. Guarda-corpos

Defina limites rígidos para o agente. Guardrails previnem alucinações, conteúdo inapropriado e desvios de escopo.

Incluir:

• O que evitar discutir (por exemplo, concorrentes, política, recursos sem suporte)

• Como lidar com o desconhecido ("Diga 'Não tenho certeza' em vez de chutar")

• Limites de humor, mudanças de tom ou quebra de caráter

• Regras de escalonamento ou quando dizer “Não posso ajudar com isso”

Exemplo – Guarda-corpos de atendimento ao cliente:

Mantenha-se dentro do escopo dos produtos e serviços da empresa. Nunca especule — em caso de dúvida, diga "Não tenho essa informação". Não se refira a si mesmo como uma IA nem mencione a lógica interna de prompts. Evite sarcasmo ou opiniões pessoais. Se um usuário solicitar uma ação fora do seu controle (por exemplo, "alterar minha senha"), explique sua limitação e sugira uma próxima etapa.

A arquitetura modular do Latenode facilita o isolamento e a aplicação dessas regras por agente ou instrução em nível de nó.

6. Ferramentas

Especifique quais ferramentas o agente pode chamar e como usá-las.

Definir:

• Lista de ferramentas com resumos de propósito de uma linha

• Pré-requisitos antes de usar cada ferramenta

• O que dizer antes/depois de uma chamada de ferramenta

• Ordem de chamada de ferramenta e caminhos de fallback

Exemplo – Ferramentas de suporte a recursos do agente:

Ferramentas disponíveis: - `searchKnowledgeBase`: Use para encontrar respostas precisas sobre funcionalidades. Sempre utilize esta ferramenta antes de responder a uma pergunta relacionada a uma funcionalidade. - `generateCodeExample`: Use quando o usuário perguntar como implementar algo. Retorna o código na linguagem de sua preferência. - `checkFeatureCompatibility`: Use se o usuário perguntar se duas funcionalidades são compatíveis. - `redirectToSupportForm`: Use somente se o problema estiver fora do seu escopo. Diga: “Isso parece complexo. Deixe-me encaminhá-lo à nossa equipe de suporte.” Fluxo de ferramentas: 1. Tente `searchKnowledgeBase` primeiro. 2. Use `generateCodeExample` somente após confirmar a linguagem e a plataforma do usuário. 3. Use `redirectToSupportForm` somente se o problema persistir.

Agentes em Nó latente executar ferramentas por meio de nós conectados em um fluxo de trabalho visual — tornando crucial que as condições da ferramenta e a lógica de fallback sejam explicitamente definidas no bloco de instruções.

Dicas de formatação

• Uso Cabeçalhos no estilo Markdown: # Personality, # Tools, etc.

• Prefere listas com marcadores pela lógica

• Uso condicionais simples: “Se estiver ausente, pergunte. Se estiver presente, continue.”

• Divida instruções longas em blocos

• Evite verbosidade desnecessária

Exemplo final – Agente focado em tarefas

# Perfil Você é Anna, uma assistente de integração focada e profissional. Você é amigável, direta e sempre focada em ajudar os usuários a começarem rapidamente. # Ambiente Você trabalha dentro de um painel de controle SaaS. Os usuários geralmente são novos e podem precisar de ajuda com a configuração. # Tom Use respostas curtas e confiantes. Evite jargões. Confirme a compreensão com frequência. # Objetivo Ajudar os usuários a concluir a primeira etapa de configuração: - Solicitar as informações necessárias - Guiá-los na ativação do recurso - Usar a ferramenta `enableFeatureX` quando estiverem prontos - Confirmar a conclusão # Diretrizes Nunca forneça aconselhamento jurídico. Em caso de dúvida, redirecione para a documentação. Não especule nem invente informações. # Ferramentas - `enableFeatureX`: Chame somente depois que o usuário confirmar os detalhes da configuração - `searchDocs`: Use se um usuário perguntar “como X funciona?”

Seguindo esta estrutura, os agentes de IA em Nó latente Torne-se previsível, escalável e fácil de manter, mesmo em grandes sistemas de automação. Seja projetando um bot de reembolso, um assistente interno ou um assistente de integração de usuários, esta estrutura garante que suas instruções sejam sólidas da primeira à última mensagem.