Práticas recomendadas de prompts
1. Seja específico sobre o papel e o escopo do agente
O agente deve saber exatamente pelo que é responsável e pelo que NÃO é responsável. Evite personas vagas como "Você é um assistente útil". Em vez disso, seja concreto:
"Você é um assistente de Executivo de Contas de Vendas especializado em negócios de SaaS empresarial. Sua função é ajudar os representantes de vendas a gerenciar pipelines, qualificar leads e acompanhar o progresso dos negócios. Você foca em oportunidades avaliadas acima de US$ 50 mil. Não discuta detalhes de preços nem assuma compromissos em nome da equipe de vendas."
Quanto mais específica for a sua Persona, com mais confiabilidade a IA conseguirá cumprir seu papel.
2. Use prompts do tipo Guardrail para definir o que o agente NÃO deve fazer
Os prompts do tipo Guardrail são poderosos para evitar comportamentos indesejados. Em vez de esperar que a IA não faça algo, diga explicitamente que não o faça:
- "Nunca acesse nem discuta informações pessoais dos funcionários (número de seguridade social, data de nascimento, estado civil)."
- "Não faça promessas em nome da empresa sem escalar para um gerente."
- "Recuse solicitações de acesso a registros de outros departamentos sem a devida autorização."
- "Sempre escale perguntas sobre salário ou remuneração para o RH."
3. Use prompts do tipo Schema para descrever campos-chave do Salesforce
Os prompts do tipo Schema descrevem as estruturas de dados do seu Salesforce. Isso reduz chamadas de ferramentas desnecessárias (describe_object, get_picklist_values) que consomem créditos. Em vez de a IA perguntar "Quais são os valores de Opportunity.StageName?", você informa isso antecipadamente:
Prompt do tipo Schema (barato): "Opportunity.StageName tem estes valores de lista de seleção: Prospecting, Qualification, Needs Analysis, Value Proposition, Decision Makers, Perception Analysis, Proposal/Price Quote, Negotiation/Review, Closed Won, Closed Lost."
vs.
Chamada de ferramenta (bem mais cara): a IA chama uma ferramenta para buscar a mesma informação.
Use prompts do tipo Schema para os 10 a 20 campos e objetos mais importantes que seu agente referencia com frequência.
4. Mantenha cada prompt focado em um único propósito
Não tente colocar vários comportamentos em um único prompt. Em vez disso, crie vários prompts focados:
Um mega-prompt com tom, formato, regras de domínio e instruções de ação tudo misturado.
- Custom_Instructions (Sort 10) — "Use formato de marcadores"
- Custom_Instructions (Sort 20) — "Mantenha as respostas com menos de 150 palavras"
- Schema (Sort 10) — "Campos e listas de seleção de Oportunidade"
- Action (Sort 10) — "Como criar tarefas"
- Guardrail (Sort 10) — "Nunca discuta preços"
Prompts focados são mais fáceis de manter, testar e depurar.
5. Teste de forma iterativa — pequenas mudanças, observe o comportamento
Não crie 10 prompts de uma vez e implante todos. Em vez disso:
- Crie um único prompt
- Ative-o e teste o agente
- Observe como o comportamento muda
- Refine o prompt, se necessário
- Passe para o próximo prompt
Essa abordagem iterativa ajuda você a entender quais prompts têm o efeito desejado e a identificar consequências indesejadas logo no início.
6. Use variáveis de contexto para personalização
Variáveis de contexto como {USER_FIRST_NAME}, {TODAY_DATE} e {USER_EMAIL} personalizam as interações. Exemplo:
"Olá, {USER_FIRST_NAME}! Hoje é {TODAY_DATE}. Estou aqui para ajudar você a fechar negócios mais rápido."
Isso faz com que o agente pareça atento a cada usuário individualmente, em vez de genérico.
7. Instrua respostas concisas para economizar créditos de saída
Respostas mais longas consomem mais tokens de saída, o que aumenta o custo. Instrua a IA a ser breve:
- "Limite as respostas a no máximo 2-3 frases."
- "Forneça apenas informações essenciais; os usuários podem fazer perguntas de acompanhamento."
- "Use marcadores em vez de parágrafos para ser conciso."
Respostas breves e focadas costumam ser melhores para os usuários de qualquer forma — elas reduzem a carga cognitiva.
8. Evite repetir informações em vários prompts
Instruções redundantes consomem tokens extras e podem gerar confusão. Se você já declarou algo em um prompt, não repita em outro. Faça referência cruzada, se necessário:
Não tenha a mesma instrução em um prompt Custom_Instructions e em um prompt Guardrail ao mesmo tempo.
9. Use a ordem de classificação para controlar a ordem em que os prompts são montados
Se algumas instruções devem ter prioridade sobre outras, use números de Sort_Order mais baixos. Exemplo:
- Sort_Order 10: Guardrails críticos (regras de segurança) — processados primeiro
- Sort_Order 20: informações de esquema (contexto de dados)
- Sort_Order 30: instruções personalizadas (regras de comportamento)
- Sort_Order 40: instruções de ação (ações específicas)
Prompts posteriores podem se basear nos anteriores. Organize-os de forma lógica.
10. Documente sua estratégia de prompts
Crie documentação interna explicando:
- O que cada prompt faz e por que existe
- O público de usuários pretendido para o agente
- Quando ativar/desativar prompts específicos
- Como os prompts funcionam juntos para moldar o comportamento
- Quaisquer limitações ou casos extremos conhecidos
Isso ajuda outros administradores a entender suas decisões de design e a manter o agente de forma eficaz.
Técnicas avançadas
Testes A/B de prompts
Teste duas versões de um prompt fazendo o seguinte:
- Crie o Prompt A (ativo)
- Crie o Prompt B (inativo)
- Execute ambos no agente por uma semana cada, acompanhando os resultados
- Decida qual tem melhor desempenho e mantenha o vencedor
Refinamento progressivo
Comece com uma persona mínima e adicione prompts gradualmente à medida que aprende o que funciona:
- Semana 1: Persona + Custom Instructions básicas
- Semana 2: adicione prompts Schema com base nas consultas que a IA faz
- Semana 3: adicione Guardrails com base em comportamentos indesejados observados
- Semana 4+: ajuste fino e otimização
Substituições específicas de contexto
Crie prompts Persona_Override para contextos específicos. Por exemplo, um agente de Vendas pode ter:
- Persona base: tom geral de assistente de vendas
- Persona_Override (Sort 10): tom mais formal para clientes Enterprise
- Persona_Override (Sort 20): tom mais casual para clientes SMB
A IA pode aprender a aplicar o tom apropriado com base no contexto.
Perguntas frequentes
Teste de forma sistemática: envie ao agente mensagens criadas para testar prompts específicos e observe as respostas. Verifique se o agente segue as instruções, respeita os guardrails e formata a saída conforme especificado. Consulte os registros de conversas para ver o que a IA está fazendo.
Muitos prompts curtos e focados são melhores. Eles são mais fáceis de gerenciar, testar e desativar de forma independente. Uma boa regra prática: um prompt por comportamento lógico ou conjunto de instruções.
Os guardrails podem ser ignorados se entrarem em conflito com a persona ou com outras instruções. Torne os guardrails explícitos e inequívocos. Use o Sort_Order para priorizá-los. Teste com mensagens reais para verificar se o guardrail é eficaz.
Você pode usar prompts semelhantes em agentes diferentes, mas precisará criar uma cópia para cada agente (eles estão vinculados a agentes específicos). Clone os prompts quando possível para manter a consistência.
Próximos passos
Explore os prompts personalizados por agente para organizar seus prompts, ou saiba mais sobre as variáveis de contexto para personalização avançada.