Adicionando Campos de Contexto
Como adicionar um campo de contexto
-
Abra a Definição de Agente
Acesse o app REDA AI e abra a Definição de Agente que você quer configurar.
-
Localize a lista relacionada Campos de Contexto
Role até a lista relacionada "Campos de Contexto", que mostra os campos configurados atualmente.
-
Clique em "Novo Campo de Contexto"
Clique no botão "Novo" para criar um novo registro de campo de contexto.
-
Selecione o nome de API do objeto
Digite o tipo de objeto do Salesforce (por exemplo, "Oportunidade", "Account", "Contact"). Este é o nome de API, não o rótulo.
-
Informe os nomes de API dos campos
Informe todos os campos que você quer que esta configuração carregue, como uma lista separada por vírgulas 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. Encontre os nomes de API em Configuração → Gerenciador de Objetos → Campos. -
Defina o Max Fields (opcional)
Limita quantos campos esta configuração pode contribuir. O padrão é 10 — aumente-o se a sua lista for maior, e lembre-se de que cada campo custa tokens em cada turno.
-
Deixe o Include Related Names ativado (recomendado)
Ativado por padrão. Os campos de pesquisa então contribuem com o nome do registro relacionado em vez do Id bruto, então o agente lê “Acme Properties” em vez de uma chave de 18 caracteres.
-
Adicione uma Context Description (opcional)
Texto livre dizendo ao agente o que este contexto de registro representa e como usá-lo — útil quando os nomes dos campos sozinhos não transmitem o significado de negócio.
-
Defina a ordem de classificação (opcional)
Controla a ordem em que as configurações são aplicadas quando mais de uma corresponde. Números menores aparecem primeiro; o padrão do pacote é 100.
-
Restrição de tipo de registro (opcional)
Se esse campo deve ser carregado apenas para um tipo de registro específico, selecione o tipo de registro. Deixe em branco para todos os tipos de registro.
-
Salve o campo de contexto
Clique em Salvar. O campo agora está configurado para esse agente.
Encontrando os nomes de API de campos e objetos
Os campos de contexto exigem nomes de API, não rótulos. Para encontrá-los:
- Vá em Configuração → Gerenciador de Objetos
- Encontre o objeto (por exemplo, "Oportunidade")
- Clique em "Campos e Relacionamentos"
- Encontre o campo desejado (por exemplo, "Stage")
- Clique no campo para abrir seus detalhes
- Procure por "Nome do Campo" ou "Nome de API" — é isso que você digita nos campos de contexto
- Exemplo: o rótulo "Stage" tem o nome de API "StageName"
Nomes de API comuns vs. rótulos:
| Objeto | Rótulo | Nome de API |
|---|---|---|
| Oportunidade | Estágio | StageName |
| Data de Fechamento | CloseDate | |
| Receita Esperada | ExpectedRevenue | |
| Conta | Nome da Conta | Name |
| Receita Anual | AnnualRevenue | |
| Número de Funcionários | NumberOfEmployees | |
| Caso | Status | Status |
| Prioridade | Priority | |
| Descrição | Description |
Campos de configuração do campo de contexto
| Campo | Obrigatório? | Descrição |
|---|---|---|
| Definição de Agente | Não (opcional) | A qual agente esse campo de contexto se aplica. Deixe em branco para campos de contexto universais. |
| Object API Name | Sim | O objeto do Salesforce (por exemplo, "Oportunidade", "Account"). Use o nome de API, não o rótulo. |
| Nomes de API de Campo | Sim | O campo específico (por exemplo, "StageName", "Amount"). Use o nome de API, não o rótulo. |
| Campos máximos | Não | Limita quantos campos esta configuração contribui. Padrão: 10. |
| Incluir nomes relacionados | Não | Ativado por padrão — os campos de pesquisa contribuem com o nome do registro relacionado em vez do Id. |
| Descrição do contexto | Não | Texto livre explicando ao agente o que este contexto de registro representa e como usá-lo. |
| Ordem de classificação | Não | Número que controla a ordem em que os campos são apresentados à IA. Números menores aparecem primeiro. Padrão: 0. |
| Record Type Developer Name | Não | Opcionalmente, limite esse campo de contexto a um tipo de registro específico. Deixe em branco para aplicar a todos os tipos de registro. |
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.
Campos de contexto universais
Para criar um campo de contexto que se aplique a TODOS os agentes (universal):
- Deixe a pesquisa de Definição de Agente em branco (não selecione nenhum agente)
- Preencha o Nome de API do Objeto, o Nome de API do Campo e o Rótulo de Exibição normalmente
- Salve
Esse campo de contexto agora se aplica a todos os agentes para esse tipo de objeto, a menos que seja substituído por campos de contexto específicos do agente (que têm prioridade mais alta).
Testando campos de contexto
Depois de adicionar um campo de contexto:
-
Abra um registro no Salesforce
Abra um registro do tipo de objeto que você configurou (por exemplo, uma Oportunidade se você adicionou campos de contexto para Oportunidade).
-
Ative o chat do agente
Abra o widget de chat da REDA AI na página do registro.
-
Faça uma pergunta sobre o registro
Pergunte algo como "Qual é o estágio dessa oportunidade?" ou "Me conte sobre esse negócio."
-
Verifique se os campos de contexto aparecem na resposta
A IA deve mencionar os valores dos campos dos seus campos de contexto. Se isso acontecer, os campos de contexto estão funcionando.
-
Verifique os registros (opcional)
Se você tiver acesso a registros de conversas ou informações de depuração, verifique se os dados do campo de contexto foram incluídos no contexto da IA.
Boas práticas para campos de contexto
Adicione de 3 a 5 campos de contexto inicialmente e teste. Monitore o uso de tokens e ajuste. Adicione mais campos apenas se a IA precisar deles e os tokens estiverem dentro do orçamento.
Explique o contexto, não os nomes dos campos — O agente lê diretamente os nomes de API, então use a Context Description para transmitir o que o registro representa e como usá-lo (por exemplo, “Este é um contrato de locação ativo; Amount é o aluguel mensal, não o total do contrato”). Isso carrega muito mais significado do que renomear campos individuais.
Ordene os campos dentro da lista — Os campos são apresentados ao agente na ordem em que você os escreve em Field API Names, então coloque os mais importantes primeiro. A Ordem de Classificação se aplica entre registros de configuração inteiros, não entre os campos de um só.
Aproveite as restrições de tipo de registro — Se você tem tipos de registro diferentes com campos diferentes, use restrições de Tipo de Registro para adaptar os campos de contexto por tipo.
Monitore o uso de tokens — Cada campo de contexto adiciona tokens. Depois de adicionar campos de contexto, monitore o consumo de créditos e ajuste se os custos aumentarem inesperadamente.
Removendo campos de contexto
Para parar de usar um campo de contexto:
- Abra o registro do Campo de Contexto
- Clique no botão Excluir
- Confirme a exclusão
O campo é removido imediatamente do contexto do agente. A IA deixa de ter acesso a esse campo nas páginas de registro.
Conjuntos comuns de campos de contexto
- Ordem 1: AccountName (campo relacionado à pesquisa de Conta)
- Ordem 2: StageName (estágio atual do negócio)
- Ordem 3: Amount (valor do negócio)
- Ordem 4: CloseDate (fechamento esperado)
- Ordem 5: Probability (confiança da previsão)
- Ordem 1: CaseNumber (referência)
- Ordem 2: Status (aberto/fechado)
- Ordem 3: Priority (urgência)
- Ordem 4: Description (resumo do problema)
- Ordem 5: CreatedDate (data em que foi registrado)
- Ordem 1: Name (nome da conta)
- Ordem 2: Industry (tipo de setor)
- Ordem 3: AnnualRevenue (indicador de porte da empresa)
- Ordem 4: BillingCity (localização)
Perguntas frequentes
Sim. Qualquer campo acessível pela API do Salesforce pode ser adicionado como campo de contexto. Isso inclui campos de fórmula e de acumulação (roll-up) — basta digitar o nome de API do campo exatamente como aparece no Gerenciador de Objetos.
Se um campo estiver vazio em um registro, a IA o vê como vazio. A IA lida bem com dados ausentes — isso não interrompe a conversa. É seguro incluir campos opcionais.
O consumo de tokens aumenta com mais campos. Uma boa diretriz: de 5 a 10 campos por objeto. Use o Otimizador de Campos de Contexto para identificar os campos mais valiosos e remover os pouco usados.
Não. Os campos de contexto só são carregados em páginas de detalhes de registro. Em listas de visualização ou páginas iniciais, a IA não tem o contexto de um registro específico, portanto os campos de contexto não são carregados.
Considerações de execução
A plataforma aplica dois mecanismos de segurança ao carregar o contexto em tempo de execução, e você deve conhecê-los ao configurar campos de contexto:
- Tratamento de relacionamentos polimórficos. Campos de pesquisa com vários objetos de destino possíveis (por exemplo,
Task.WhoId,Task.WhatId) incluem o Id da pesquisa no contexto, mas não recebem a expansão automática de Nome que as pesquisas de destino único têm. Veja Relacionamentos Polimórficos. - Modo estrito vs. degradado. Por padrão, se algum campo de contexto configurado se tornar inacessível (excluído, renomeado ou bloqueado pela segurança em nível de campo (FLS) para o usuário em execução), a execução do agente é interrompida. O sinalizador em nível de agente Permitir Contexto de Registro Degradado (Allow Degraded Record Context) muda esse comportamento para tolerante a falhas: a plataforma registra um aviso e continua com os campos que conseguiu carregar. Escolha o modo estrito para agentes internos que precisam de contexto completo; escolha o modo degradado para agentes voltados ao cliente ou controlados por API que devem tolerar bem a ausência de campos.
Próximos passos
Use o Otimizador de Campos de Contexto para obter recomendações com tecnologia de IA, veja como o motor de execução lida com relacionamentos polimórficos ou explore as sugestões de contexto para botões de ação rápida.