Adicionar um fluxo como ação de 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.
  

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 Booking Agent (Agente de reserva da Coral Cloud) precisa para ajudar clientes a gerenciar suas atividades reservadas, crie um subagente e atribua a ele as ações baseadas em fluxo necessárias para ajudar seus clientes.

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.

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 para visualizar 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 configurar um subagente, você fornece uma descrição e as instruções.

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

1. Clique no Iniciador de aplicativos ().
   
2. Clique em View All (Exibir tudo).
   
3. Selecione o aplicativo Agentforce Studio (Estúdio do Agentforce).
   
   
4. Na lista Agents (Agentes), selecione Coral Cloud Booking Agent (Agente de reserva da Coral Cloud).
   
5. No painel do Explorador, clique em e selecione New Subagent (Novo subagente).
   
   Se o botão estiver desativado, é porque essa versão do agente já foi confirmada. Para criar uma nova versão que não foi confirmada, clique em New Version (Nova versão).
   

6. Em Subagent Name (Nome do subagente), insira Booked Activity Management (Gerenciamento da atividade reservada).
   
7. Em 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.)
8. Clique em Create and Open (Criar e abrir).
   

O criador exibe o novo subagente em branco.

Adicionar fluxos como ações de agente

Primeiro, adicione os fluxos ao agente criando uma ação de agente para cada um deles. Felizmente, você pode criar e atribuir 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. Em Actions Available for Reasoning (Ações disponíveis para raciocínio), clique em Select action (Selecionar ação).
   
2. Selecione Create a custom action (Criar uma ação personalizada).
   
3. Em Action Name (Nome da ação), insira Get Customer Details (Obter detalhes do cliente).
   
4. Em Description (Descrição), insira 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).
   
5. Em Reference Action Type (Tipo de ação de referência), selecione Flow (Fluxo).
   
6. Em Reference Action (Ação de referência), selecione Get Customer Details (Obter detalhes do cliente).
   
7. Clique em Create and Open (Criar e abrir).
   
8. Defina as configurações de entrada da variável email.
   
   • Se as seções Inputs (Entradas) e Outputs (Saídas) estiverem em branco, acesse outra guia e, em seguida, retorne à guia Get Customer Details (Obter detalhes do cliente).
     
   • Confirme que a descrição indica 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 to execute action (Exigir entrada para executar a ação).
     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.
     
9. Defina as configurações de entrada da variável memberNumber.
   
   • Confirme que a descrição indica 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 to execute action (Exigir entrada para executar a ação).
     
10. Defina as configurações de saída da variável contact.
    
    • Confirme que a descrição indica 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.
      
11. Clique na guia Booked Activity Management (Gerenciamento da atividade reservada) para retornar à tela de subagente.
    
12. Em Actions Available for Reasoning (Ações disponíveis para raciocínio), clique em ao lado da pílula Get Customer Details (Obter detalhes do cliente) na tela.
    
    A tela exibe as variáveis do fluxo e como elas são atribuídas.
    
13. Confirme que as variáveis “email” e “memberNumber” estão definidas como “Agent Populated” (Agente preenchido).
    Se não estiverem corretamente definidas, clique em , ao lado da ação Get Customer Details (Obter detalhes do cliente) na barra lateral, exclua a ação e retorne à etapa 1 para criar a ação novamente.
    

Salvar seu progresso

1. Clique em Save (Salvar).
   
2. Se a janela Assign user record (Atribuir registro de usuário) for exibida, siga estas etapas.
   
   • Selecione Select User (Selecionar usuário).
     
   • No campo Agent’s User Record (Registro de usuário do agente), selecione EinsteinServiceAgent User (Usuário EinsteinServiceAgent).
     
   • Clique em Save (Salvar).
     

Se você detectar um erro no painel do Explorador, não se preocupe com isso por agora; o erro será corrigido mais tarde.

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

1. Clique na guia Booked Activity Management (Gerenciamento da atividade reservada) para retornar à tela de subagente.
   
2. Na pílula Get Customer Details (Obter detalhes do cliente) na tela, clique em e selecione Create a custom action (Criar uma ação personalizada).
   
   
3. Em Action Name (Nome da ação), insira Get Contact’s Upcoming Bookings (Obter reservas futuras do contato).
   
4. Em Description (Descrição), insira 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.)
   
5. Em Reference Action Type (Tipo de ação de referência), selecione Flow (Fluxo).
   
6. Em Reference Action (Ação de referência), selecione Get Contact’s Upcoming Bookings (Obter reservas futuras do contato).
   
7. Clique em Create and Open (Criar e abrir).
   
8. Defina as configurações de entrada da variável Contact_ID.
   
   • Se as seções Inputs (Entradas) e Outputs (Saídas) estiverem em branco, acesse outra guia e, em seguida, retorne à guia Get Contact’s Upcoming Bookings (Obter reservas futuras do contato).
     
   • Confirme que a descrição indica 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).
     A descrição padrão corresponde à descrição da variável Contact_ID no fluxo. Está vendo algum padrão??
     
   • Marque Require input to execute action (Exigir entrada para executar a ação).
     
9. Defina as configurações de saída da variável Contact_Bookings.
   
   • Confirme que a descrição indica 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).
     
10. Defina as configurações de saída da variável Error_Message_Output.
    
    • Confirme que a descrição indica 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).
      
11. Clique em Save (Salvar).
    
12. Clique na guia Booked Activity Management (Gerenciamento da atividade reservada) para retornar à tela de subagente.
    
13. Em Actions Available for Reasoning (Ações disponíveis para raciocínio), clique em ao lado da pílula Get Contact’s Upcoming Bookings (Obter reservas futuras do contato) na tela.
    A tela exibe as variáveis do fluxo e como elas são atribuídas.
    
14. Confirme que a variável “Contact_ID” está definida como “Agent Populated” (Agente preenchido).
    Se não estiver corretamente definida, passe o mouse sobre a ação Get Contact’s Upcoming Bookings (Obter reservas futuras do contato) na barra lateral, clique em, exclua a ação e retorne à etapa 1 para criar a ação novamente.
    

Atualizar a saída Contact_Bookings

Lembre-se: Contact_Bookings é uma variável da coleção de registros no fluxo Get Contact’s Upcoming Bookings (Obter reservas futuras do contato). As variáveis da coleção de registros devem ser especialmente configuradas no script do subagente, portanto, atualize o script para evitar erros futuros.

1. Clique na guia Get Contact’s Upcoming Bookings (Obter reservas futuras do contato).
   Se esta guia não estiver presente, você pode pular para a etapa seguinte. Se você clicar nesta guia, o texto exibido em passos seguintes fica mais fácil de encontrar; mas você ainda pode usar a função Find (Encontrar) do navegador (Ctrl-F no Windows, Command-F no Mac) para localizar o texto.
   
2. Na linha de guias, selecione a lista suspensa Canvas (Tela) e selecione Script.
   
   
3. Encontre a linha Contact_Bookings: object.
   
   
4. Altere Contact_Bookings: object para Contact_Bookings: list[object].
   
5. Algumas linhas a seguir à linha Contact_Bookings, encontre a linha complex_data_type_name: "lightning__listType".
   
6. Altere complex_data_type_name: "lightning__listType" para complex_data_type_name: "lightning__recordInfoType".
   
7. Clique em Save (Salvar).
   
8. Na linha de guias, altere a lista suspensa Script novamente para Canvas (Tela).
   

Fornecer instruções ao subagente

Agora, defina as instruções para este subagente.

1. No Explorador, clique no subagente Booked Activity Management (Gerenciamento da atividade reservada).
   
2. Em Reasoning Instructions (Instruções de raciocínio), adicione este parágrafo:
   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.)
   
3. Pressione Enter para iniciar uma nova linha e adicione um segundo parágrafo:
   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.)
   
4. No parágrafo anterior, destaque o texto Get_Contact_s_Upcoming_Bookings e digite @.
   Ao digitar @ nas instruções, o Criador do Agentforce exibe um menu contextual para referenciar ações específicas, variáveis, subagentes e outras opções diretamente nessas instruções.
   
   

Se o Criador do Agentforce não exibir o menu contextual quando você digitar @, ignore as etapas 4-5 e siga estas etapas.

1. Selecione a lista suspensa Canvas (Tela) e selecione Script.
   
2. Procure a linha de instruções que começa com If the customer asks (Se o cliente pedir).
   
3. Nessa linha, entre as palavras “the” e “action”, adicione o seguinte texto: {!@actions.Get_Contact_s_Upcoming_Bookings}
4. Altere a lista suspensa Script novamente para Canvas (Tela). Suas instruções devem ser semelhantes às exibidas na imagem da etapa 5.
   

5. Selecione Actions (Ações) e selecione Get Contact’s Upcoming Bookings (Obter reservas futuras do contato).
   Você faz referência à ação Get Contact’s Upcoming Bookings (Obter reservas futuras do contato) aqui para garantir que o Agentforce executa essa ação.
   
   
6. Pressione Enter para iniciar uma nova linha e adicione um terceiro parágrafo:
   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.)
   
7. Pressione Enter para iniciar uma nova linha e adicione mais um parágrafo:
   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.)
   
8. No último parágrafo, destaque o texto Get_Customer_Details e digite @.
   

Se o Criador do Agentforce não exibir o menu contextual quando você digitar @, ignore as etapas 8-9 e siga estas etapas.

1. Selecione a lista suspensa Canvas (Tela) e selecione Script.
   
2. Procure a linha de instruções que começa com If the customer is not (Se o cliente não for).
   
3. Nessa linha, entre as palavras “the” e “action”, adicione o seguinte texto: {!@actions.Get_Customer_Details}
4. Altere a lista suspensa Script novamente para Canvas (Tela). A quarta instrução deve agora conter a ação Get Customer Details (Obter detalhes do cliente).
   

9. Selecione Actions (Ações) e selecione Get Customer Details (Obter detalhes do cliente).
   
10. Salve o agente.
    

Testar o agente

Agora que o subagente está pronto, você pode testá-lo. Use a guia Preview (Visualização) no Criador do Agentforce para executar o agente e confirmar que está funcionando como esperado.

1. Ainda no Criador do Agentforce, clique na guia Preview (Visualização).
   
   
2. No painel Let’s Chat, na caixa “Describe your task or ask a question” (Descreva a tarefa ou faça uma pergunta), insira 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) e 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 at Coral Cloud Resort:
Family Adventure Quest - August 8, 2026, 1:30 PM to 2:30 PM
Trail Running Adventure - August 11, 2026, 9:00 AM to 10:00 AM
Beach Bootcamp Challenge - August 12, 2026, 1:30 PM to 5:30 PM
Seaside Gourmet Dinner - August 12, 2026, 9:00 AM to 12:00 PM
Seaside Gourmet Dinner - August 13, 2026, 1:30 PM to 4:30 PM
Family Movie Night Under the Stars - August 22, 2026, 9:00 AM to 10:00 AM
Live Music Beach Party - August 23, 2026, 1:30 PM to 3:30 PM
Ocean Kayak Fitness Expedition - August 23, 2026, 9:00 AM to 3:00 PM
Coastal Kayak Excursion - August 28, 2026, 1:30 PM to 2:30 PM
Artisan Workshop Series - August 30, 2026, 1:30 PM to 2:30 PM

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ê adiciona uma ação de agente que atualiza os registros de reservas do seu cliente.

Recursos

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