Entendendo os Campos de Contexto
O que são Campos de Contexto?
Campos de contexto são um mecanismo de configuração na REDA AI que carrega automaticamente campos específicos de registros do Salesforce no contexto da IA quando um usuário está em uma página de registro. Em vez de a IA precisar chamar uma ferramenta de consulta para buscar os dados de um registro, os dados já estão pré-carregados e disponíveis imediatamente.
Os campos de contexto têm dois propósitos:
- Percepção — A IA sabe qual registro o usuário está visualizando
- Eficiência — A IA tem os dados do registro sem precisar fazer chamadas de ferramentas (economizando tokens e custo)
Por exemplo, se um usuário abre um registro de Oportunidade e seu agente tem campos de contexto configurados para "Amount", "StageName" e "CloseDate", esses três campos ficam automaticamente disponíveis para a IA. A IA pode discutir a oportunidade imediatamente, sem precisar consultá-la antes.
Por Que os Campos de Contexto São Importantes
Sem campos de contexto, quando um usuário pergunta "Qual é o próximo passo para este negócio?", a IA precisaria:
- Chamar soql_query ou get_record para buscar os dados da Oportunidade
- Aguardar o resultado (adiciona latência)
- Só então formular uma resposta
- Custo: tokens adicionais pela chamada da ferramenta e seu resultado
Com campos de contexto:
- Os dados da Oportunidade já estão pré-carregados no contexto da IA
- A IA acessa os dados imediatamente, sem chamadas de ferramentas
- Resposta instantânea (sem latência)
- Custo: nenhum token adicional — os dados já estão no contexto
Estrutura dos Campos de Contexto
Os campos de contexto são armazenados como registros de configuração dentro da configuração da REDA AI. Cada campo de contexto especifica:
| Propriedade | Descrição |
|---|---|
| Definição de Agente | A qual agente esta configuração se aplica. Deixe em branco para torná-la universal — ela então se aplica a todos os agentes para aquele objeto. |
| Object API Name | O objeto do Salesforce que a configuração cobre (por exemplo, Opportunity, Account, Case). |
| Nomes de API de Campo | Os campos a carregar, como uma lista de nomes de API (por exemplo, StageName, Amount, CloseDate). Um único registro de configuração carrega a lista inteira — você não cria um registro por campo. |
| Campos máximos | Quantos campos esta configuração pode contribuir. Padrão: 10. |
| Incluir nomes relacionados | Quando ativado (o padrão), os campos de pesquisa contribuem com o nome do registro relacionado em vez do Id bruto — assim o agente lê “Acme Properties” em vez de uma chave de 18 caracteres. |
| Descrição do contexto | Texto livre opcional que explica ao agente o que este contexto de registro representa e como usá-lo. |
| Record Type Developer Name | Limita opcionalmente a configuração a um tipo de registro. Uma configuração específica de tipo de registro tem prioridade sobre uma geral para o mesmo agente. |
| Ordem de classificação | Ordem em que as configurações são aplicadas. Números menores primeiro; padrão 100. |
| Is Active | Somente configurações ativas são carregadas. Ativado por padrão. |
Três regras que os rótulos dos campos não contam.
- Max Fields é limitado a 1–25 em tempo de execução. O padrão é 10. Informe 40 e o agente ainda recebe 25; informe 0 e ele recebe 1. O valor não é rejeitado ao salvar, então uma configuração pedindo 40 parece funcionar enquanto entrega 25 silenciosamente.
- Sort Order é o último critério de desempate, não a primeira regra. O específico do agente vence o universal, e o limitado por tipo de registro vence o não limitado, antes de o Sort Order sequer ser considerado. Ele apenas ordena configurações que de outra forma estariam empatadas. Uma configuração universal com Sort Order 1 ainda perde para uma específica do agente com Sort Order 100.
- Record Type Developer Name é o DeveloperName, não o rótulo. Se o tipo de registro aparece como “Commercial Lease” na Configuração, o valor aqui provavelmente é
Commercial_Lease. Um rótulo digitado por engano simplesmente nunca corresponde, e a configuração nunca é ativada.
No máximo 50 configurações são consideradas para um objeto em um mesmo turno. Está muito acima de qualquer montagem razoável, mas é o teto.
Onde os Campos de Contexto São Usados
Os campos de contexto são carregados apenas em páginas de registro. Especificamente:
- Página de registro de Oportunidade — os campos de contexto do objeto Oportunidade são carregados
- Página de registro de Conta — os campos de contexto do objeto Account são carregados
- Página de registro de Caso — os campos de contexto do objeto Caso são carregados
Os campos de contexto NÃO são carregados em:
- Páginas iniciais
- Visualizações de lista
- Páginas de relatório
- Implantações do Widget Externo
Isso é intencional — os campos de contexto servem para adicionar dados específicos de um registro quando o usuário está focado em um registro em particular.
Hierarquia de Prioridade
Os campos de contexto seguem uma hierarquia de prioridade para determinar quais campos são carregados:
- Agente + Tipo de Registro — campos de contexto vinculados ao agente específico E a um tipo de registro específico (prioridade mais alta)
- Agente + Qualquer Tipo de Registro — campos de contexto vinculados ao agente sem restrição de tipo de registro
- Universal + Tipo de Registro — campos de contexto universais (sem agente) com restrição a um tipo de registro específico
- Universal + Qualquer Tipo de Registro — campos de contexto universais sem restrições (prioridade mais baixa)
Se um campo de contexto for definido em vários níveis de prioridade, o de prioridade mais alta é usado. Isso permite padrões de herança em que campos universais se aplicam a todos os agentes, a menos que sejam substituídos por campos específicos de um agente.
A Segurança em Nível de Campo se Aplica
A REDA AI respeita a Segurança em Nível de Campo (Field-Level Security, FLS) do Salesforce. Se um usuário não puder ler um campo no Salesforce, esse campo não é incluído no contexto, mesmo que esteja configurado como campo de contexto. Isso garante que:
- Campos sensíveis não sejam expostos a usuários sem permissão
- Usuários diferentes possam ver dados de contexto diferentes com base em suas permissões de FLS
- Não haja brecha de segurança por meio da IA
Por exemplo, se o seu agente tiver "Salary" como campo de contexto para objetos Contact, mas o perfil do usuário não tiver acesso de leitura ao campo Salary, esse usuário não verá os dados de salário no contexto da IA.
Custo em Tokens dos Campos de Contexto
Mais campos de contexto = mais tokens por interação. Cada campo incluído no contexto consome tokens. Isso impacta diretamente seu custo em créditos. Portanto:
- Inclua apenas os 5 a 10 campos mais relevantes por objeto
- Use o Otimizador de Campos de Contexto para obter recomendações
- Remova campos raramente consultados pelo agente
- Equilibre a amplitude do contexto com a eficiência de custo
Como regra geral, cada campo de contexto adicional acrescenta proporcionalmente mais tokens a cada interação; portanto, reduzir sua lista apenas aos campos que um agente realmente consulta pode reduzir significativamente os custos ao longo do tempo.
Campos de Contexto Universais
Um Campo de Contexto com Definição de Agente vazia é um campo de contexto "universal" — ele se aplica a TODOS os agentes na organização para aquele tipo de objeto. Isso é útil para:
- Padrões Compartilhados — campos aos quais todos os agentes devem ter acesso (por exemplo, "Name", "CreatedDate")
- Consistência — garante que todos os agentes comecem com um conjunto básico de campos de contexto
- Eficiência — atualize o campo uma vez, em vez de atualizar várias cópias específicas de cada agente
Campos de contexto específicos de um agente podem substituir os universais usando a hierarquia de prioridade.
Padrões Comuns de Campos de Contexto
- AccountName (relacionado à Conta)
- StageName (status da oportunidade)
- Amount (tamanho do negócio)
- CloseDate (fechamento previsto)
- Probability (confiança da previsão)
- CaseNumber (número de referência)
- Status (aberto/fechado)
- Priority (urgência)
- Description (resumo do problema)
- ContactName (contato do cliente)
- AccountName
- Industry
- AnnualRevenue
- NumberOfEmployees
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
Comece com os 5 a 10 campos que o seu agente mais consulta nas conversas. Use o Otimizador de Campos de Contexto para obter recomendações com tecnologia de IA com base no propósito do seu agente e no esquema do Salesforce.
Sim, você pode adicionar qualquer campo exposto pela API do Salesforce. No entanto, campos de relacionamento podem consumir mais tokens do que campos simples de texto/número. Use com cautela e teste o impacto no uso de tokens.
As alterações em campos de contexto entram em vigor imediatamente. Na próxima vez que o agente for carregado em uma página de registro, o novo campo de contexto é incluído (sujeito à FLS e às prioridades).
Se um campo de contexto não tiver valor para um determinado registro, a IA vê o campo como vazio ou não informado. A IA lida bem com dados ausentes e pode fazer perguntas de acompanhamento ou prosseguir sem essa informação.
Próximos Passos
Saiba como adicionar campos de contexto aos seus agentes ou use o Otimizador de Campos de Contexto para obter recomendações com tecnologia de IA.