Adicionar um fluxo como ação de agente

Objetivos de aprendizagem

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

• Fundamentar o tópico de um agente 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 tópico 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.

Agora que você criou os fluxos que o Coral Cloud Experience Agent (Agente da Coral Cloud no Experience Cloud) precisa para ajudar os clientes a gerenciar suas atividades reservadas, crie um tópico 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), pesquise e selecione Einstein Setup (Configuração do Einstein).
   
2. Confirme que (Ativar o Einstein) está On (Ativado).
   
3. Atualize seu navegador para recarregar Setup (Configuração).
   
4. Em Setup (Configuração), na caixa Quick Find (Busca rápida), pesquise e selecione Agentforce Agents (Agentes do Agentforce).
   
5. Confirme que Agentforce está On (Ativado).
   

Adicionar um tópico

Antes de criar o tópico do agente, considere algumas diretrizes e melhores práticas para configurar tópicos.

• Fundamente seu tópico 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 tópico 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 tópico 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 tópico, você fornece a descrição da classificação, o escopo e as instruções desse mesmo tópico.

Agora, crie um tópico 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), pesquise 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 Topics (Tópicos), clique em New (Novo) e selecione New Topic (Novo tópico).
   Se o botão New (Novo) não aparecer, 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 topic to do? (O que você quer que o tópico faça?)” em branco e clique em Next (Avançar).
   O campo “What do you want this topic to do? (O que você quer que o tópico faça?)” preenche automaticamente outros valores do tópico para você. Para este exercício, você define os valores manualmente para que possamos orientá-lo.
   
6. Na caixa Create a Topic (Criar um tópico), configure o elemento Start (Início) 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 topic 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 tópico 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) duas (2) vezes para exibir caixas de texto com um total de três 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 Next (Avançar).
   
10. Clique em Finish (Concluir).
    Se uma janela com a mensagem Topic Overlap Detected (Sobreposição de tópicos detectada) abrir, clique em Ignore (Ignorar). A mensagem alerta o criador do agente que pode já existir um tópico semelhante na biblioteca de tópicos 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 tópico. 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 tópico Booked Activity Management (Gerenciamento da atividade reservada).
   
2. Clique na guia This Topic’s Actions (Ações desse tópico).
   
   
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.)
    • Marque 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 Finish (Concluir).
    

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

1. Na guia This Topic’s Actions (Ações deste tópico) do tópico 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 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.)
   • Marque 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.)
   • Marque Show in conversation (Mostrar na conversa).
     
10. Clique em Finish (Concluir).
    

Testar o agente

Agora que o tópico 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 prima 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