Saiba como criar fluxos prontos para agentes

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

• Criar um fluxo que possa ser atribuído a uma ação de agente.
  
• Escrever nomes e descrições úteis para os recursos de um fluxo de ação de agente.
  
• Criar variáveis apropriadas em um fluxo de ação do agente.
  
• Limitar os dados a que o seu agente e os respectivos fluxos de ação têm acesso.
  

Este emblema assume que você está familiarizado com fluxos e tem experiência com o Flow Builder. Siga a trilha Criar fluxos com o Flow Builder para desenvolver habilidades de automação de processos fortes e se tornar um especialista em Flow Builder.

Por que você deve usar fluxos em agentes

O Agentforce é uma ferramenta incrivelmente eficaz para seus usuários e clientes, e grande parte dessa eficácia vem dos fluxos. Embora os agentes possam acessar os dados do Salesforce, eles não podem alterar esses dados. Se deseja que seu agente crie, atualize ou exclua registros, você precisa definir uma ação de agente que altere os dados. As ações de agente podem chamar classes do Apex, fazer chamadas de API, executar fluxos ou referenciar um modelo de prompt, mas os fluxos são o único método que pode afetar os dados da sua organização do Salesforce sem precisar escrever muito código.

Os fluxos também fornecem um nível extra de precisão ao garantir que o agente esteja trabalhando com dados específicos. Os agentes podem ler quaisquer dados do Salesforce que você lhes conceder permissão para ler e usar quaisquer dados que considerarem relevantes. Para limitar os dados que o agente usa e aumentar consideravelmente a precisão do agente, crie um fluxo que recupere dados específicos e precisos para fornecer ao agente. Em seguida, dê instruções ao agente para usar apenas os dados fornecidos pelo fluxo.

Então, o que você precisa fazer para criar uma ação de agente baseada em fluxo?

Criar um fluxo iniciado automaticamente (sem acionador)

As ações de agente suportam apenas fluxos do tipo Autolaunched Flow (No Trigger) (Fluxo iniciado automaticamente) [sem acionador]). Embora outros tipos de fluxo, como fluxos acionados por registro, possam tecnicamente ser qualificados como iniciados automaticamente, o fluxo atribuído deve ser especificamente do tipo No Trigger (Sem acionador). Se deseja usar um fluxo existente em uma ação de agente e ele não é desse tipo, você deve recriar o fluxo usando o tipo de fluxo Autolaunched Flow (No Trigger) (Fluxo iniciado automaticamente) [sem acionador]).

Ser muito descritivo

A tecnologia de IA depende muito das palavras. Para obter bons resultados ao pedir para a IA gerar um texto, você precisa lhe fornecer instruções detalhadas e garantir que ela produza um texto de origem detalhado e preciso. O mesmo se aplica a qualquer fluxo que você deseja executar como uma ação de agente.

Os agentes utilizam os nomes das variáveis do fluxo, bem como os dados que o fluxo está processando, para compreender o que o fluxo faz. Portanto, é importante ter nomes precisos e descritivos para as variáveis de entrada e saída do seu fluxo. Evite nomes de variáveis como “foo”. Em vez disso, use nome de variáveis descritivos como “Account_ID”.

Embora já seja uma boa prática adicionar descrições a tudo em um fluxo, isso é ainda mais importante quando o fluxo é executado por uma ação de agente. Os agentes utilizam a descrição do fluxo e as descrições de suas variáveis. Todo esse texto ajuda o agente a entender a funcionalidade do fluxo e os dados que o fluxo está processando.

Escreva nomes e descrições precisos para as variáveis de entrada e saída do fluxo. Sem um nome e uma descrição precisos, o agente não consegue determinar com segurança o que fazer com uma variável e respectivos dados.

Eis alguns exemplos de descrições precisas.

A descrição do fluxo é mais direta do que as outras descrições. Isso ocorre porque, quando você adiciona um fluxo a um agente, a descrição do fluxo se torna automaticamente uma instrução para o agente. Economize tempo escrevendo a descrição do fluxo na forma de uma instrução para o agente.

Utilizar sempre variáveis de entrada e saída

As ações de agente baseadas em fluxo sempre requerem pelo menos uma variável de entrada e pelo menos uma variável de saída no fluxo. Mesmo que essas variáveis não fossem necessárias, ainda assim seria uma boa prática usar variáveis de entrada e saída. Seus fluxos ficam mais precisos quando você lhes fornece mais contexto, e seus agentes têm um desempenho melhor quando os respectivos fluxos enviam os dados corretos.

Mesmo que não consiga pensar em nenhum dado para fornecer ao agente, ainda há algo que você deve sempre considerar enviar em uma variável de saída: mensagens de erro. Os agentes esperam algum tipo de resultado de um fluxo, mesmo que esse resultado seja simplesmente a mensagem YOUR FLOW FINISHED (SEU FLUXO FOI CONCLUÍDO). Mas os fluxos podem falhar, gerando erros inesperados. Sem nenhum dado do fluxo, seu agente provavelmente se desculpará e apresentará uma mensagem genérica do tipo “Something went wrong (Algo deu errado)”. Ou então apresentará outros dados ao cliente, sem qualquer contexto, apenas porque deseja apresentar algo.

Para evitar que isso aconteça (e também para atender ao requisito da variável de saída), crie uma variável de saída projetada para apresentar mensagens de erro mais detalhadas e úteis. Use caminhos de falha e elementos de atribuição no seu fluxo para definir a mensagem de erro em uma variável de saída. Em seguida, indique ao seu agente como e quando usar essa variável de saída. Mostraremos como configurar tudo isso nas unidades a seguir.

Não ter medo de variáveis de registro

As variáveis de registro não servem apenas para trabalhar nos fluxos. Os agentes também podem receber variáveis de registro! Se você precisa enviar ao seu agente vários campos de um registro, ou mesmo de vários registros, não crie várias variáveis. Em vez disso, crie uma variável de registro ou uma variável de coleção de registro para esses dados e disponibilize-a para saída. Suponha que seu agente solicite quatro campos de um caso aberto de um cliente. Em vez de usar quatro variáveis separadas, você retorna esses quatro campos do caso em uma variável de registro. E se você quiser retornar vários casos, pode retorná-los em uma única variável de coleção de registro.

Seu agente recebe todos esses dados e pode utilizá-los. E se as instruções do agente indicarem que ele deve apresentar os dados de registro ao cliente, o agente primeiro organiza esses dados em um formato prático e legível.

Não deixe seu fluxo sobrecarregar seu agente

Quando um agente recebe dados de um fluxo, ele tende a acreditar que os dados devem ser usados para alguma coisa. Ele pode usar os dados para tomar decisões ou pode mostrar os dados ao cliente desnecessariamente. Ele até pode mostrar ao cliente dados que não deveria ver. Portanto, você nunca deve fornecer a um agente dados que não deseja que ele use.

Infelizmente, essa regra contraria as configurações padrão do fluxo Get Records (Obter registros). A configuração padrão de How to Store Record Data (Como armazenar dados de registro) é “Automatically store all fields (Armazenar automaticamente todos os campos)”, mas seus agentes provavelmente não precisam de todos esses campos. Em vez disso, selecione a configuração “Choose fields and assign variables (Escolher campos e atribuir variáveis)”, usando uma variável de registro separada, e selecione apenas os campos de que o agente precisa.

Dar ao seu agente as permissões certas

Da mesma forma, lembre-se de que os agentes podem acessar todos os seus dados do Salesforce se tiverem as permissões certas. Você deve dar ao seu agente apenas as permissões necessárias para executar os fluxos dele. Não lhe dê acesso a qualquer coisa que não seja realmente necessária.

Para controlar as permissões de um agente, comece procurando pelo Agent User (Usuário do agente) atribuído a esse agente. Você pode visualizar e alterar este usuário na página de detalhes do agente.

Após identificar o usuário do agente, dê a esse usuário os conjuntos de permissões, perfis e funções necessários para executar os fluxos dele e atender às solicitações dos seus clientes.

Criar muitos fluxos mais pequenos, em vez de um único fluxo grande

Os agentes se beneficiam do design modular: muitas pequenas ações, cada uma completando uma tarefa. Essas ações podem ser combinadas de várias maneiras e reutilizadas em muitos agentes.

Então, como saber onde definir o limite que separa um fluxo de outro? Pense em como você associa fluxos a um agente: você cria uma ação de agente para cada fluxo. E “ação” é a palavra-chave aqui. Quando alguém pede a um agente para executar uma ação, a própria ação geralmente define os limites do fluxo. Por exemplo, se fosse possível pedir a agente que alterasse o estágio de uma oportunidade, essa seria uma ação realizada por um fluxo. Se também fosse possível pedir a um agente que mudasse a data de fechamento sem alterar o estágio, essa seria uma ação separada realizada por outro fluxo. Por outro lado, você não precisa de uma ação e de um fluxo separados para cada valor potencial do campo Stage (Estágio), pois o fluxo pode usar um elemento Update Records (Atualizar registros) para definir o campo para o valor solicitado.

No entanto, se a ação solicitada significasse atualizar o estágio e a data de fechamento ao mesmo tempo, você poderia fazer isso com um fluxo de ação do agente, pois essa seria uma única solicitação.

Os pontos de interação também são uma ótima maneira de definir os limites de um fluxo. Os agentes não podem pedir informações a um cliente no meio do fluxo, portanto, se o seu agente precisar de apresentar informações ou perguntar o que fazer a seguir, isso geralmente é um bom limite. Imagine um tópico de agente para gerenciar oportunidades em que o agente pode ter de fazer várias tarefas.

1. Pergunte ao cliente qual oportunidade usar.
   
2. Obtenha dados sobre essa oportunidade.
   
3. Com os dados certos disponíveis, pergunte ao cliente como o agente pode ajudar.
   
4. Execute a ação solicitada pelo cliente.
   

Nesse cenário, um fluxo pode cuidar das etapas 1 e 2. O agente trata da etapa 3. A etapa 4 deve ter um ou mais fluxos separados, dependendo do que mais o agente pode fazer com o registro de oportunidade do cliente.

Outras considerações

Aqui estão algumas outras considerações a ter em mente ao trabalhar com fluxos em agentes.

Não enviar longas sequências de caracteres de texto a uma variável

As variáveis de texto podem conter apenas 255 caracteres, e os caracteres que excederem esse limite serão truncados. Cuidado ao atribuir comprimentos desconhecidos de texto a uma variável de entrada do tipo de dados de texto. Para enviar mais de 255 caracteres de texto para um fluxo, trabalhe com um desenvolvedor para criar uma variável definida pelo Apex.

Tornar o texto o mais claro possível

Faça tudo o que puder para ajudar seu agente a entender o contexto e as instruções. Use frases completas com gramática, ortografia e pontuação adequadas. Se você estiver inserindo texto em um local onde não é possível usar espaços, como o nome da API de uma variável, adicione sublinhados entre as palavras para facilitar a compreensão. Por exemplo, use Account_ING_Number em vez de AccountINGNumber.

Evitar tipos de dados incompatíveis

Esses tipos de dados complexos não podem ser repassados ao agente por meio de variáveis de saída.

• Moeda
  
• Lista de opções
  
• Lista de opções de seleção múltipla
  
• Definido pelo Apex
  

Se o seu fluxo estiver configurado para fornecer um desses tipos de dados a um agente, o agente não poderá mais tratar de variáveis de saída.

Refazer uma ação de agente se você alterar as variáveis do fluxo

Quando você cria uma ação de agente a partir de um fluxo, a ação captura um instantâneo único das variáveis de entrada e saída do fluxo. Esse instantâneo é estático. Não é atualizado se você alterar as variáveis do fluxo. Para evitar problemas quando o agente executar o fluxo com variáveis desatualizadas, você deve excluir a ação de agente, criar uma nova ação de agente e atribuir o fluxo à ação de agente.

Recursos

• Ajuda do Salesforce: Melhores práticas para instruções de ações de agente
• Ajuda do Salesforce: Considerações sobre o Agentforce