Arquitetura para Agentforce: Como refatorar Flows e Apex para conectar IA com segurança

A introdução da IA generativa no ecossistema Salesforce traz um conflito arquitetônico fundamental: a IA usa raciocínio probabilístico e lida com a ambiguidade da intenção do usuário, enquanto a automação tradicional (Flow e Apex) opera de forma estritamente determinística e baseada em regras explícitas. Para que o Agentforce funcione na prática, essas duas realidades precisam se conectar sem colocar em risco a integridade dos dados da sua org.

A boa notícia é que estender suas automações atuais para o Agentforce não requer uma reconstrução total. Na verdade, o trabalho de preparar uma org para agentes é praticamente o mesmo de modernizar a dívida técnica: isolar responsabilidades e criar contratos de dados claros. O segredo é fazer o refatoramento em ações isoladas, uma de cada vez.

Para liderar essa transição, a primeira etapa é realizar uma triagem das suas automações em quatro categorias de risco e esforço:

1. Candidatos Ideais: São os Autolaunched Flows ou métodos Apex (@InvocableMethod) de propósito único, com entradas e saídas claras e escopo definido. Pense em uma ação que apenas calcula o imposto de uma Quote no Salesforce CPQ ou verifica o limite de crédito de uma conta.
2. Candidatos de Transição: Lógicas bem estruturadas, mas que estão presas dentro de Record-Triggered Flows ou classes de serviço amplas. O esforço aqui é extrair essa lógica para um subflow independente.
3. Candidatos Marginais: Screen Flows complexos, triggers monolíticas e processos com dependências sobrepostas. Um fluxo de checkout legado que atualiza dezenas de objetos simultaneamente deve ser evitado até que o domínio passe por um refatoramento completo.
4. Anti-patterns de Alto Risco: Operações DML rodando em System Context. Expor isso à IA significa permitir que um raciocínio probabilístico invoque mudanças de dados que ignoram permissões de usuário, sem qualquer validação human-in-the-loop.

Ao preparar um Flow ou Apex para ser invocado pelo Agentforce, a arquitetura ganha novas exigências práticas.

A primeira delas é o isolamento de lógica. Processos monolíticos que misturam interface de usuário, roteamento e DML precisam ser desmembrados. A lógica de negócio pura deve residir em um Autolaunched Flow 'headless' ou em uma classe Apex dedicada.

Do ponto de vista de desenvolvimento, quatro fatores técnicos passam a ser inegociáveis:

Bulkification para IA: A blukificação deixa de ser apenas uma proteção contra limites de governança (Governor Limits) e passa a ser uma necessidade funcional. Se um usuário pedir para a IA "aplicar 10% de desconto nestas 5 ordens", o LLM passará um array de requisições em uma única transação. O seu Apex deve estar pronto para receber um List e retornar um List sincronicamente, garantindo que o índice de resposta bata com a requisição.

Contratos de Dados Rígidos: Esqueça o uso de JSON não tipado ou mapas genéricos. O Agentforce exige Wrapper Classes no Apex fortemente tipadas. Mais importante: as descrições em texto das suas variáveis (@InvocableVariable) passam a atuar como system prompts literais. Descrever uma variável como "ID de 18 caracteres da Ordem alvo para o desconto" é o que garante que o LLM extraia o parâmetro corretamente da conversa.

Tratamento de Exceções Explicável: Se a automação falhar, a IA precisa entender o porquê para explicar ao usuário. Use Fault Paths no Flow para retornar mensagens prescritivas em variáveis de saída, ou blocos try/catch no Apex retornando strings de erro explícitas (ex: "Desconto solicitado excede a alçada máxima de 5%").

Contexto de Segurança Implacável: Defina suas classes Apex invocáveis com a palavra-chave with sharing e execute operações de banco com WITH USER_MODE. No Flow, force a execução em contexto de usuário. A IA jamais deve ter o poder de contornar regras de visibilidade ou modificar registros fora do escopo de quem está interagindo com o agente.

No fim do dia, o Agentforce obriga as equipes a adotarem práticas de desenvolvimento composable que sempre foram recomendadas, mas frequentemente ignoradas na pressa dos projetos. Comece pequeno: escolha um único domínio de negócio, isole uma ação simples, crie os contratos e exponha ao agente. Esse é o melhor caminho para construir uma camada de IA que a sua operação realmente confie.