Adicionar um fluxo como ferramenta do agente

Objetivos de aprendizagem

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

• Fundamentar o subagente para obter a máxima eficácia com ações de agente baseadas em fluxo.
  
• Criar uma ação de agente que faça referência a um fluxo.
  
• Configurar um subagente para que a ação de um agente forneça dados para a ação de outro agente.
  

Nota

Deseja aprender em português (Brasil)? Comece o desafio em um Trailhead Playground de português (Brasil) e use as traduções fornecidas entre parênteses para navegar. Copie e cole somente os valores em inglês porque as validações dos desafios dependem de dados em inglês. Se você não passar no desafio em sua organização de português (Brasil), recomendamos que (1) mude o local para os Estados Unidos, (2) mude o idioma para inglês, seguindo as instruções aqui, e (3) clique novamente no botão “Validar o desafio”.

Consulte o emblema Trailhead no seu idioma para saber mais sobre como aproveitar a experiência de Trailhead em outros idiomas.

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.

A partir de abril de 2026, os tópicos de agentes passarão a ser chamados de subagentes. Não há alterações na funcionalidade. Durante essa transição, você poderá encontrar uma mistura dos termos novos e antigos em nossa documentação.

Trailcast

Se você deseja escutar uma gravação de áudio deste módulo, use o reprodutor abaixo. Quando terminar de escutar essa gravação, lembre-se de voltar a cada unidade, consultar os recursos e completar as avaliações associadas.

Agora que você criou os fluxos que o Coral Cloud Experience Agent (Agente da Coral Cloud no Experience Cloud) precisa para ajudar clientes a gerenciar suas atividades reservadas, crie um subagente sobre esse agente e atribua a ele as ações baseadas em fluxo necessárias para ajudar seus clientes.

Configurar o Agentforce

Primeiro, confirme que o Agentforce está ativado no seu Trailhead Playground.

1. Em Setup (Configuração), na caixa Quick Find (Busca rápida), procure e selecione Einstein Setup (Configuração do Einstein).
   
2. Verifique se o Einstein está na posição On (Ativado). Se já estiver, ponha-o na posição Off (Desativado) e novamente na posição On (Ativado).
   
3. Atualize seu navegador para recarregar Setup (Configuração).
   
4. Em Setup (Configuração), na caixa Quick Find (Busca rápida), procure e selecione Agentforce Agents (Agentes do Agentforce).
   
5. Confirme que Agentforce está On (Ativado).
   

Adicionar um subagente

Antes de criar o subagente, considere algumas diretrizes e melhores práticas para configurar subagentes.

• Fundamente seu subagente com informações sobre os objetos relevantes do Salesforce. Descreva a finalidade do tópico para que o agente entenda como respectivos dados são usados.
  
• Indique ao subagente que não deve usar dados do Salesforce que não sejam fornecidos por uma ação. Lembre-se de que os agentes têm acesso a todos os objetos e campos que lhes são concedidos pelas permissões. Essa instrução impede que o agente fale sobre dados que não são relevantes ou que não devem ser compartilhados.
  
• Indique ao subagente para não mostrar ao cliente quaisquer valores de ID. As variáveis de coleção de registro sempre incluem as IDs dos registros, portanto, sem essa instrução, é provável que o agente mostre esses dados aos clientes, mesmo que sejam irrelevantes para eles. Essa instrução protege seus clientes da confusão causada por dados crípticos.
  
• Ao mencionar uma ação de agente, use o nome da API da ação. Por exemplo, refira-se a ela como “ação Get_Customer_Details” e não como “ação Get Customer Details (Obter detalhes do cliente)”. Essa prática ajuda o agente a distinguir os nomes das ações do texto ao redor.
  

Ao configurar um subagente, você fornece a descrição da classificação, o escopo e as instruções desse mesmo subagente.

Agora, crie um subagente que indique ao agente o que ele pode e não pode fazer com as atividades reservadas pelos clientes.

1. Em Setup (Configuração), na caixa Quick Find (Busca rápida), procure e selecione Agentforce Agents (Agentes do Agentforce).
   
2. Selecione Coral Cloud Experience Agent (Agente da Coral Cloud no Experience Cloud).
   
3. Clique em Open in Builder (Abrir no criador).
   
4. No painel Subagents (Subagentes), clique em New (Novo) e selecione New Subagent (Novo subagente).
   Se o botão Novo não aparecer, certifique-se de que o agente esteja desativado. Se o agente já estiver desativado, retorne à página de configuração de agentes e deslize o botão de alternância Agentforce para desmarcá-lo e de novo para marcá-lo.
   

5. Deixe o campo “What do you want this subagent to do? (O que você quer que o subagente faça?)” em branco e clique em Next (Avançar).
   O campo “What do you want this subagent to do? (O que você quer que o subagente faça?)” preenche automaticamente outros valores do subagente para você. Para este exercício, você define os valores manualmente para que possamos orientá-lo.
   
6. Na caixa Create a Subagent (Criar um subagente), configure o subagente da forma indicada abaixo.
   

• Em Name (Nome), insira: Booked Activity Management(Gerenciamento da atividade reservada).
  
• Em Classification Description (Descrição da classificação), insira:
  This subagent helps Coral Cloud Resort guests to manage and understand their booked activities. Booked activities are stored in the 'Bookings' object in Salesforce. Guests are represented by the 'Contacts' object in Salesforce. (Este subagente ajuda os hóspedes do Coral Cloud Resorts a gerenciar e entender suas atividades reservadas. As atividades reservadas são armazenadas no objeto “Bookings” (Reservas) no Salesforce. Os hóspedes são representados pelo objeto “Contacts” (Contatos) no Salesforce.)
• Em Scope (Escopo), insira:
  Your job is only to help Coral Cloud Resort guests book activities, give them information about their existing booked activities, and cancel their booked activities. Do not use any Salesforce data that wasn't provided by an action's output. Do not show the customer any ID values. (Sua função é apenas ajudar os hóspedes do Coral Cloud Resorts a reservar atividades, fornecer informações sobre as atividades já reservadas e cancelar as atividades reservadas. Não use quaisquer dados do Salesforce que não tenham sido fornecidos pelo resultado de uma ação. Não mostre ao cliente quaisquer valores de ID.)

7. Na parte inferior, clique em Add Instructions (Adicionar instruções) três (3) vezes para exibir um total de três caixas de texto com instruções.
   
8. Adicione estas instruções:
   

• Para a primeira instrução, insira:
  After showing the customer a list of their activities, ask them how you can help them. (Depois de mostrar ao cliente uma lista de suas atividades, pergunte como você pode ajudá-lo.)
• Para a segunda instrução, insira:
  If the customer is not known, you must always ask for their email address and their membership number to get their Contact record by running the Get_Customer_Details action before running any other actions. (Se o cliente não for conhecido, você deve sempre solicitar o endereço de email e o número de associação para obter o registro de contato, executando a ação Get_Customer_Details antes de executar qualquer outra ação.)
• Para a terceira instrução, insira:
  If the customer asks what their current booked activities are, run the Get_Contact_s_Upcoming_Bookings action and then present the output to the customer. (Se o cliente perguntar quais são as atividades atualmente reservadas, execute a ação Get_Contact_s_Upcoming_Bookings e apresente o resultado ao cliente.)

9. Clique em Avançar.
   
10. Clique em Concluir.
    Se uma janela com a mensagem Subagent Overlap Detected (Sobreposição de subagentes detectada) abrir, clique em Ignore (Ignorar). A mensagem alerta o criador do agente que pode já existir um subagente semelhante na biblioteca de subagentes desta organização. Em relação a este emblema, você não precisa se preocupar com esta mensagem.
    

Adicionar fluxos como ações de agente

É hora de adicionar os fluxos ao agente. Crie uma ação de agente para cada fluxo e atribua-a ao subagente. Felizmente, você pode criar essas ações de agente sem precisar sair do Criador do Agentforce.

Adicionar a ação Get Customer Details (Obter detalhes do cliente) ao agente

1. Clique no subagente Booked Activity Management (Gerenciamento da atividade reservada).
   
2. Clique na guia This Subagent’s Actions (Ações desse subagente).
   

3. Clique em New (Novo) e selecione Create New Action (Criar nova ação).
   
4. Selecione Flow (Fluxo) como tipo de ação de referência.
   
5. Em Reference Action (Ação de referência), selecione Get Customer Details (Obter detalhes do cliente).
   
6. Mantenha o rótulo padrão e o nome da API e clique em Next (Avançar).
   
7. Confirme que as instruções de ações de agente indicam: Validate a Customer’s details by passing their email and memberNumber to see if there is a related contact. (Valide os dados de um cliente, inserindo o email e o número de membro dele para verificar se há um contato relacionado).
8. Desmarque a caixa rotulada Show loading text for this action (Mostrar carregamento de texto desta ação).
   
9. Defina as configurações de entrada da variável email.
   

• Confirme que as instruções indicam: The Email Address of the customer that is validating their identity. (O endereço de email do cliente que está validando a identidade dele).
• Marque Require Input (Solicitar entrada).
  Essa configuração indica ao agente que ele não deve executar essa ação, a menos que tenha dados para enviar. Use essa configuração para garantir que o fluxo não seja executado sem os dados necessários para funcionar corretamente.
  

10. Defina as configurações de entrada da variável memberNumber.
    

• Confirme que as instruções indicam: The Member Number of the customer that is validating their identity. (O número de membro do cliente que está validando a identidade dele).
• Marque Require Input (Solicitar entrada).
  

11. Defina as configurações de saída da variável contact.
    

• Confirme que as instruções indicam: The contact that was returned in the search for records. (O contato que foi retornado na pesquisa por registros).
• Selecione Show in conversation (Mostrar na conversa).
  Essa configuração indica ao agente que é aceitável enviar o conteúdo dessa variável ao cliente. Se a caixa de seleção (Mostrar na conversa) não estiver marcada para uma saída específica, o conteúdo dessa variável de fluxo nunca será compartilhado com o cliente.
  

12. Clique em Concluir.
    

Adicionar a ação Get Contact’s Upcoming Bookings (Obter reservas futuras do contato) ao agente

1. Na guia This Subagent’s Actions (Ações deste subagente) do subagente Booked Activity Management (Gerenciamento da atividade reservada), clique em New (Novo) e selecione Create New Action (Criar nova ação).
   
2. Selecione Flow (Fluxo) como tipo de ação de referência.
   
3. Em Reference Action (Ação de referência), selecione Get Contact’s Upcoming Bookings (Obter reservas futuras do contato).
   
4. Mantenha o rótulo padrão e o nome da API e clique em Next (Avançar).
   
5. Confirme que as Agent Action Instructions (Instruções de ações de agente) indicam: Find all the Booking records related to the guest's contact record. Only retrieve Bookings whose date hasn't occurred yet. (Encontre todos os registros de reservas relacionados ao registro de contato do hóspede. Recupere apenas as reservas cuja data ainda não ocorreu.) As instruções padrão de ação de agente correspondem à descrição do fluxo. Quando você faz uma boa descrição do fluxo que explica exatamente o que ele faz, você economiza trabalho depois!
   
6. Em Loading Text (Carregamento de texto), insira Retrieving your booked activities (Recuperando suas atividades reservadas).
   
7. Defina as configurações de entrada da variável Contact_ID.
   

• Confirme que as instruções indicam: The Id of a Contact record that you would like to find related Booking records for. (A ID de um registro de contato para a qual você deseja encontrar registros de reservas relacionados). As instruções padrão correspondem à descrição da variável Contact_ID no fluxo. Está vendo algum padrão??
  
• Marque Require Input (Solicitar entrada).
  

8. Defina as configurações de saída da variável Contact_Bookings.
   

• Confirme que as instruções indicam: The upcoming not-canceled bookings assigned to the contact whose ID matches the Contact_ID. (As próximas reservas não canceladas atribuídas ao contato cuja ID corresponde a Contact_ID).
• Selecione Show in conversation (Mostrar na conversa).
  

9. Defina as configurações de saída da variável Error_Message_Output.
   

• Confirme que as instruções indicam: The error message to show to the customer when this flow doesn't finish successfully. (A mensagem de erro que deve ser apresentada ao cliente quando este fluxo não é concluído com êxito.)
• Selecione Show in conversation (Mostrar na conversa).
  

10. Clique em Concluir.
    

Testar o agente

Agora que o subagente está pronto, você pode testá-lo. Use o painel Conversation Preview (Visualização da conversa) no Criador do Agentforce para executar o agente e verificar se ele está funcionando conforme o esperado.

1. Ainda no Criador do Agentforce, clique em Refresh (Atualizar) (seta circular) no canto superior direito de Conversation Preview (Visualização da conversa).
   

2. Insira este prompt: Can you show me my booked activities? (Você pode mostrar as atividades que reservei?) e pressione a tecla Return/Enter.
   
3. Quando o agente responder, insira o prompt a seguir: I am sofiarodriguez@example.com and my membership number is 10008155 (Sou sofiarodriguez@exemplo.com e meu número de associação é 10008155). Pressione a tecla Return/Enter.
   

O agente mostra uma lista das atividades atualmente reservadas por Sofia, que ficará mais ou menos assim:

Here are your upcoming booked activities:
Family Adventure Quest
Date: 2025-05-11
Time: 13:30 - 14:30
Trail Running Adventure
Date: 2025-05-14
Time: 09:00 - 10:00
Seaside Gourmet Dinner
Date: 2025-05-15
Time: 09:00 - 12:00
Beach Bootcamp Challenge
Date: 2025-05-15
Time: 13:30 - 17:30
Seaside Gourmet Dinner
Date: 2025-05-16
Time: 13:30 - 16:30
Family Movie Night Under the Stars
Date: 2025-05-25
Time: 09:00 - 10:00
Ocean Kayak Fitness Expedition
Date: 2025-05-26
Time: 09:00 - 15:00
Live Music Beach Party
Date: 2025-05-26
Time: 13:30 - 15:30
Coastal Kayak Excursion
Date: 2025-05-31
Time: 13:30 - 14:30
Artisan Workshop Series
Date: 2025-06-02
Time: 13:30 - 14:30

Parabéns, você criou um fluxo que torna seu agente mais eficiente e preciso e, em seguida, forneceu a esse agente as instruções necessárias para executar o fluxo de maneira consistente. No desafio prático, você cria outra ação de agente que atualiza os registros de reservas do seu cliente.

Recursos

• Ajuda do Salesforce: Criar uma ação de agente personalizada
• Ajuda do Salesforce: Melhores práticas para instruções de ações de agente