Variáveis de Contexto de Prompt
O que são Variáveis de Contexto?
Variáveis de contexto são placeholders em prompts que são substituídos por valores reais em tempo de execução. Elas permitem interações dinâmicas e personalizadas sem necessidade de customização manual para cada usuário ou situação.
Uma variável de contexto tem a forma {VARIABLE_NAME}. Quando o agente processa o prompt, a variável é substituída pelo seu valor real.
Exemplo: "Olá {USER_FIRST_NAME}! Hoje é {TODAY_DATE}." se torna "Olá John! Hoje é 5 de março de 2026."
Variáveis de Contexto Disponíveis
| Variável | Substituída Por | Valor de Exemplo | Disponível Em |
|---|---|---|---|
| {USER_NAME} | Nome completo do usuário | John Smith | Por conversa |
| {USER_FIRST_NAME} | Primeiro nome do usuário | John | Por conversa |
| {USER_EMAIL} | E-mail do usuário | john@example.com | Por conversa |
| {USER_ACCOUNT_NAME} | O nome da conta vinculada ao contato de um usuário de portal (vazio para usuários internos sem contato) | Acme Properties | Por conversa |
| {CONVERSATION_ID} | O Id do registro da conversa atual — útil para instruções de auditoria | aX0… | Por conversa |
| {USER_CONTEXT_DATA} | Um bloco formatado descrevendo o usuário atual (usado pelos prompts integrados) | — | Por conversa |
| {RECORD_CONTEXT_DATA} | O bloco de contexto do registro da página em que a conversa é executada | — | Por conversa |
| {TODAY_DATE} | A data de hoje | 2026-03-05 | Na montagem (compatível com cache) |
| {AGENT_NAME} | O Nome de Exibição do agente | Assistente de Vendas | Na montagem (compatível com cache) |
| {AGENT_CHANNEL} | O canal em que a conversa está sendo executada | Internal | Na montagem (compatível com cache) |
| {USER_LANGUAGE} | A localidade de idioma do Salesforce do usuário | pt_BR | Na montagem (compatível com cache) |
| {USER_LANGUAGE_CODE} | Apenas a parte do idioma da localidade | pt | Na montagem (compatível com cache) |
Usando Variáveis de Contexto em Prompts
As variáveis de contexto podem ser usadas em qualquer tipo de prompt e em qualquer campo:
"Olá {USER_FIRST_NAME}! Sou {AGENT_NAME}, seu assistente pessoal de vendas. Como posso ajudar a fechar negócios hoje?"
"Ao responder a {USER_FIRST_NAME}, use o estilo de comunicação preferido dele: direto e conciso. Sempre inclua {TODAY_DATE} em qualquer estimativa de prazo."
"O usuário {USER_NAME} ({USER_EMAIL}) está acessando este agente na conversa {CONVERSATION_ID}. Registre todas as interações para fins de conformidade. Escale solicitações de dados sensíveis para a gestão."
Exemplos de Personalização
Agente de Vendas com Personalização
Sem variáveis (genérico):
"Você é um assistente de vendas ajudando a fechar negócios."
Com variáveis (personalizado):
"Você é o assistente pessoal de vendas de {USER_FIRST_NAME}. Ajude {USER_FIRST_NAME} a fechar negócios, gerenciar oportunidades e acompanhar o progresso. Hoje é {TODAY_DATE}."
Cada usuário recebe uma persona sob medida.
Agente de Suporte com Contexto de Data
Sem variáveis:
"Ajude os clientes a resolver chamados de suporte."
Com variáveis:
"Ajude os clientes a resolver chamados de suporte. Data atual: {TODAY_DATE}. Ao discutir prazos, sempre faça referência a essa data atual. Responda no idioma do usuário ({USER_LANGUAGE})."
Seus próprios tokens de template são preservados
As doze variáveis acima são as que a REDA AI resolve. Se a sua organização tem o próprio sistema de
templates — tokens que você preenche a partir de outro lugar, ou deixa para uma pessoa completar
— escreva-os com chaves duplas, por exemplo
{{ORG_NAME}}.
A REDA AI não resolve tokens de chaves duplas, e as ferramentas assistidas por IA são explicitamente
instruídas a deixá-los intactos: tanto o Otimizador
de prompts quanto o Criar agente com IA
recebem a instrução de manter cada token {{…}} exatamente como
está — sem removê-lo, resolvê-lo, renomeá-lo ou preencher um valor. Assim um prompt pode passar por
uma otimização sem perder seus marcadores.
Vale manter a distinção clara: chaves simples são da REDA AI e são substituídas na montagem; chaves duplas são suas e sobrevivem intactas.
Disponibilidade de Variáveis por Canal
As variáveis de agente e data são resolvidas em todos os canais. As variáveis de usuário dependem de haver uma pessoa autenticada:
- Canais Interno e API — as variáveis de usuário são resolvidas a partir do usuário do Salesforce em execução.
- Canal Comunidade — as variáveis de usuário são resolvidas a partir do usuário do portal; {USER_ACCOUNT_NAME} é preenchida com a conta vinculada ao contato dele.
- Widget Externo — não há pessoa autenticada, então as variáveis de usuário são removidas: são substituídas por texto vazio, nunca são enviadas à IA e nunca aparecem literalmente. Escreva os prompts desse canal para que leiam naturalmente sem as variáveis de usuário.
Um nome de variável desconhecido (um erro de digitação, ou uma variável que não existe) é diferente: ele não é substituído e chega à IA literalmente — veja a seção de solução de problemas abaixo.
Boas Práticas para Variáveis de Contexto
As variáveis devem aprimorar a interação. Evite usá-las em excesso — um prompt com {USER_FIRST_NAME} mencionado em cada frase soa estranho. Use com moderação para uma personalização natural.
Verifique a Disponibilidade da Variável — Antes de usar uma variável em um agente de Widget Externo, confirme se ela está disponível nesse canal. TESTE em produção para garantir que as variáveis sejam substituídas corretamente.
Lide com Elegância Quando Variáveis Estiverem Ausentes — Escreva prompts que funcionem mesmo se uma variável não for substituída. Exemplo: "Olá {USER_FIRST_NAME}! (ou quem quer que você seja)" vs. "Olá {USER_FIRST_NAME}!" (quebra se a variável estiver ausente).
Use Datas com Reconhecimento de Fuso Horário — {TODAY_DATE} respeita o fuso horário e a localidade do usuário. Use-a para qualquer instrução sensível ao tempo. Evite datas fixas.
Respeite a Privacidade do Usuário — Não exponha {USER_EMAIL} a menos que seja necessário. Use {USER_FIRST_NAME} para personalização sem compartilhar dados em excesso.
Padrões Comuns
"Oi {USER_FIRST_NAME}! Bem-vindo de volta. Hoje é {TODAY_DATE}."
"Você está atendendo {USER_NAME} da {USER_ACCOUNT_NAME}. Adapte suas respostas à função e ao nível de experiência dele. Hoje é {TODAY_DATE}."
"Registre todas as interações. Usuário: {USER_NAME}, E-mail: {USER_EMAIL}, Conversa: {CONVERSATION_ID}, Data: {TODAY_DATE}."
"O idioma do usuário é {USER_LANGUAGE}. Responda nesse idioma e use as convenções dele. Hoje é {TODAY_DATE}."
Solução de Problemas com Variáveis
Verifique se o nome da variável está exatamente correto (diferencia maiúsculas de minúsculas). {USER_FIRST_NAME} funciona; {User_First_Name} não funciona. Lembre-se também de que no canal Widget Externo as variáveis de usuário são substituídas por texto vazio.
Valor Inesperado na Variável — Algumas variáveis dependem das configurações do Salesforce. {USER_LANGUAGE} é baseada no idioma do Salesforce do usuário. Se estiver incorreto, atualize o idioma nas configurações pessoais do usuário.
A Variável Aparece Literalmente na Resposta — Se o prompt contém {UNKNOWN_VAR}, a IA pode repeti-la literalmente. Use apenas variáveis da lista disponível.
Perguntas frequentes
Atualmente, você só pode usar as variáveis predefinidas listadas acima. Variáveis personalizadas não são suportadas. Se precisar de contexto adicional, use campos de contexto ou passe dados pela configuração do agente.
As variáveis funcionam em prompts. Os campos de contexto usam nomes de API de campo do Salesforce e não suportam variáveis. Para mapeamento dinâmico de campos, use prompts com descrições de campo.
Se o primeiro nome de um usuário não estiver definido ({USER_FIRST_NAME} vazio), a variável é substituída por uma string vazia. Escreva prompts que lidem bem com isso, ou torne a variável opcional: "Olá {USER_FIRST_NAME} (ou amigo)!"
Não. Os rótulos dos chips de sugestão são estáticos. Você pode usar variáveis no campo Mensagem (o que é enviado ao clicar), mas não no Rótulo (texto do botão).
Próximos passos
Consulte criação de prompts para ver exemplos de variáveis em ação, ou explore boas práticas de prompts para mais orientações.