Recomendações de IA
Este é um guia completo, do zero, para administradores do Salesforce. Ele não presume nenhum conhecimento prévio da REDA AI. Explica o que é o recurso, o vocabulário que você encontrará, por que ele é valioso e todos os passos para configurá-lo, ajustá-lo, verificá-lo, implantá-lo e solucionar problemas. Se você nunca usou a REDA AI, comece por Sobre a REDA AI e Instalação de REDA AI, depois volte aqui.
Ao final deste guia, você terá um agente de recomendações e uma página de registro que mostra recomendações automáticas e consultivas aos seus usuários. Reserve cerca de 15 a 30 minutos para uma primeira configuração. Não é necessário programar — tudo é feito com cliques na Configuração do Salesforce e no Lightning App Builder.
Início rápido (para administradores experientes)
- Crie um agente REDA AI Internal, torne-o somente leitura (remova as ferramentas de ação) e dê a ele instruções curtas de “recomendar próximas ações e riscos”. Ative Allow Degraded Record Context para que ele possa ler o registro. Anote o Agent Id dele.
- Abra a página de registro no Lightning App Builder e arraste o componente REDA AI Recommendations para ela.
- Defina o Agent Id, deixe as outras opções nos valores padrão, clique em Save e em Activate.
O restante desta página explica cada passo em detalhes.
1. O que é a REDA AI e o que é o AI Recommendations?
A REDA AI é um assistente de IA que roda dentro da sua org do Salesforce. Como administrador, você cria agentes — assistentes de IA configuráveis — e os posiciona onde seus usuários trabalham. Normalmente, um agente é reativo: o usuário digita uma pergunta e o agente responde.
O AI Recommendations torna o assistente proativo. Você posiciona um pequeno painel em uma página de registro (por exemplo, uma Oportunidade, um Caso, uma Conta ou um dos seus objetos personalizados). Quando um usuário abre esse registro, o painel automaticamente pede a um agente que revise o registro e sua atividade recente, e apresenta:
- Uma conclusão resumida — duas ou três linhas resumindo a coisa mais importante a saber ou fazer agora.
- Next Actions — as ações mais úteis a seguir, das mais importantes às menos importantes.
- Risks / Red Flags — qualquer coisa que precise de atenção, como um follow-up parado ou um prazo se aproximando.
As recomendações são consultivas e somente leitura — são sugestões para a pessoa agir. O painel nunca altera nenhum dado por conta própria.
2. Conceitos-chave (um glossário rápido)
Alguns termos da REDA AI e do Salesforce são usados ao longo deste guia:
| Termo | O que significa |
|---|---|
| Agente | Um assistente de IA configurável que você configura na REDA AI. Ele tem um nome, um propósito (suas instruções) e um conjunto de capacidades. Veja Entendendo os agentes. |
| ID do Agente | O identificador exclusivo de um agente. Você informa isso no componente para que ele saiba qual agente usar. |
| Canal | Onde um agente tem permissão para ser executado. O AI Recommendations usa o canal Internal (usuários do Salesforce autenticados). Veja Canal Interno. |
| Ferramenta | Uma capacidade que você concede a um agente. As ferramentas de “leitura” consultam dados; as ferramentas de “ação” alteram dados. Para recomendações, mantenha-o somente leitura. Veja Entendendo as Ferramentas. |
| Campos de Contexto | Os campos do registro que você permite que um agente leia para obter contexto. Veja Entendendo os Campos de Contexto. |
| Lightning App Builder | A ferramenta point-and-click do Salesforce para projetar páginas de registro, de aplicativo e iniciais. É aqui que você adiciona o componente. |
| Conjunto de permissões | Um conjunto de permissões que você atribui aos usuários. Os usuários precisam do conjunto de permissões da REDA AI para usar os recursos da REDA AI. |
| Página de registro | A página Lightning exibida quando um usuário abre um registro (por exemplo, uma página de detalhes de Oportunidade). |
3. Por que é útil
- Nada passa despercebido. Follow-ups atrasados, mensagens sem resposta e prazos se aproximando são exibidos automaticamente, direto no registro.
- Decisões mais rápidas. Os usuários recebem um claro “o que fazer a seguir” sem precisar vasculhar listas relacionadas, histórico de atividades e arquivos.
- Boas práticas consistentes. Todos — inclusive membros novos da equipe — veem a mesma orientação de alta qualidade sobre como conduzir um registro.
- Funciona em qualquer lugar. O mesmo componente pode ser usado em qualquer objeto padrão ou personalizado, sem desenvolvimento sob medida.
- Fala o idioma dos seus usuários. As recomendações são retornadas automaticamente no idioma do Salesforce de cada usuário.
- Vendas — Oportunidade: “Cobre o comprador por uma resposta — três e-mails de follow-up ficaram sem resposta,” e um alerta: “Um chamado de suporte registrado em abril ainda está aberto.”
- Atendimento — Caso: “Envie uma atualização ao cliente — nenhuma atividade em 5 dias,” e um alerta: “O prazo de resolução é amanhã.”
- Qualquer objeto personalizado: próximos passos e riscos específicos do seu processo, definidos pelo agente que você configurar.
4. Antes de começar (pré-requisitos)
Confirme cada um dos itens a seguir antes de configurar:
| Requisito | Como confirmar / onde |
|---|---|
| A REDA AI está instalada e ativada | Veja Instalação de REDA AI. |
| Seus usuários têm acesso à REDA AI | Atribua o conjunto de permissões da REDA AI aos usuários que devem ver as recomendações. Veja Acesso ao App e Permissões. |
| Você pode editar páginas Lightning | Você precisa da permissão “Customize Application” (padrão para Administradores do Sistema). |
| Um agente de recomendações | Reutilize um agente interno, ou crie um no Passo 1 abaixo. |
5. Passo 1 — Criar ou escolher o agente de recomendações
O painel não gera recomendações por conta própria — ele usa um agente da REDA AI que você configura. O agente decide o que recomendar e como formular a recomendação. Você pode reutilizar um agente interno existente, mas recomendamos um dedicado para que possa ajustá-lo de forma independente.
-
Abra a REDA AI e comece um novo agente
No Iniciador de aplicativos (o ícone de grade, no canto superior esquerdo), abra a REDA AI, vá até Definições de Agente e crie um novo agente. Detalhes completos: Criando um Agente.
-
Dê um nome claro e anote o Agent Id
Dê a ele um Display Name reconhecível (por exemplo, “Oportunidade Recommendations”). Anote o Agent Id — você vai digitá-lo no componente no Passo 3.
-
Defina o canal como Internal
As recomendações são executadas para usuários do Salesforce autenticados em páginas de registro, então defina o Channel do agente como Internal. Veja Configuração do agente.
-
Torne-o somente leitura
Como as recomendações são consultivas, remova quaisquer ferramentas de “ação” (criar, atualizar, excluir, enviar, agendar e afins) para que o agente nunca possa alterar dados ao gerar sugestões. Você pode manter ferramentas somente leitura caso queira que ele consulte registros relacionados. Veja Configuração de Ferramentas.
ImportanteManter o agente de recomendações somente leitura é a configuração de segurança essencial. Ela garante que simplesmente abrir um registro e gerar recomendações nunca possa modificar seus dados.
-
Escreva instruções curtas e focadas em ação
Diga ao agente para recomendar o que fazer, em vez de descrever o registro (os usuários já podem ver o registro). Mantenha os pontos em uma linha cada. Você pode adaptar este exemplo:
Exemplo de instrução do agente (adapte ao seu processo)“Revise este registro e sua atividade recente e recomende as melhores próximas ações, sinalizando quaisquer riscos. Comece com uma conclusão resumida de duas a três linhas, depois uma lista curta de Next Actions e uma lista curta de Risks / Red Flags. Mantenha cada item em uma linha. Não resuma o registro — recomende o que fazer.”
Veja Prompts personalizados por agente e Práticas recomendadas de prompts.
-
Permita que o agente veja o registro
Para que o agente possa ler os campos do registro, adicione Campos de contexto para o objeto, ou ative Allow Degraded Record Context no agente. A segunda opção é a mais rápida — ela permite que o agente leia os campos padrão do registro sem nenhuma configuração por objeto.
-
Ative o agente
Certifique-se de que o agente esteja Active. Veja Ativação e Desativação de Agentes.
6. Passo 2 — Adicionar o componente a uma página de registro
-
Abra um registro do objeto desejado
Por exemplo, abra qualquer Oportunidade a partir da guia Oportunidades.
-
Entre no editor de páginas
Clique na engrenagem de Configuração (canto superior direito) › Editar Página. O Lightning App Builder abre para essa página de registro.
-
Encontre o componente
No painel Components à esquerda, use a caixa de busca e digite “REDA”, ou role até a seção Custom, e localize REDA AI Recommendations.
-
Arraste-o para a página
Solte-o onde quiser. Uma região larga perto do topo dá destaque para que os usuários o notem. Você pode posicioná-lo na coluna principal ou em uma barra lateral — ele se adapta à largura.
7. Passo 3 — Configurar o componente
Com o componente selecionado na área de trabalho, defina suas propriedades no painel à direita. Cada propriedade é explicada abaixo.
| Propriedade | O que faz | Recomendado |
|---|---|---|
| Agent Id | O agente de recomendações a usar (o Agent Id do Passo 1). É a única configuração obrigatória. | Seu agente de recomendações |
| Generate on Load | Ativado: as recomendações aparecem automaticamente ao abrir o registro. Desativado: os usuários veem um botão Generate recommendations e escolhem quando executá-lo. | Ativado para páginas de alto valor; desativado para torná-lo opcional |
| Panel Title | Uma substituição opcional do título do painel. | Deixe em branco para usar o título padrão |
| Prompt (optional) | Uma substituição opcional e pontual da instrução para este posicionamento. Deixe em branco para usar as próprias instruções do agente. | Em branco (mantém o comportamento consistente) |
| Scan Emails | Inclui e-mails recentes do registro na análise. | Ativado |
| Scan Tasks | Inclui tarefas recentes do registro. | Ativado |
| Scan Events | Inclui eventos recentes e futuros do registro. | Ativado |
| Scan Files & Attachments | Inclui arquivos/anexos recentes do registro. | Ativado |
| Scan Notes | Inclui notas recentes do registro. | Ativado |
| Scan Field History | Inclui mudanças recentes no histórico de campos (requer rastreamento de histórico de campos habilitado no objeto). | Ativado onde for útil |
Desative uma opção de varredura quando uma fonte não for relevante para aquele objeto, ou para manter a análise focada. Por exemplo, em um Caso você pode varrer e-mails e tarefas, mas não arquivos.
8. Passo 4 — Salvar e ativar a página
- Clique em Save.
-
Ative a página se solicitado. Você pode:
- Defini-la como Org Default (todos a veem), ou
- Atribuí-la a um app, perfil e/ou tipo de registro específicos usando as opções App, Record Type, and Profile. Isso permite, por exemplo, mostrar recomendações apenas para o app de Vendas.
- Clique em Back para retornar ao registro. O painel aparece e (se Generate on Load estiver ativado) começa a produzir recomendações.
9. Verifique se está funcionando
Percorra esta lista de verificação rápida em um registro real que tenha alguma atividade recente:
- ✓ O painel REDA AI Recommendations aparece na página de registro.
- ✓ Com Generate on Load ativado, uma conclusão resumida aparece em poucos segundos; com ele desativado, aparece um botão Generate recommendations que funciona ao ser clicado.
- ✓ View details abre uma janela com as listas completas de Next Actions e Risks.
- ✓ Os ícones de joinha (curtir/não curtir) no cabeçalho respondem ao serem clicados.
- ✓ O ícone de atualizar regenera as recomendações e atualiza o horário “atualizado em”.
- ✓ O conteúdo reflete a atividade real do registro (não é um preenchimento genérico).
Se alguma etapa falhar, veja Solução de problemas abaixo.
10. O que seus usuários verão
- Um painel com título e uma breve conclusão resumida (duas a três linhas), para nunca sobrecarregar a página.
- Um link View details que abre uma janela com as listas completas de Next Actions e Risks / Red Flags.
- Ícones de joinha (curtir/não curtir) no cabeçalho do painel para que os usuários possam avaliar o quão úteis foram as recomendações.
- Um ícone de atualizar para regenerar sob demanda, e um horário “atualizado em” mostrando quando as recomendações foram produzidas.
- Se Generate on Load estiver desativado, um botão Generate recommendations em vez de resultados automáticos.
11. Exemplo prático — Oportunidade
Veja a seguir um exemplo completo que você pode reproduzir.
- Agente: Crie um agente Internal chamado “Oportunidade Recommendations”, somente leitura, com a instrução de exemplo do Passo 1, e com Allow Degraded Record Context ativado.
- Posicionamento: Na página de registro da Oportunidade, arraste o componente REDA AI Recommendations para o topo da coluna principal.
- Configurações: Defina Agent Id como o novo agente; deixe Generate on Load ativado e todas as opções de varredura ativadas.
- Salve e ative a página para o app de Vendas.
Conclusão: “Esta negociação está estagnada — três follow-ups estão atrasados e o comprador não responde há duas semanas.”
Next Actions:
- Ligue para o comprador hoje — os follow-ups por e-mail ficaram sem resposta.
- Confirme a data de entrega — a data de fechamento é em 8 dias.
Risks / Red Flags:
- Contato único — toda a atividade é com uma única pessoa.
(Seus resultados reais dependem do registro e das instruções do seu agente.)
12. Escolhendo o que a IA varre
As opções de varredura controlam qual atividade recente o agente considera. Uma entrada mais rica geralmente produz recomendações mais precisas, mas você pode desativar fontes que não sejam relevantes para manter o foco (e a resposta rápida). Orientações:
- E-mails / Tarefas / Eventos — geralmente os sinais mais valiosos de momentum ou estagnação. Mantenha ativados.
- Arquivos e anexos — úteis quando documentos são importantes (contratos, propostas). Desative se o objeto raramente tiver arquivos.
- Notas — úteis quando sua equipe registra notas nos registros.
- Histórico de campos — útil para identificar mudanças (por exemplo, uma data de fechamento que está se atrasando). Requer que o rastreamento de histórico de campos esteja habilitado no objeto.
13. Automático vs. sob demanda
A opção Generate on Load decide se as recomendações são executadas automaticamente. Ative-a para páginas em que as recomendações são sempre úteis (os usuários obtêm valor sem nenhum clique). Desative-a quando preferir que os usuários solicitem recomendações explicitamente — eles verão um botão Generate recommendations em vez disso.
14. Feedback — e melhorando as recomendações ao longo do tempo
Os ícones de joinha (curtir/não curtir) no cabeçalho do painel permitem que os usuários informem se uma recomendação foi útil. Esse feedback é armazenado junto com a conversa. Use-o como um sinal: se determinadas recomendações forem consistentemente marcadas como não úteis, refine as instruções do agente (Passo 1) — por exemplo, peça que ele seja mais específico, ou que priorize de forma diferente. Pequenos ajustes nas instruções geralmente produzem resultados visivelmente melhores.
15. Idiomas
As recomendações são retornadas automaticamente no idioma do Salesforce de cada usuário — não há configuração por idioma. Um usuário cujo Language do Salesforce (Settings › Language & Time Zone) esteja definido como francês verá as recomendações em francês. Veja Agentes multilíngues para saber como o tratamento de idiomas funciona em toda a REDA AI.
16. Boas práticas
- Use um agente dedicado e somente leitura — mantém as recomendações consultivas e ajustáveis de forma independente.
- Recomende, não resuma — concentre o agente em próximas ações e riscos.
- Mantenha-o enxuto — varra apenas as fontes que importam para o objeto.
- Escolha o comportamento de carregamento certo — automático para páginas sempre úteis, sob demanda nas demais.
- Dê ao agente acesso ao registro — Context Fields ou Allow Degraded Record Context.
- Revise o feedback regularmente e refine as instruções do agente.
- Use um agente separado por objeto quando objetos diferentes precisarem de orientações diferentes.
17. Implantando com segurança
- Construa e teste em um sandbox primeiro. Configure o agente e a página em um sandbox e confirme que as recomendações são precisas e úteis com dados realistas.
- Faça um piloto com um grupo pequeno. Ative a página para um app ou perfil (por exemplo, uma única equipe de vendas) e colete feedback pelos ícones de curtir/não curtir e diretamente dos usuários.
- Refine o agente. Ajuste as instruções e as opções de varredura com base no que você aprender.
- Implante amplamente. Quando estiver satisfeito, ative a página como Org Default ou para os apps/perfis relevantes.
Veja Boas práticas para orientações gerais de implantação da REDA AI.
18. Solução de problemas
| Sintoma | Causa provável | Solução |
|---|---|---|
| O componente não aparece na lista do App Builder | Você não está editando uma página de registro, ou o editor está com cache | Certifique-se de estar editando uma página de registro; atualize o App Builder. |
| O painel diz que o Agent Id é obrigatório / não configurado | A propriedade Agent Id está em branco | Defina Agent Id com o seu agente de recomendações e salve. |
| “No active Context Field configuration found” | O agente não consegue ler os campos do registro | Adicione Campos de contexto para o objeto, ou ative Allow Degraded Record Context no agente. |
| Um erro em vez de recomendações | O usuário não tem acesso à REDA AI, ou o agente está inativo/não é Internal | Atribua o conjunto de permissões da REDA AI; confirme que o agente está Active e no canal Internal. |
| As recomendações parecem rasas ou genéricas | Pouca atividade recente, ou fontes-chave desativadas | Ative as opções de varredura relevantes; as recomendações são mais ricas em registros com e-mails, tarefas e eventos recentes. |
| As recomendações são longas demais / parecem um resumo | As instruções do agente não estão focadas em ação | Ajuste o prompt do agente para começar com uma conclusão curta e pontos de ação de uma linha (veja o Passo 1). |
| As recomendações são lentas | Um volume muito grande de atividade sendo varrido | Desative as fontes que você não precisa, ou defina Generate on Load como desativado para que sejam executadas sob demanda. |
| Idioma incorreto | A configuração de idioma do Salesforce do usuário | As recomendações seguem o Language de cada usuário (Settings › Language & Time Zone). |
Perguntas frequentes
Não. As recomendações são apenas consultivas. Configure o agente como somente leitura (remova as ferramentas de ação) para que gerar recomendações nunca grave dados.
Sim — coloque-o em qualquer página de registro, padrão ou personalizada, e aponte-o para o seu agente. Não é necessário desenvolvimento específico por objeto.
Sim. Crie um agente separado por objeto (por exemplo, um para Oportunidades e outro para Casos) e aponte o componente de cada objeto para o agente correspondente.
Sim. Desative Generate on Load; os usuários então geram recomendações sob demanda com um botão.
No idioma do Salesforce de cada usuário, automaticamente. Veja Agentes multilíngues.
Qualquer usuário que possa abrir a página de registro e tenha acesso à REDA AI. O agente só lê dados que o usuário em execução já tem permissão para ver.
Não. Tudo é feito por cliques — criar o agente, adicionar o componente e configurar as opções.
Sim — defina a propriedade Panel Title. Deixe em branco para usar o título padrão.
Eles registram se uma recomendação foi útil, armazenado junto com a conversa para que você possa analisar como as recomendações estão sendo recebidas e refinar o agente ao longo do tempo.
Próximos passos
Configure o agente em Criando um Agente e Configuração do agente, controle o que ele pode fazer em Configuração de Ferramentas, e forneça a ele os dados do registro de que precisa em Adicionando Campos de Contexto.