REDA AI — Monsoon 2026 (v1.15000)
Esta versão trata principalmente do custo de execução de um agente. Duas novas opções por agente permitem trocar um pouco de qualidade por um agente bem mais barato, ou manter o contexto do agente ativo entre mensagens para que uma conversa em pausa não seja cobrada do zero. Outras quatro opções permitem limitar o orçamento de um único agente sem alterar nada em toda a organização. Além disso, um agente de API não assistido pode ignorar as permissões de objeto e de campo — sem nunca ver um registro que antes não podia ver —, os e-mails podem levar os seus próprios campos no registro que criam, e uma falha que podia descartar entradas do registro de incidentes silenciosamente foi corrigida.
000) ou em um patch (001 em diante).
Como obter esta versão
Atualize o pacote REDA AI na sua organização da mesma forma que instala qualquer pacote gerenciado. Para confirmar que você a tem, abra Configuração → Pacotes instalados e verifique se a coluna Número da versão ao lado de REDA AI mostra 1.15000 ou superior. Tudo o que aparece abaixo se refere a essa versão; se a coluna ainda mostrar 1.14 ou 1.14001, a atualização não foi concluída e as opções descritas aqui ainda não existirão.
Esta versão também traz tudo o que foi publicado no patch 1.14001. Se você atualizou direto da 1.14, essas mudanças também são novas para você e estão descritas aqui junto com o restante.
O que a atualização não faz por você
Uma atualização de pacote gerenciado do Salesforce é deliberadamente conservadora: ela não sobrescreve configurações que você alterou. Isso protege a sua organização, mas significa que um administrador tem trabalho manual em cada organização que atualiza. Se você pular isso, as novas opções existem, mas ninguém consegue vê-las nem usá-las.
Todos os campos novos desta versão
Os nove estão no registro Definição de agente, onde você configura um agente. A coluna Seção indica onde o campo fica no layout da REDA; coloque-o no mesmo lugar no seu para que os dois coincidam.
| Campo | Seção do layout | O que faz |
|---|---|---|
| Nível de processamento | Desempenho e controle de custos | Padrão (predefinido) ou Eficiente. Eficiente consome cerca de 30% menos créditos para o mesmo trabalho. |
| Cache aprimorado | Desempenho e controle de custos | Mantém o contexto estável do agente ativo por uma hora em vez de cinco minutos. |
| Tokens máx. de saída | Desempenho e controle de custos | Limita o tamanho de uma resposta deste agente. Em branco usa o valor da organização. |
| Orçamento de tokens do histórico | Desempenho e controle de custos | Quanto da conversa anterior é reenviado a cada turno. Em branco usa o valor da organização. |
| Buscas na web máx. | Desempenho e controle de custos | Quantas buscas na web este agente pode fazer por turno. Em branco usa o valor da organização. |
| Profundidade máx. de continuação | Controles externos | Até onde um agente pode continuar trabalhando entre turnos nos canais externo e de comunidade. Em branco usa o valor da organização. |
| Contexto de execução | Contexto e persona, logo abaixo de Canal | Usuário (predefinido) ou Sistema. Só tem efeito em um agente do canal API — consulte Permitir que um agente de API não assistido ignore as permissões de objeto e de campo. |
| Máximo de ferramentas (do patch 1.14001) | Controles externos, depois de Modo de ferramentas | Quantas ferramentas este agente oferece por turno. Em branco equivale a 25. |
| Máximo de iterações de ferramentas (do patch 1.14001) | Controles externos | Quantas etapas o agente pode dar em um turno. Em branco equivale a 6. |
O que um administrador precisa fazer, em cada organização
1. Coloque os campos no seu layout. Vá em Configuração → Gerenciador de objetos → REDAAI Agent Definition → Layouts de página, abra o layout que a sua equipe realmente usa, arraste cada campo da paleta para a seção indicada na tabela acima e clique em Salvar. Se você nunca personalizou este layout, os campos já estarão lá e você pode pular esta etapa — mas verifique em vez de supor.
2. Dê acesso aos campos aos seus usuários. Os dois conjuntos de permissões do pacote já trazem os nove: REDAAI Admin pode editá-los e REDAAI User pode lê-los. Isso basta se os seus usuários tiverem esses conjuntos atribuídos. Se a sua organização usa os próprios conjuntos de permissões ou perfis — como a maioria — você precisa adicionar os campos lá: Configuração → Conjuntos de permissões → seu conjunto → Configurações de objeto → REDAAI Agent Definition → Editar, e marque Leitura (e Edição para administradores) em cada campo.
3. Reaplique o seu limite de iterações em cada agente. A opção Máximo de iterações de ferramentas de toda a organização não é mais usada e o seu cartão foi removido do console de administração. Se você a tinha alterado em relação ao padrão, configure-a em cada agente que precise de um valor diferente. Os agentes que você deixar em branco se comportam como 6, que é o valor com que a opção da organização foi publicada.
4. Não mexa em Contexto de execução a menos que saiba que precisa. O padrão, Usuário, é o correto para qualquer agente com quem uma pessoa converse. Altere-o apenas em um agente de API não assistido e leia antes a seção correspondente.
Novidades
Duas novas formas de reduzir o custo de execução de um agente
Nível de processamento escolhe o perfil de processamento que o agente usa. Padrão é o predefinido e é o que os seus agentes usam hoje. Eficiente faz o mesmo trabalho com cerca de 30% menos créditos, com desempenho um pouco menor em raciocínios longos de várias etapas. Encaixa bem em agentes de alto volume e tarefas diretas — responder perguntas rotineiras, consultar registros, capturar dados simples — e encaixa mal em um agente que faz análises complexas. Deixar o campo em branco se comporta exatamente como Padrão, então nenhum agente existente muda até você optar por isso.
Cache aprimorado mantém o contexto estável do agente — as instruções e as ferramentas que ele pode usar — ativo por uma hora em vez de cinco minutos. Isso importa porque conversas reais têm pausas: alguém pergunta, é interrompido e volta dez minutos depois. Sem essa opção, a pausa descarta o contexto em cache e a mensagem seguinte é cobrada como se a conversa tivesse acabado de começar. Com ela, a conversa é retomada de forma barata.
Limites de orçamento por agente que substituem os padrões da organização
Quatro opções que antes eram de toda a organização agora podem ser definidas em um único agente: Tokens máx. de saída (o tamanho de uma resposta), Orçamento de tokens do histórico (quanto da conversa anterior é reenviado a cada turno), Profundidade máx. de continuação e Buscas na web máx. Deixe qualquer uma em branco e o agente continua usando o valor da organização, então nada muda até você definir uma de propósito.
A que mais afeta os créditos é o Orçamento de tokens do histórico. A cada turno parte da conversa recente é reenviada para o agente lembrar do que foi dito; quanto maior esse orçamento, mais custa cada mensagem. Reduzi-lo em um agente conversacional de alto volume costuma ser a maior economia disponível — mas se reduzir demais o agente começa a esquecer o contexto anterior: baixe aos poucos e acompanhe a qualidade.
Permitir que um agente de API não assistido ignore as permissões de objeto e de campo
Um agente do canal API é executado sozinho — acionado por outro sistema, não por uma pessoa — então age como um usuário de integração ou automação, e não como quem perguntou. Esse usuário precisa de permissão em todos os objetos e campos que o agente possa tocar e, como um agente do REDA AI decide o que consultar a partir do contexto, nem sempre é possível saber essa lista de antemão. O resultado é um agente que funciona nos testes e depois falha em um registro que ninguém previu.
Contexto de execução resolve isso. Defina-o como Sistema em um agente do canal API e as ferramentas dele deixam de aplicar as permissões de objeto e de campo.
Três limites o delimitam, e vale conhecê-los antes de usar:
- Só funciona no canal API. Defina-o em um agente de qualquer outro canal e ele é ignorado. Agentes com quem as pessoas conversam são executados como aquela pessoa, onde as permissões dela são exatamente o limite certo; agentes no seu site público são executados como convidado, onde ignorar permissões não seria seguro.
- Só um administrador pode ativá-lo. É um campo do registro Definição de agente, editável pelo conjunto de permissões REDAAI Admin. O agente não pode ativá-lo sozinho, e nenhuma instrução escrita em um prompt pode alterá-lo.
- Toda ação com permissões elevadas é registrada. Sempre que uma ferramenta é executada ignorando permissões, uma entrada é escrita no registro de incidentes com a ferramenta, o objeto de destino e o usuário com que foi executada — para que você sempre possa responder “o que este agente fez com acesso elevado?”.
Deixe em Usuário a menos que você tenha um agente de API não assistido falhando por permissões. Não é uma opção de desempenho e não há benefício em ativá-la por precaução.
Grave os seus próprios campos nos e-mails que um agente envia
Quando um agente envia um e-mail, o Salesforce o registra junto ao registro relacionado. Agora você pode fazer o agente gravar os seus próprios campos personalizados nesse registro de e-mail ao mesmo tempo — normalmente para marcar qual agente o enviou, e assim poder analisar o volume por agente depois. A ferramenta do agente também passa a devolver o Id do registro de e-mail.
Duas coisas a preparar antes:
- Crie o campo personalizado no objeto Mensagem de email (Configuração → Gerenciador de objetos → Mensagem de email → Campos e relacionamentos → Novo).
- Dê acesso a esse campo ao usuário do agente. Se o campo não estiver visível para o usuário com que o agente é executado, o valor simplesmente não será salvo — o e-mail é enviado mesmo assim e nada parece dar errado. Este é o motivo mais comum de a marcação não aparecer.
Só os seus próprios campos personalizados podem ser gravados assim. Campos padrão, como o assunto ou o destinatário, são recusados de propósito, porque alterá-los quebraria o encadeamento que o Salesforce usa para relacionar as respostas à mensagem original.
Limite quantas ferramentas e quantas etapas um agente usa por turno
Publicado no patch 1.14001; novo para você se atualizou a partir da 1.14.
Máximo de ferramentas limita quantas ferramentas um agente oferece por turno. Cada ferramenta que ele pode alcançar é descrita a ele em toda mensagem, então uma lista longa custa créditos a cada turno, sendo usada ou não. O padrão mudou: antes os agentes eram limitados a 20 e agora em branco equivale a 25, então um agente com mais de 20 ferramentas elegíveis passa a carregar até cinco a mais por turno — um pouco mais capaz, um pouco mais caro.
Máximo de iterações de ferramentas limita quantas etapas o agente pode dar dentro de um turno ao encadear ferramentas. Em branco equivale a 6. Consulte a etapa 3 de O que um administrador precisa fazer — a opção da organização que ela substitui não é mais lida.
Correções
O registro de incidentes não perde mais entradas
Os incidentes são gravados em lotes. Antes, uma única entrada malformada podia fazer com que o lote inteiro fosse descartado — inclusive registros válidos de erros reais de produção — sem deixar entrada no registro e sem enviar notificação. Um erro podia, portanto, desaparecer por completo por causa de uma mensagem informativa sem relação gravada no mesmo momento. Agora as entradas são salvas individualmente, uma entrada recusada é ela própria registrada, e incidentes válidos sempre sobrevivem. Nenhuma ação é necessária.
O assistente não descreve mais uma ação que você não confirmou
Quando um agente propõe uma ação que precisa da sua confirmação, ele agora a relata como ainda não realizada até você confirmar. Antes o assistente podia descrever a ação no passado — dizendo que um e-mail havia sido enviado — enquanto ainda aguardava aprovação, e a afirmação permanecia mesmo se você cancelasse depois.
Os cartões de confirmação agora mostram os detalhes das ações personalizadas
Um cartão de confirmação de uma ação criada pela sua própria equipe podia aparecer em branco, deixando você aprovar algo sem nada para ler. Esses cartões agora listam os valores que a ação vai usar.
Correções menores
- Os links para registros dentro de um aviso agora são clicáveis, em vez de mostrar um código com um Id de registro.
- As frases nas respostas do assistente não ficam mais coladas sem separação.
- (Patch 1.14001) A ferramenta de consulta de registros dizia ao agente que ele podia pedir até 50 campos quando o limite real era 25; agora informa 25, então o agente para de pedir mais do que pode obter.
- (Patch 1.14001) A exibição de lista Todos — agentes inativos mostrava agentes ativos. O filtro está corrigido.
- (Patch 1.14001) Cinco mensagens de erro que sempre apareciam em inglês agora aparecem no idioma do leitor.
Melhorias
As ferramentas personalizadas podem saber em qual canal estão sendo executadas
Se a sua equipe criou as próprias ferramentas para o REDA AI, elas agora recebem o canal em que o agente está sendo executado. Uma ferramenta pode usar essa informação para se comportar corretamente quando roda de forma não assistida em vez de para uma pessoa conectada — que é o que a plataforma exige quando a automação age por conta própria. As ferramentas personalizadas existentes não são afetadas e não precisam de alteração; a informação simplesmente fica disponível para as que quiserem usá-la.
Como verificar se a atualização funcionou
- Confirme a versão. Configuração → Pacotes instalados → REDA AI mostra 1.15000 ou superior.
- Abra qualquer agente. Vá ao aplicativo REDA AI → Definições de agente → abra uma. Você deve ver Nível de processamento e Cache aprimorado na seção Desempenho e controle de custos, e Contexto de execução logo abaixo de Canal. Se não os vir, a etapa de layout ou de acesso a campos não foi feita.
- Verifique se um usuário não administrador também os vê. É a etapa mais pulada. Entre como — ou peça a — alguém com um conjunto de permissões de usuário comum e confirme que os mesmos campos aparecem para ele.
- Não mude nada ainda. Todas as novas opções mantêm o comportamento atual, então uma atualização correta parece não ter mudado nada até você optar por ativá-las.
Perguntas frequentes
Preciso mudar algo para os meus agentes continuarem funcionando?
Não. Todas as novas opções ficam em branco por padrão, e em branco significa “continue como
antes”. A única coisa a verificar é a opção da organização Máximo de iterações de ferramentas, que
não é mais lida — consulte a etapa 3 acima.
O Eficiente vai piorar o meu agente?
Ele é um pouco menos capaz em raciocínios longos de várias etapas. Em agentes que respondem
perguntas, consultam registros ou capturam dados simples, a maioria das equipes não percebe
diferença. Mude um agente, use por alguns dias e compare: a opção é por agente, então dá para
testar sem se comprometer.
Devo ativar o cache aprimorado em todos?
Ative nos agentes com quem as pessoas conversam, onde há pausas. Deixe desativado em agentes
autônomos que rodam do início ao fim sem esperar — não há pausa para ele ajudar. De todo modo,
nunca custa mais a você.
O Contexto de execução permite que o agente veja mais dados?
Não. Ele nunca amplia quais registros um agente pode ver — o compartilhamento de registros é
sempre aplicado. Ele afeta apenas quais campos e objetos o agente pode ler ou gravar em registros
que já alcançava, e somente no canal API.
Por que a versão pulou de 1.14 para 1.15000?
Só o formato mudou. O número secundário agora carrega a versão e o patch juntos: 1.15000 é a
versão 15, patch 000. Os patches dela serão 1.15001 em diante, e a próxima versão será
1.16000.