Otimizador de campos de contexto
Financiamento e uso de IA
IA incluída usa créditos REDA. Traga sua própria IA usa a conta de provedor da sua organização, cobrada diretamente pelo provedor. A licença define um modelo para toda a organização. Nos dois, o REDA AI governa ferramentas e ações configuradas no Salesforce. Configure a licença e as contas de IA.
Com conta própria, o modelo escolhido define os níveis de raciocínio profundo e recursos disponíveis. Confira os níveis e avisos no seletor AI Account; não presuma que todos os provedores aceitam a mesma combinação. Ferramentas administrativas e processamento de documentos usam a conexão padrão da organização. Configure o padrão e teste o fluxo.
O que o Otimizador configura
Cada registro de campo de contexto na REDA AI controla como um agente específico lê um objeto específico. O Otimizador recomenda valores para quatro campos desse registro:
| Campo | Finalidade |
|---|---|
| Nomes de API de Campo | Lista separada por vírgulas dos campos que o agente verá para este objeto, em ordem de prioridade. |
| Campos máximos | Limite rígido (1–25) de quantos campos são carregados em tempo de execução — útil quando um objeto tem centenas de campos e apenas alguns poucos são relevantes. |
| Incluir nomes relacionados | Quando ativado, os campos Name de relacionamentos de lookup são incluídos automaticamente junto com seus campos Id, de forma que o agente veja “Proprietário: Jane Smith” em vez de apenas um Id. |
| Descrição do contexto | Descrição em texto livre sobre a finalidade deste contexto. Ajuda o modelo a entender que tipo de objeto está vendo e o que fazer com ele. |
Consulte Adicionando campos de contexto para conhecer o ciclo de vida completo de um registro de campo de contexto.
Como o Otimizador funciona
-
Abra o registro
O Otimizador é iniciado a partir de qualquer registro de campo de contexto — geralmente logo após a criação de um novo registro para um novo emparelhamento agente/objeto.
-
Adicione uma instrução
Uma instrução curta opcional permite orientar o otimizador com indicações específicas da sua organização — por exemplo, focar em operações em vez de finanças, ou preferir menos campos para manter os créditos baixos. A caixa aceita até 5.000 caracteres, mas apenas os primeiros 1.000 chegam ao modelo — mantenha a instrução curta e coloque o mais importante primeiro.
-
A plataforma compõe a solicitação
A plataforma envia ao modelo uma solicitação estruturada contendo a definição do agente, os prompts personalizados do agente, as ferramentas atribuídas ao agente, o canal, o esquema do objeto de destino e a configuração atual do campo de contexto.
-
As recomendações retornam
O modelo devolve uma lista recomendada de Field API Names, um limite de Max Fields, um indicador de Include Related Names, uma Context Description e um breve resumo do motivo pelo qual essas escolhas se adequam ao agente.
-
Revise e salve
Uma comparação lado a lado mostra o valor atual ao lado da recomendação para cada um dos quatro campos. Aceite o conjunto completo, aceite campos individuais ou edite antes de salvar.
O que entra na recomendação
O Otimizador não faz sugestões às cegas baseando-se apenas no esquema do objeto. A solicitação enviada ao modelo inclui:
- A persona, o nome de exibição e o canal do agente
- Os prompts personalizados do agente (truncados a um comprimento razoável)
- As ferramentas atribuídas ao agente (até um pequeno limite das mais relevantes)
- Os metadados de campo do objeto de destino — tipos, rótulos, listas de seleção, relacionamentos
- Os valores atuais do registro de campo de contexto
- Orientações específicas do canal — um agente de canal interno recebe recomendações diferentes das de um widget voltado para o cliente
O resultado são recomendações sensíveis ao agente: o mesmo objeto pode receber uma lista de campos diferente para um agente focado em vendas do que para um focado em atendimento, mesmo na mesma organização.
A visualização de comparação
Após a execução, a interface exibe uma tabela de comparação de quatro linhas — uma linha para cada campo que o Otimizador pode alterar:
| Campo | Atual | Recomendação |
|---|---|---|
| Context Description | … | … |
| Field API Names | … | … |
| Max Fields | … | … |
| Include Related Names | … | … |
Acima da tabela, um breve resumo do modelo explica o raciocínio — o que a recomendação priorizou, o que ela deixou em segundo plano, e por quê. Leia-o antes de salvar.
Custo em créditos e tempo
Executar o Otimizador é uma única chamada ao modelo. O custo em créditos cresce com o tamanho da entrada (principalmente os prompts do agente e o esquema do objeto de destino) e com o tamanho da saída. A plataforma mostra os créditos realmente consumidos após a execução.
Com IA incluída, uma chamada que atinge o tempo limite pode gerar a cobrança documentada de 20 créditos. Com Traga sua própria IA, a REDA não desconta uma franquia de créditos; a cobrança é controlada pelo provedor. Confira o uso registrado e o erro antes de tentar novamente. O tempo limite, sozinho, não identifica a causa.
Consulte Otimização do uso de créditos para conhecer o modelo de custo mais amplo.
Um registro de campo de contexto por vez
Cada execução do Otimizador é limitada a um único registro de campo de contexto — um agente, um objeto. Para otimizar um agente que lê vários objetos, execute o Otimizador uma vez para cada registro de campo de contexto desse agente. Você pode fazer isso em qualquer ordem; as recomendações de um registro não dependem das dos demais.
Quando executá-lo
- Logo após criar um novo registro de campo de contexto. O Otimizador transforma um registro em branco em uma configuração inicial sensata com um único clique.
- Após editar o agente de forma significativa. Mudanças na persona, reescritas de prompts ou novas ferramentas alteram o contexto que o agente realmente precisa.
- Após mudanças no esquema. Quando novos campos são adicionados a um objeto, o Otimizador pode sugerir incluí-los.
- Ao reduzir custos. Executar o Otimizador novamente com uma instrução explícita como “reduza a quantidade de campos pela metade” produz uma configuração mais enxuta.
O que o Otimizador não faz
- Não altera quais registros de campo de contexto existem. O conjunto de emparelhamentos (agente, objeto) é uma decisão sua; o Otimizador apenas edita os quatro campos configuráveis de um registro que você já escolheu otimizar.
- Não aplica a segurança em nível de campo (FLS). O Otimizador recomenda campos úteis para a finalidade do agente. Em tempo de execução, a FLS continua sendo aplicada — os usuários veem apenas os campos que têm permissão para ler.
- Não aplica automaticamente. As recomendações são consultivas. Nada muda até você clicar em Salvar na visualização de comparação.
Boas práticas
Torne a persona específica antes de otimizar. As recomendações do Otimizador são tão focadas quanto a definição do agente que ele lê. Uma persona vaga produz listas de campos genéricas. Refine a persona primeiro; depois otimize.
Use a caixa de instruções para dar contexto da organização. Uma nota curta como “exclua campos apenas internos” ou “mantenha até 12 campos por custo” muda significativamente a recomendação.
Leia o resumo, não apenas a tabela. O resumo explica por que os campos foram escolhidos ou descartados. Esse raciocínio costuma revelar aspectos que você deveria mudar no próprio agente, não apenas no contexto.
Execute novamente com uma instrução refinada após observar conversas reais. A caixa de instrução opcional orienta a recomendação; uma segunda execução com indicações mais precisas produz recomendações mais precisas do que uma primeira execução sem nenhuma orientação.
Combine com o Depurador de conversas. Depois de aplicar uma recomendação, execute uma conversa real e use o Depurador para ver quais campos o agente realmente usou. Os campos que ele ignorou são candidatos a remoção da próxima vez.
Perguntas frequentes
Não. Ele só edita os quatro campos configuráveis de um registro de campo de contexto existente. Para otimizar um novo emparelhamento (agente, objeto), crie primeiro o registro de campo de contexto e, em seguida, execute o Otimizador.
Cada execução é limitada a um único registro. Para um agente com vários registros de campo de contexto, execute o Otimizador em cada um por vez — as execuções são independentes e podem ser feitas em qualquer ordem.
A segurança em nível de campo é aplicada em tempo de execução, quando o agente realmente lê o contexto. O Otimizador recomenda campos úteis para a finalidade do agente; ele não verifica o perfil de FLS de cada usuário. Dois usuários executando o mesmo agente verão apenas os campos recomendados que cada um tem permissão para ler.
Sim. A visualização de comparação mostra a recomendação ao lado do valor atual. Você pode aceitar a recomendação como está, editar qualquer um dos quatro campos ou pular a otimização por completo.
O Otimizador pode incluir campos polimórficos (como WhoId ou WhatId de Task) na lista de campos, mas a expansão automática de Name em tempo de execução se limita a lookups de destino único. Consulte Relacionamentos polimórficos para conhecer o comportamento em tempo de execução e a configuração Allow Degraded Record Context.
Normalmente, alguns segundos. Organizações maiores, com muitos campos no objeto de destino, levam um pouco mais porque o esquema enviado ao modelo é maior.
O registro de campo de contexto é um registro do Salesforce — o histórico de campos padrão (quando habilitado) permite ver os valores anteriores, e você pode colá-los de volta manualmente. Não há um botão automático de “reverter última otimização”.
Próximos passos
Leia Relacionamentos polimórficos para saber como o tempo de execução lida com campos como WhoId e WhatId, ou Sugestões de contexto para adicionar chips de ação rápida à interface de chat.