Referência de Integração com Fluxos

Onde Encontrar a Ação

No Flow Builder, adicione um elemento Action e pesquise por “REDA AI” ou filtre pela categoria de ação Apex. O rótulo da ação é Send Message to REDA AI Agent. Ela funciona em qualquer tipo de Fluxo que suporte ações Apex: disparado por registro, tela, agendado, disparado por evento de plataforma e autolançado.

Para a configuração passo a passo, consulte Invocando a REDA AI a partir de Fluxos. Esta página se concentra no contrato.

Entradas

Três campos são obrigatórios; seis são opcionais.

Saídas

Permissões

A ação é executada sob o usuário sob o qual o próprio Fluxo é executado. O usuário em execução deve ser capaz de:

• Usar a REDA AI — com o conjunto de permissões REDA AI User atribuído (ou REDA AI Admin).
• Ler o registro passado como Record ID.
• Ler os campos de contexto configurados do agente nesse registro.
• Executar quaisquer ferramentas que o agente for chamar — as ferramentas são executadas como o mesmo usuário.
• Se Auto-Execute Actions estiver ativado: escrever em quaisquer objetos que o agente for modificar.

Para Fluxos disparados por registro e por evento de plataforma que são executados em contexto de sistema, avalie com cuidado se o modo sistema é apropriado — o agente e quaisquer ferramentas herdarão esse contexto elevado. Para automações sensíveis, execute o Fluxo como um usuário de serviço específico com um conjunto de permissões estritamente delimitado.

Padrões Comuns de Fluxo

Automação disparada por registro

Dispare na inserção ou atualização de um registro (Oportunidade, Caso, Account, objeto personalizado), passando o Id do registro que disparou e a instrução do agente. Útil para roteamento de casos resumido por IA, pontuação de oportunidades, qualificação de leads.

Automação agendada

Um Fluxo agendado percorre um conjunto de registros e chama a ação para cada um. Útil para resumos diários, enriquecimento periódico, classificação em lote. Fique atento ao orçamento diário de limites reguladores do Apex — uma chamada por registro pode se acumular rapidamente.

Disparado por evento de plataforma

Um Fluxo assinante em um evento de plataforma invoca o agente. O exemplo clássico é o padrão de canal de mensagens: um evento de plataforma de mensagem recebida dispara um Fluxo que chama o agente e depois publica a resposta do agente de volta por meio de uma ferramenta de mensagens de saída. Consulte Integração de canal de mensagens para o padrão completo.

Screen Flow

Um screen Flow interativo permite que um usuário acione um agente sob demanda a partir de um botão ou ação de página. O Fluxo é executado no contexto do usuário; a renderização da resposta do agente de volta para o usuário acontece por meio de elementos de exibição do Fluxo.

Múltiplos turnos dentro de um Fluxo

Para Fluxos que precisam de vários turnos de conversa, capture o Conversation ID da primeira chamada e passe-o de volta nas chamadas seguintes. A plataforma encadeia os turnos em um único registro de Conversa.

Tratamento de Erros

Sempre ramifique com base em Success depois do elemento de ação:

• true — prossiga usando Response.
• false — leia Error Message e decida como recuperar. Padrões comuns: tentar novamente em um ciclo posterior, definir um campo de status no registro pai, enviar uma notificação a um administrador.

Use Create Incident on Error para controlar se as falhas acabam no Registro de incidentes de IA:

• Ative para automações de produção em que toda falha vale a pena ser investigada.
• Desative para Fluxos de alto volume em que falhas individuais são toleráveis e, do contrário, gerariam ruído de incidentes.

Caminho Assíncrono

Para cargas de trabalho pesadas — particularmente arquivos grandes — a plataforma pode rotear a solicitação para processamento assíncrono. Quando isso acontece, a ação retorna imediatamente com Is Async = true e um Async Request ID. O Fluxo termina ali; a execução do agente continua em segundo plano.

Para reagir à conclusão assíncrona, crie um Fluxo disparado por registro em Async Request que dispare quando o registro atingir o status Completed ou Failed, e processe a resposta do agente a partir da Conversa vinculada. Consulte Processamento assíncrono de agentes para o ciclo de vida completo.

Processamento em Massa e Limites Reguladores

• Uma chamada de agente por execução de Fluxo. Cada invocação da ação é um callout para o modelo. Fluxos disparados por DML em massa devem passar os registros por um loop ou por um Fluxo disparado por registro individual — processar em massa dentro de uma única execução de Fluxo não agrupa as chamadas ao modelo.
• Os limites reguladores de callout se aplicam. O Salesforce limita callouts por transação. Para Fluxos que podem ser invocados em massa, considere o limite diário de callouts e o limite por transação.
• Orçamento de créditos. Cada chamada consome créditos. Planeje a retenção e a frequência para que o orçamento mensal de créditos da organização não seja esgotado pelo tráfego de automações.
• Fallback assíncrono. Se uma carga pesada de arquivo exceder os limites síncronos, a plataforma recorre automaticamente ao modo assíncrono. Seu Fluxo ainda deve ramificar com base em Is Async por completude.

Auditoria e Observabilidade

• Toda chamada disparada por um Fluxo produz um registro de Conversa. Filtre a lista de Conversas por Automated Source igual ao nome do seu Fluxo para encontrar as execuções de uma automação específica.
• O Channel na conversa reflete o canal configurado do agente (tipicamente API para agentes disparados por Fluxo).
• As falhas com Create Incident on Error ativado caem no Registro de incidentes de IA com o nome do Fluxo no contexto.
• Use o Depurador de Conversas em qualquer conversa que não tenha produzido o resultado esperado.

Configurando o Agente para Uso com Fluxos

Para que um agente seja acessível a partir de Fluxos:

• Seu Channel deve incluir API.
• As ferramentas que você deseja que o agente use a partir de chamadas de Fluxo devem incluir API no escopo de seu canal.
• Se Auto-Execute Actions estiver ativado, garanta que o conjunto de ferramentas do agente esteja restrito a operações seguras para executar sem revisão humana.
• Considere um agente dedicado para cada caso de uso importante de Fluxo, em vez de um único agente de propósito geral — persona, prompts e conjunto de ferramentas são mais fáceis de governar dessa forma.

Boas Práticas

Sempre defina Automated Source. É o campo mais útil para rastrear uma conversa de volta ao Fluxo que a produziu.

Seja deliberado quanto a Auto-Execute Actions. Sem isso, um agente que propõe uma escrita retorna um cartão de confirmação — que um Fluxo não tem como renderizar. Ative a execução automática ou restrinja o conjunto de ferramentas do agente a ferramentas somente leitura e de escrita pré-aprovadas.

Ramifique com base em Is Async em todo Fluxo de produção. Tratar a resposta como síncrona quando Is Async é true deixa o Fluxo aguardando uma resposta que nunca chega naquela chamada.

Use um usuário de serviço para automações sensíveis. O agente herda as permissões do usuário em execução. Um usuário de serviço dedicado com um conjunto de permissões restrito é mais fácil de auditar do que um Fluxo que é executado como quem quer que o tenha disparado.

Passe Conversation ID ao continuar uma conversa. Sem isso, cada chamada parece uma conversa nova e o agente não tem memória entre os turnos.

Teste em sandbox antes de ir para produção. Fluxos que acionam chamadas de IA têm modos de falha surpreendentes — limites de taxa, esgotamento de créditos, fallback assíncrono — que não aparecem em testes unitários. Execute o Fluxo em registros representativos no sandbox e verifique as transcrições da Conversa antes de promover.

Automação e confiabilidade

Invocações em massa pelo Flow podem retornar IDs de solicitações adiadas em vez de respostas imediatas. Revise elementos seguintes que esperam resposta, créditos ou resultados na mesma transação. Ações automáticas preservam canal e modo configurados e registram resultados reais no contexto, sem garantir uma narração adicional. Deslocamentos horários explícitos são preservados nos caminhos compatíveis de eventos, agendamentos, gravação de campos e CSV. Sem deslocamento, permanece a interpretação do usuário executor. O modo Sistema não gera avisos apenas por ser usado; registros e notificações de nível ERROR permanecem. Extração respeita o limite de saída, cores funcionam nos temas Salesforce compatíveis e testes empacotados evitam referências estáticas que bloqueavam instalação sem tipos de registro de Conta.

Perguntas frequentes

Próximos passos

Leia Invocando a REDA AI a partir de Fluxos para o tutorial de configuração passo a passo, ou Integração de canal de mensagens para o padrão canônico de usar Fluxos como ponte para sistemas externos de mensagens.