Entendendo os Prompts

Os Prompts Moldam o Comportamento do Agente Os prompts são as instruções e o contexto que guiam o raciocínio da IA. Eles definem o que o agente sabe, como deve se comportar, o que deve evitar e como lidar com casos especiais.

O que são os Prompts?

Os prompts na REDA AI são instruções em texto armazenadas em registros de Prompt personalizado vinculados a Definições de Agente. Diferente do campo Persona (que é um único prompt de sistema inicial), os Prompts personalizados fornecem camadas adicionais de instrução que refinam o comportamento do agente.

Pense nos prompts como um conjunto de regras, diretrizes e contexto que o agente de IA consulta ao processar as solicitações do usuário. Cada prompt tem uma finalidade específica, e vários prompts podem funcionar juntos para moldar o comportamento geral do agente.

Os Cinco Tipos de Prompt

Tipo de Prompt	Valor do Campo	Finalidade
Substituição de Persona	Persona_Override	Define ou refina a identidade, o papel, o tom e a personalidade do agente. Pode substituir ou ampliar o campo Persona base na Definição de Agente.
Instruções Personalizadas	Custom_Instructions	Regras comportamentais específicas. Exemplos: "Use sempre marcadores", "Só discuta temas de imóveis", "Mantenha as respostas com menos de 100 palavras".
Esquema	Schema	Descreve estruturas de dados do Salesforce (significado dos campos, valores da lista de seleção, relacionamentos). Reduz a necessidade de chamadas a ferramentas para descrever objetos.
Ação	Action	Instruções sobre como realizar ações específicas. Exemplos: "Ao criar uma tarefa, sempre defina a prioridade como Alta", "Os e-mails devem usar este modelo de assinatura".
Barreira de Proteção	Guardrail	Restrições e regras de segurança. Exemplos: "Nunca discuta preços com clientes do plano gratuito", "Encaminhe perguntas sobre salário para o RH".

Substituição de Persona x Campo Persona

Há uma distinção entre:

Campo Persona na Definição de Agente — O prompt de sistema base que define a identidade e o papel centrais do agente.
Prompt personalizado Persona_Override — Prompts adicionais que podem refinar ou substituir aspectos da persona base. Útil para fazer ajustes sem modificar o campo Persona original.

Na maioria dos casos, você usará o campo Persona para a persona base e reservará os prompts Persona_Override para refinamentos ou substituições específicas de contexto.

Como os Prompts são Montados

Quando o agente de IA processa uma mensagem do usuário, a REDA AI monta o prompt do sistema assim:

Persona Base — O campo Persona da Definição de Agente vem primeiro.
Prompts personalizados, por Ordem de Classificação — Todos os prompts aplicáveis seguem em uma única sequência ordenada pela Ordem de Classificação (a mais baixa primeiro), independentemente do tipo de prompt. O tipo descreve para que serve o prompt; ele não controla sua posição. Para colocar uma Barreira de Proteção antes de uma Instrução, dê a ela uma Ordem de Classificação mais baixa.
Mensagem do Usuário — A mensagem real do usuário é processada depois de todos os prompts.

"Aplicável" significa que o prompt passa por todos estes filtros no momento da montagem:

Ativo — a caixa Está Ativo está marcada.
Correspondência de agente — o prompt está vinculado a este agente, ou seu campo Definição de Agente está em branco, o que o torna um prompt universal que carrega para todos os agentes (as diretivas de idioma integradas vêm assim).
Correspondência de canal — a seleção de Canal do prompt inclui o canal em que a conversa está sendo executada.
Correspondência de contexto — se o prompt especifica Objetos de Contexto, o objeto do registro atual deve corresponder.
Não excluído — o prompt não está na lista de exclusões deste agente (definida com o Edit Loadout na Pré-visualização de Execução do Agente).
Não é um prompt exclusivo — um prompt com Prompt exclusivo marcado pula toda esta lista. Ele é invisível para a correspondência por agente, canal e contexto, e só chega a um agente quando um registro de Prompt exclusivo o atribui.
Cabe no orçamento de tokens — cada prompt carrega uma estimativa de tokens (sua Estimativa de complexidade, ou 200 quando em branco). Um prompt que empurraria o total acumulado além do Prompt Complexity Budget do agente (é assim que o campo se chama na Definição de Agente) é pulado naquele turno; prompts posteriores menores ainda podem carregar.

Estrutura e Conteúdo do Prompt

Campo	Tipo	Descrição
Tipo de Prompt	Lista de seleção	Um dos cinco tipos: Persona_Override, Custom_Instructions, Schema, Action ou Guardrail.
Conteúdo	Área de texto longo	O texto real do prompt. É isso que é enviado para a IA. Pode ser muito longo (milhares de caracteres).
Ativo	Caixa de seleção	Somente os prompts ativos são montados e enviados para a IA. Desativar um prompt o desabilita sem excluí-lo.
Ordem de Classificação	Número	Controla a posição do prompt na sequência montada — entre todos os tipos de prompt. Números menores vêm primeiro.
Definição de Agente	Pesquisa para Definição de Agente	A qual agente este prompt pertence. Deixe em branco para tornar o prompt universal — ele carregará para todos os agentes da org.
Canal	Lista de seleção múltipla	Em quais canais o prompt carrega (Interno, Widget Externo, Comunidade, API). Um prompt selecionado para Interno e Widget Externo carrega em ambos.
Objetos de Contexto	Texto	Lista opcional de nomes de API de objetos. Quando definida, o prompt só carrega quando a conversa é executada no contexto de um desses objetos.
Estimativa de complexidade	Número	O tamanho estimado do prompt em tokens, usado para aplicar o Prompt Complexity Budget do agente durante a montagem. Em branco conta como 200.

Variáveis de Contexto nos Prompts

Os prompts podem incluir variáveis de contexto que são substituídas dinamicamente por valores reais em tempo de execução. Variáveis comuns:

{USER_NAME} — O nome e o sobrenome do usuário do Salesforce
{USER_FIRST_NAME} — Apenas o primeiro nome
{USER_EMAIL} — O e-mail do usuário
{TODAY_DATE} — A data de hoje no local da organização
{AGENT_NAME} — O Nome de Exibição do agente
{USER_LANGUAGE} — A localidade de idioma do Salesforce do usuário

Exemplo: "Cumprimente o usuário como {USER_FIRST_NAME}. A data de hoje é {TODAY_DATE}." se torna "Cumprimente o usuário como John. A data de hoje é 5 de março de 2026."

Exemplos Comuns de Prompt

Exemplo de Prompt de Esquema

Você tem acesso aos seguintes objetos do Salesforce:

Opportunity:
- StageName (lista de seleção): Prospecting, Qualification, Needs Analysis, Value Proposition, Decision Makers, Perception Analysis, Proposal/Price Quote, Negotiation/Review, Closed Won, Closed Lost
- Amount (moeda): valor total do negócio
- ExpectedRevenue (moeda): receita prevista
- CloseDate (data): data de fechamento prevista

Account:
- Industry (lista de seleção): Technology, Healthcare, Finance, Manufacturing, etc.
- AnnualRevenue (moeda): receita anual total
- NumberOfEmployees (número): número de funcionários

Exemplo de Prompt de Instruções Personalizadas

Siga estas diretrizes comportamentais:
1. Sempre formate listas com marcadores, não números
2. Mantenha as respostas concisas — no máximo 3 a 4 frases
3. Use linguagem amigável e conversacional
4. Nunca invente informações sobre os registros; sempre consulte para verificar
5. Ofereça ajuda com o próximo passo do fluxo de trabalho

Exemplo de Prompt de Barreira de Proteção

NÃO discuta os seguintes temas:
- Remuneração de funcionários ou detalhes salariais
- Informações confidenciais de preços
- Informações pessoais de saúde ou médicas
- Credenciais ou senhas

Se perguntarem sobre esses temas, recuse educadamente e ofereça encaminhar ao departamento adequado.

Vários Prompts do Mesmo Tipo

Você pode criar vários prompts do mesmo tipo e atribuí-los todos a um agente. Eles são concatenados na sequência do Sort_Order. Isso é útil para:

Modularidade — Divida instruções complexas em vários prompts focados.
Reutilização — Use o mesmo prompt em vários agentes sem duplicação.
Padrões de Herança — Crie um prompt base que se aplica a todos os agentes e, depois, substituições específicas por agente.
Controle Dinâmico — Desative/ative prompts sem excluí-los, ou reordene-os alterando o Sort_Order.

Por exemplo, você pode ter:

Custom_Instructions (Sort_Order 1) — Regras gerais de tom e formato
Custom_Instructions (Sort_Order 2) — Regras específicas do domínio de Vendas
Custom_Instructions (Sort_Order 3) — Políticas específicas da empresa

Desativar x Excluir Prompts

Desativar (desligar Is Active) — O prompt permanece no banco de dados, mas não é enviado à IA. Use isso para desabilitar temporariamente um prompt enquanto testa alterações.

Excluir — O registro do prompt é removido permanentemente. Use isso apenas quando tiver certeza de que o prompt nunca mais será necessário.

Boa prática: desative em vez de excluir, para poder reativar rapidamente se necessário.

Configurar instruções reutilizáveis

Prompts exclusivos permitem atribuir instruções reutilizáveis a agentes selecionados. Revise Prompt exclusivo e Resumo no Prompt personalizado e Definição de agente, Prompt personalizado, Ativo e Modo de carregamento na atribuição. Sob demanda exige a ferramenta de prompts de contexto na configuração do agente. Escopos com tipos de registro entre colchetes usam regras compartilhadas, inclusive nas prévias. A ordenação de prompts e ferramentas é determinística e a prévia aceita um ID real de registro. Instruções de idioma seguem a mensagem em API/canais externos; marcadores de usuário só se aplicam nos contextos previstos. Preserve prompts próprios ao mesclar padrões atuais.

Perguntas frequentes

Sim. Deixe o campo Definição de Agente do prompt em branco e ele se torna um prompt universal que carrega para todos os agentes da org — as diretivas de idioma integradas vêm assim. Para compartilhar um prompt apenas com alguns agentes, duplique-o por agente, ou torne-o universal e exclua-o nos agentes que não devem usá-lo (Edit Loadout na Pré-visualização de Execução do Agente).

A IA tentará seguir as duas instruções. No entanto, contradições podem gerar comportamento imprevisível. Mantenha os prompts consistentes e teste com cuidado. Se encontrar contradições, use o Sort_Order para priorizar um sobre o outro, ou consolide-os em um único prompt.

Os prompts são texto simples, não HTML. Você pode usar formatação no estilo markdown (*, -, # para listas e cabeçalhos) se a IA a interpretar, mas a abordagem segura é o texto simples. A IA cuidará da formatação da resposta de forma independente.

O campo Conteúdo do prompt é uma Área de Texto Longo que aceita até 20.000 caracteres. Na prática, mantenha os prompts com menos de 10.000 caracteres cada, para maior clareza e para evitar consumo excessivo de tokens. Se precisar de orientações extensas, divida-as em vários prompts.

Próximos Passos

Saiba como criar e editar prompts para seus agentes, ou explore as boas práticas de prompts para otimizar as respostas do seu agente.

Próximo: Criar e Editar Prompts →