Ações Agênticas Declarativas
O que são Ações Agênticas Declarativas?
As ações agênticas declarativas são ações de Fluxo que permitem invocar um agente da REDA AI a partir de um Fluxo do Salesforce. Em vez de usar Apex ou APIs, você pode arrastar e soltar uma ação de agente no seu Fluxo, configurar as entradas e executar o agente como parte da sua automação.
Isso viabiliza casos de uso poderosos:
- Processamento automatizado — Aciona um agente quando um registro é criado (por exemplo, "analise este lead" quando um lead é criado)
- Enriquecimento — O agente preenche campos ausentes com base em dados externos
- Roteamento — O agente decide qual fila ou usuário deve tratar um registro
- Notificações — O agente gera resumos para incluir em e-mails
Pré-requisitos
Antes de usar um agente em um Fluxo:
- O agente precisa existir — Crie e configure o agente (prompts, ferramentas, campos de contexto)
- O agente precisa estar ativo — O Active Status do agente precisa estar ativado
- Allow Automated Requests precisa estar habilitado — Defina isso na Definição de Agente para habilitar as invocações a partir de Fluxos
- O Channel precisa estar definido como
API— A superfície invocável de Fluxo / Apex só resolve agentes cujo Channel éAPI. Agentes Interno, de Comunidade e de Widget Externo são rejeitados no momento da invocação, com um erro claro.
Um agente com Channel = API fica restrito à invocação programática — Fluxo Builder, Apex, integrações REST. Ele não pode ser colocado em uma página de registro (use o canal Interno), em uma página de portal (use Comunidade) ou em um site público (use Widget Externo). Escolha o canal que corresponde à superfície na qual você pretende implantá-lo.
Configurando um Agente para Uso em Fluxo
-
Abra a Definição de Agente
Vá até o agente que você quer usar em um Fluxo.
-
Marque Allow Automated Requests
Ative essa caixa de seleção para permitir a integração com Fluxo.
-
Configure o Agente
Garanta que o agente tenha os prompts e as ferramentas adequados para a tarefa de automação.
-
Ative o Agente
Ative o Active Status do agente.
-
Salve
O agente agora está pronto para ser usado em Fluxos.
Usando um Agente em um Fluxo
-
Crie ou Abra um Fluxo
Abra o Fluxo Builder do Salesforce (Configuração → Fluxos ou a partir de uma página).
-
Adicione um Elemento de Ação
Clique em "+" para adicionar um elemento. Selecione "Action".
-
Procure a Ação do Agente da REDA AI
Procure por "REDA AI" e selecione a ação chamada "Send Message to REDA AI Agent".
-
Identifique o Agente
Defina a entrada Agent Name com o ID do Agente (por exemplo, "default-assistant") — o ID do registro de Definição de Agente, não o nome de exibição.
-
Configure as Entradas
Mapeie variáveis do Fluxo para as entradas da ação:
- Agent Name (obrigatória) — o ID do Agente
- Record ID (obrigatória) — o registro de contexto com o qual o agente trabalha
- Object API Name (obrigatória) — o nome de API do objeto do registro (por exemplo, "Opportunity")
- Message (obrigatória) — o prompt ou a instrução que o agente deve processar
- Auto-Execute Actions — se as ferramentas de Action devem ser confirmadas e executadas automaticamente (true/false)
- Conversation ID — passe o Conversation ID de um turno anterior para continuar uma conversa de vários turnos
- Automated Source — um rótulo para esta automação (por exemplo, o nome do Fluxo), gravado na conversa para auditoria
- Create Incident on Error — se true, falhas criam um registro de Incidente de IA; se false, os erros são retornados apenas na saída
-
Configure as Saídas
Capture a resposta do agente:
- Response — a resposta de texto do agente
- Success / Error Message — se a chamada teve sucesso, e a descrição da falha caso contrário
- Action Results JSON — array JSON com os resultados das ações executadas (quando Auto-Execute Actions é true)
- Credits Used — créditos de IA consumidos pela chamada
- Conversation ID — passe-o na próxima chamada para continuar a conversa
- Is Async / Async Request ID — definidos quando a resposta é processada de forma assíncrona (consulte Processamento assíncrono de agentes)
-
Use as Saídas nas Etapas Seguintes
Passe a resposta do agente para outras ações do Fluxo (enviar e-mail, atualizar registro etc.).
-
Teste e Salve
Teste o Fluxo com dados de amostra. Salve quando estiver pronto.
Casos de Uso Comuns com Fluxo
Quando um lead é criado, um Fluxo é acionado. O Fluxo chama um agente com as informações do lead. O agente enriquece o lead com insights sobre a empresa, identifica o melhor contato e atualiza o registro do lead automaticamente.
Quando um caso é criado, um Fluxo invoca um agente para analisar a descrição e a prioridade do caso. O agente determina qual equipe deve tratá-lo (Vendas, Suporte, Faturamento) e o Fluxo atribui o caso de acordo.
Um Fluxo envia um relatório semanal de todas as oportunidades abertas. Para cada oportunidade, ele chama um agente para gerar um breve resumo. Os resumos são compilados em um e-mail e enviados aos gestores.
Enviando arquivos ao agente
Um Fluxo pode enviar um ou mais arquivos ao agente para análise — por exemplo, um PDF, uma imagem ou um CSV já armazenado no Salesforce. Use a entrada File Content Version IDs: forneça uma coleção de Ids de ContentVersion dos arquivos que você quer que o agente leia (um ou vários, até 5).
No seu Fluxo, obtenha o(s) Id(s) de ContentVersion do(s) arquivo(s) — por exemplo, a partir de um elemento Get Records sobre ContentVersion — passe-os para File Content Version IDs, e o agente lerá o conteúdo dos arquivos como parte da sua resposta. O agente precisa ter Allow File Upload habilitado; os tipos suportados e o limite de tamanho seguem as configurações da sua REDA AI — veja Carregamento de Arquivos.
Uma entrada de arquivo único, File Content Version ID, também existe para compatibilidade com versões anteriores. Para Fluxos novos, use File Content Version IDs — ela lida com um ou vários. Se ambas forem fornecidas, File Content Version IDs tem precedência.
Auto Execute Actions
Auto Execute Actions é uma entrada do Fluxo que decide se as ações propostas pelo agente realmente são executadas. Não existe uma terceira opção: um Fluxo não tem tela, então um cartão de confirmação não teria onde aparecer.
- Habilitado — as ferramentas de Action do agente são executadas, e seus resultados voltam na saída Action Results JSON, para que o Fluxo possa ramificar com base neles.
- Desabilitado (o padrão) — o agente ainda pode propor ações, e nenhuma é executada. Nada fica pendente de aprovação e nenhum erro é levantado; a proposta é simplesmente descartada.
Esta é a armadilha da automação com Fluxos. Deixar a entrada desmarcada porque você espera o “comportamento normal de confirmação” não lhe dá uma etapa de aprovação — dá um agente que responde como se tivesse feito o trabalho, enquanto o registro nunca foi criado e o e-mail nunca foi enviado. Se o Fluxo deve alterar dados, defina Auto Execute Actions como true e verifique o Action Results JSON para o sucesso de cada ação.
Com ele habilitado, o agente trata a requisição como já autorizada e executa suas ferramentas de criação de registro, atualização de registro e envio de e-mail sem perguntar — então dê a um agente invocado por Fluxo apenas as ferramentas de Action que você aceite ver executadas sem supervisão.
Fluxos de Trabalho Autônomos de Várias Etapas
Um único turno do agente é executado como uma transação do Salesforce. Dentro desse turno, o agente pode chamar a IA e suas ferramentas e depois salvar dados — mas não pode chamar um serviço externo novamente depois de já ter salvo. Para a maioria das automações, isso é suficiente. Quando uma tarefa realmente precisa criar ou atualizar um registro, depois chamar um serviço externo usando esse registro e depois gravar o resultado de volta, um agente de canal API pode levar o trabalho adiante em turnos automáticos adicionais.
O agente solicita um turno de continuação com a ferramenta integrada continue_workflow. Cada turno continuado é executado em uma transação nova — com seu próprio orçamento de chamadas externas e salvamentos — e retoma de onde o turno anterior parou, com os registros que acabou de confirmar disponíveis para ele. O agente decide quando outro turno é necessário; se conseguir terminar em um único turno, é isso que ele faz.
- Somente canal API — a capacidade está disponível exclusivamente para agentes cujo Channel é
API. Agentes Interno, de Comunidade e de Widget Externo nunca a recebem. - Ativa por padrão, com exclusão por agente — Os agentes API têm
continue_workflowautomaticamente no seu loadout. Para impedir que um agente encadeie turnos, remova a ferramenta do seu loadout em Agent Runtime Preview → Edit Loadout, ou desative a ferramenta. - Limitada — uma única tarefa pode encadear até um número fixo de turnos (padrão de 20, configurável em Setup), e cada turno consome créditos dentro do limite normal por turno, de modo que um fluxo de trabalho nunca pode ficar fora de controle.
Um Fluxo invoca um agente para integrar uma nova Conta. O agente cria a Conta e, em seguida, chama continue_workflow porque agora precisa enviar os dados dessa Conta a um serviço externo de avaliação. No turno seguinte, ele faz a chamada de avaliação, recebe o resultado e atualiza a Conta com o desfecho — tudo sem uma pessoa no processo.
Somente quando uma chamada externa precisa acontecer depois de um salvamento. Um agente já consegue ler dados, raciocinar e criar ou atualizar vários registros dentro de um único turno — por isso a maioria das automações em Fluxo nunca precisa continuar. Reserve os fluxos de trabalho de várias etapas para o padrão criar-depois-chamar-depois-gravar.
Tratamento de Erros em Fluxos
Se uma ação de agente falhar em um Fluxo:
- O Fluxo recebe um status de erro e pode se ramificar de acordo
- Você pode adicionar um Fault Handler para registrar o erro ou enviar uma notificação
- O Fluxo pode continuar, tentar novamente ou parar, dependendo do tipo de erro
Cenários de erro comuns:
- Agente Inativo — O agente não está ativo. Verifique o campo Active Status e ative-o se necessário.
- Permissão Negada — O usuário do Fluxo não tem acesso a um registro. Verifique as permissões e o compartilhamento.
- Falha na Chamada de Ferramenta — Uma ferramenta chamada pelo agente falhou. Verifique os logs para mais detalhes.
- Tempo Limite Excedido — O agente demorou demais para responder. Verifique o Token Budget e simplifique se necessário.
Boas Práticas para Integração com Fluxo
Crie prompts específicos para casos de uso em Fluxo. Exemplo: "Analise este lead e extraia: (1) porte da empresa, (2) setor, (3) faixa de orçamento. Retorne como JSON."
Mantenha as chamadas de Fluxo leves — Não passe grandes volumes de dados a um agente em um Fluxo. Mantenha os payloads focados no que o agente realmente precisa.
Monitore o uso de tokens — Cada invocação de Fluxo consome créditos. Monitore o consumo de créditos e otimize os prompts do agente para reduzir tokens.
Defina Token Budgets razoáveis — Garanta que o Token Budget do seu agente seja adequado para a tarefa do Fluxo. Uma operação em lote pode usar um orçamento menor do que um agente interativo.
Teste minuciosamente — Teste seu Fluxo com dados reais em um sandbox. Verifique se o agente produz saídas corretas e não causa efeitos colaterais inesperados.
Perguntas frequentes
Não. A ação invocável de Fluxo / Apex só aceita agentes cujo Channel esteja definido como API. Se um Fluxo tentar invocar um agente Interno, de Comunidade ou de Widget Externo, a ação retorna um erro explicando a incompatibilidade de superfície. Crie um agente dedicado com o Channel definido como API para casos de uso em Fluxos.
Verifique a configuração Max Message Length do seu agente. As entradas do Fluxo ficam limitadas por esse valor. Se a mensagem do seu Fluxo exceder o limite, o agente a rejeitará.
Sim, se você atribuir ferramentas de escrita (criação de registro, atualização de registro etc.) e habilitar Auto Execute Actions. O agente pode criar e modificar registros como parte do Fluxo.
Capture a saída do agente em uma variável do Fluxo. Depois você pode registrá-la em um registro de depuração, enviá-la por e-mail ou armazená-la em um campo para fins de auditoria.
Não dentro do mesmo turno — um turno é uma transação, e uma chamada externa não pode ocorrer depois de um salvamento dentro dela. Para uma tarefa de criar-depois-chamar-depois-escrever, um agente de canal API usa a ferramenta integrada continue_workflow para continuar em um turno novo (veja Fluxos de Trabalho Autônomos de Várias Etapas acima). Isso está disponível apenas em agentes API, é limitado por um limite de turnos configurável e pode ser removido por agente do loadout do agente.
Próximos Passos
Explore a gestão de prompts para criar prompts especializados para seus casos de uso em Fluxo, ou saiba mais sobre ferramentas para habilitar as ações do agente.