Aggiungere un flusso come azione agente

Obiettivi di apprendimento

Al completamento di questa unità, sarai in grado di:

• Radicare nel contesto un agente secondario per la massima efficacia utilizzando azioni agente basate su flussi.
  
• Creare un’azione agente che faccia riferimento a un flusso.
  
• Configurare un agente secondario in modo che un’azione agente fornisca i dati a un’altra azione agente.
  

Questo badge presuppone la conoscenza dei flussi ed esperienza nell’uso di Flow Builder. Segui l’itinerario Creare flussi con Flow Builder per acquisire solide competenze di automazione dei processi e diventare un guru di Flow Builder.

Ora che hai creato i flussi che servono all’agente Coral Cloud Booking Agent (Agente prenotazioni Coral Cloud) per aiutare i clienti a gestire le attività prenotate, crea un agente secondario nell’agente e assegnagli le azioni basate su flusso necessarie per prestare assistenza ai clienti.

Nota

Stai seguendo la formazione in italiano? Inizia la sfida in un Trailhead Playground in italiano e utilizza le traduzioni fornite tra parentesi per la navigazione. Per quanto riguarda i valori da inserire, copia e incolla solo quelli in lingua inglese, perché la convalida della sfida è basata sul fatto che i dati siano in inglese. Se non superi la sfida nella tua organizzazione italiana, ti consigliamo di (1) selezionare Stati Uniti per le impostazioni internazionali, (2) selezionare Inglese per la lingua seguendo le istruzioni riportate qui e, successivamente, (3) fare nuovamente clic sul pulsante "Controlla la sfida".

Visita il badge Trailhead nella tua lingua per informazioni dettagliate su come usufruire dell'esperienza Trailhead in altre lingue.

Impostare Agentforce

Innanzitutto assicurati di aver abilitato Agentforce nel tuo Trailhead Playground.

1. Nella casella Quick Find (Ricerca veloce) di Setup (Imposta), cerca e seleziona Einstein Setup (Impostazione Einstein).
   
2. Verifica se Einstein è attivato. Se lo è, sposta il pulsante di alternanza su Off (Disattivato) e poi reimpostalo su On (Attivato).
   
3. Aggiorna il browser per caricare nuovamente la pagina Setup (Imposta).
   
4. Nella casella Quick Find (Ricerca veloce) di Setup (Imposta), cerca e seleziona Agentforce Agents (Agenti Agentforce).
   
5. Controlla che il pulsante di alternanza Agentforce sia impostato su On (Attivato).
   

Aggiungere un agente secondario

Prima di creare l’agente secondario, segui queste linee guida e best practice relative alla configurazione degli agenti secondari.

• Radica l’agente secondario nel contesto di informazioni sugli oggetti Salesforce pertinenti. Descrivi lo scopo degli oggetti in modo che l’agente capisca come vengono usati i relativi dati.
  
• Nell’agente secondario specifica che non vanno usati dati di Salesforce che non siano stati forniti tramite un’azione. Non dimenticare che gli agenti possono visualizzare tutti gli oggetti e i campi a cui hanno accesso in base alle autorizzazioni loro concesse. Questa istruzione impedisce all’agente di parlare di dati non pertinenti o che non devono essere condivisi.
  
• Nell’agente secondario specifica che non deve mostrare all’utente alcun valore ID. Le variabili raccolta che contengono record includono sempre i relativi ID, quindi, senza questa istruzione è molto probabile che l’agente mostri quei dati ai clienti, anche se per loro non significano nulla. Questa istruzione evita di confondere i clienti con dati incomprensibili.
  

Quando configuri un agente secondario, fornisci la descrizione e le istruzioni associate.

Ora crea un agente secondario che dica all’agente cosa può fare e cosa non può fare con le attività prenotate del cliente.

1. Fai clic sull'App Launcher (Programma di avvio app) ().
   
2. Fai clic su View All (Visualizza tutto).
   
3. Seleziona l’app Agentforce Studio.
   
   
4. Nell’elenco degli agenti, seleziona Coral Cloud Booking Agent (Agente prenotazioni Coral Cloud).
   
5. Nel riquadro Explorer (Esplorazione), fai clic su e seleziona New Subagent (Nuovo agente secondario).
   
   Se il pulsante non è abilitato, vuol dire che la versione corrente dell’agente è stata confermata. Per creare una versione non confermata, fai clic su New Version (Nuova versione).
   

6. In Subagent Name (Nome agente secondario), inserisci Booked Activity Management (Gestione attività prenotate).
   
7. In Description (Descrizione), inserisci: 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. (Questo agente secondario aiuta gli ospiti di Coral Cloud Resorts a gestire e comprendere le attività che hanno prenotato. In Salesforce, le attività prenotate sono archiviate nell’oggetto “Prenotazioni” e gli ospiti sono rappresentati dall’oggetto “Referente”.)
8. Fai clic su Create and Open (Crea e apri).
   

Il nuovo agente secondario vuoto viene visualizzato nel generatore.

Aggiungere i flussi come azioni dell’agente

Per prima cosa aggiungi i flussi all’agente creando un’azione agente per ciascuno di essi. Per fortuna puoi creare ed assegnare queste azioni agente senza dover uscire dall’Agentforce Builder (Generatore Agentforce).

Aggiungere l’azione Get Customer Details (Recupera dettagli cliente) all’agente

1. Sotto Actions Available for Reasoning (Azioni disponibili per il ragionamento), fai clic su Select action (Seleziona azione).
   
2. Seleziona Create a custom action (Crea un’azione personalizzata).
   
3. In Action Name (Nome azione), inserisci Get Customer Details (Recupera dettagli cliente).
   
4. In Description (Descrizione), inserisci Validate a Customer’s details by passing their email and memberNumber to see if there is a related contact. (Convalida i dettagli del cliente passando il suo indirizzo email e il suo numero di iscrizione per vedere se esiste un referente correlato).
   
5. In Reference Action Type (Tipo di azione riferimento), seleziona Flow (Flusso).
   
6. In Reference Action (Azione riferimento), seleziona Get Customer Details (Recupera dettagli cliente).
   
7. Fai clic su Create and Open (Crea e apri).
   
8. Configura le impostazioni di input della variabile email.
   
   • Se le sezioni Input e Output sono vuote, passa a un’altra scheda e ritorna alla scheda Get Customer Details (Recupera dettagli cliente).
     
   • Verifica che il testo presente in Description (Descrizione) sia The Email Address of the customer that is validating their identity. (L’indirizzo email del cliente che convalida la sua identità.)
     
   • Seleziona Require input to execute action (Richiedi input per eseguire l’azione).
     Questa impostazione dice all’agente di non eseguire l’azione a meno che non abbia dati da inviare. Usa questa impostazione per garantire che il flusso non venga eseguito senza i dati necessari per la sua corretta esecuzione.
     
9. Configura le impostazioni di input della variabile memberNumber.
   
   • Verifica che il testo presente in Description (Descrizione) sia The Member Number of the customer that is validating their identity. (Il numero di iscrizione del cliente che convalida la sua identità.)
   • Seleziona Require input to execute action (Richiedi input per eseguire l’azione).
     
10. Configura le impostazioni di output della variabile contact.
    
    • Verifica che il testo presente in Description (Descrizione) sia The contact that was returned in the search for records. (Il referente che è stato restituito dalla ricerca dei record.)
    • Seleziona Show in conversation (Mostra nella conversazione).
      Questa impostazione dice all’agente che è autorizzato a inviare al cliente i contenuti di questa variabile. Se la casella di controllo Show in conversation (Mostra nella conversazione) relativa a un particolare output non è selezionata, i contenuti di quella variabile del flusso non saranno mai condivisi con il cliente.
      
11. Fai clic sulla scheda Booked Activity Management (Gestione attività prenotate) per tornare all’area di disegno dell’agente secondario.
    
12. Sotto Actions Available for Reasoning (Azioni disponibili per il ragionamento), fai clic su accanto al pulsante Get Customer Details (Recupera dettagli cliente) sull’area di disegno.
    
    Sull’area di disegno vengono visualizzate le variabili del flusso e le relative assegnazioni.
    
13. Verifica che l’impostazione delle variabili “email” e “memberNumber” sia “Agent Populated” (Valore fornito dall’agente).
    Se l’impostazione non è corretta, fai clic su accanto all’azione Get Customer Details (Recupera dettagli cliente) nella barra laterale, elimina l’azione e ritorna al passaggio 1 per ricreare l’azione.
    

Salvare il lavoro

1. Fai clic su Save (Salva).
   
2. Se viene visualizzata la finestra Assign user record (Assegna record utente), segui questi passaggi.
   
   • Seleziona Select User (Seleziona utente).
     
   • Nel campo Agent’s User Record (Record utente dell’agente), seleziona EinsteinServiceAgent User (Utente EinsteinServiceAgent.
     
   • Fai clic su Save (Salva).
     

Se viene visualizzato un errore nel riquadro Explorer (Esplorazione), non preoccuparti: lo correggeremo dopo.

Aggiungere l’azione Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente) all’agente

1. Fai clic sulla scheda Booked Activity Management (Gestione attività prenotate) per tornare all’area di disegno dell’agente secondario.
   
2. Fai clic su nel pulsante Get Customer Details (Recupera dettagli cliente) e seleziona Create a custom action (Crea un’azione personalizzata).
   
   
3. In Action Name (Nome azione), inserisci Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente).
   
4. In Description (Descrizione) inserisci: Find all the Booking records related to the guest's contact record. Only retrieve Bookings whose date hasn't occurred yet. (Trova tutti i record prenotazione correlati al record Referente dell’ospite. Recupera solo le prenotazioni la cui data non è ancora passata.)
   
5. In Reference Action Type (Tipo di azione riferimento), seleziona Flow (Flusso).
   
6. In Reference Action (Azione riferimento), seleziona Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente).
   
7. Fai clic su Create and Open (Crea e apri).
   
8. Configura le impostazioni di input della variabile Contact_ID.
   
   • Se le sezioni Input e Output sono vuote, passa a un’altra scheda e ritorna alla scheda Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente).
     
   • Verifica che il testo presente in Description (Descrizione) sia The Id of a Contact record that you would like to find related Booking records for. (L’ID di un record Referente di cui vuoi trovare i record Prenotazione correlati.)
     Nota che la descrizione predefinita corrisponde alla descrizione della variabile Contact_ID del flusso. Capito come funziona?
     
   • Seleziona Require input to execute action (Richiedi input per eseguire l’azione).
     
9. Configura le impostazioni di output della variabile Contact_Bookings.
   
   • Verifica che il testo presente in Description (Descrizione) sia The upcoming not-canceled bookings assigned to the contact whose ID matches the Contact_ID. (Le prossime prenotazioni non annullate assegnate al referente il cui ID corrisponde a Contact_ID.)
   • Seleziona Show in conversation (Mostra nella conversazione).
     
10. Configura le impostazioni di output della variabile Error_Message_Output.
    
    • Verifica che il testo presente in Description (Descrizione) sia The error message to show to the customer when this flow doesn't finish successfully. (Il messaggio di errore da mostrare al cliente quando questo flusso non viene completato correttamente).
    • Seleziona Show in conversation (Mostra nella conversazione).
      
11. Fai clic su Save (Salva).
    
12. Fai clic sulla scheda Booked Activity Management (Gestione attività prenotate) per tornare all’area di disegno dell’agente secondario.
    
13. Sotto Actions Available for Reasoning (Azioni disponibili per il ragionamento), fai clic su accanto al pulsante Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente) sull’area di disegno.
    Sull’area di disegno vengono visualizzate le variabili del flusso e le relative assegnazioni.
    
14. Verifica che l’impostazione della variabile “Contact_ID” sia “Agent Populated” (Valore fornito dall’agente).
    Se l’impostazione non è corretta, passa il mouse sopra Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente) nella barra laterale, fai clic su , elimina l’azione e ritorna al passaggio 1 per ricreare l’azione.
    

Aggiornare l’output Contact_Bookings

Come ricorderai, Contact_Bookings è una variabile raccolta di record del flusso Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente). Le variabili raccolta di record devono essere configurate in modo specifico nello script dell’agente secondario, quindi devi aggiornare lo script per prevenire errori in futuro.

1. Fai clic sulla scheda Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente).
   Se la scheda non è presente, puoi saltare al prossimo passaggio. Se fai clic su questa scheda, il testo riportato nei prossimi passaggi sarà più facile da trovare, ma puoi anche utilizzare la funzionalità di ricerca del browser (Ctrl+F su Windows e Comando+F sul Mac) per trovarlo.
   
2. Nella riga delle schede, seleziona l’elenco a discesa Canvas (Area di disegno) e seleziona Script.
   
   
3. Trova la riga con Contact_Bookings: object.
   
   
4. Sostituisci Contact_Bookings: object con Contact_Bookings: list[object].
   
5. Alcune righe dopo quella che contiene Contact_Bookings, trova la riga che contiene complex_data_type_name: "lightning__listType".
   
6. Sostituisci complex_data_type_name: "lightning__listType" con complex_data_type_name: "lightning__recordInfoType".
   
7. Fai clic su Save (Salva).
   
8. Nella riga delle schede, seleziona Canvas (Area di disegno) nell’elenco a discesa Script.
   

Fornire istruzioni all’agente secondario

È il momento di impostare le istruzioni per l’agente secondario.

1. In Explorer (Esplorazione), fai clic sull’agente secondario Booked Activity Management (Gestione attività prenotate).
   
2. In Reasoning Instructions (Istruzioni per il ragionamento) aggiungi questo paragrafo:
   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. (Il tuo compito è solo aiutare gli ospiti di Coral Cloud Resorts a prenotare attività, dare loro informazioni sulle attività che hanno prenotato, se presenti, e annullare le attività che hanno già prenotato. Non usare dati di Salesforce che non siano stati forniti dall’output di un’azione. Non mostrare ai clienti i valori degli ID.)
   
3. Premi Invio per inserire una riga e aggiungi un secondo paragrafo:
   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 il cliente chiede quali sono attualmente le attività che ha prenotato, esegui l’azione Get_Contact_s_Upcoming_Bookings, quindi presenta l’output al cliente.)
   
4. Nel paragrafo precedente, seleziona il testo Get_Contact_s_Upcoming_Bookings e digita @.
   Quando digiti “@” nelle istruzioni, il Generatore Agentforce visualizza un menu contestuale che consente di inserire direttamente riferimenti ad azioni, variabili, agenti secondari specifici e ad altre opzioni.
   
   

Se il menu contestuale non viene visualizzato quando digiti “@”, ignora i passaggi 4 e 5 e segui invece questi passaggi.

1. Seleziona l’elenco a discesa Canvas (Area di disegno) e seleziona Script.
   
2. Cerca la riga di istruzioni che inizia con If the customer asks (Se il cliente chiede).
   
3. Su quella riga, aggiungi il testo seguente tra le parole “the” e “action”: {!@actions.Get_Contact_s_Upcoming_Bookings}.
4. Nell’elenco a discesa Script, seleziona nuovamente Canvas (Area di disegno). Le istruzioni dovrebbero avere l’aspetto raffigurato nell’immagine riportata nel passaggio 5.
   

5. Seleziona Actions (Azioni) e poi Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente).
   Il riferimento a Get Contact’s Upcoming Bookings (Recupera le prossime prenotazioni del referente) qui serve ad assicurare che Agentforce esegua quell’azione.
   
   
6. Premi Invio per inserire una riga e aggiungi un terzo paragrafo:
   After showing the customer a list of their activities, ask them how you can help them. (Dopo aver mostrato al cliente un elenco delle sue attività, chiedi come puoi essere d’aiuto.)
   
7. Premi invio per inserire una riga e aggiungi un altro paragrafo:
   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 non conosci il cliente, prima di eseguire qualsiasi altra azione devi sempre chiedere il suo indirizzo email e il suo numero di iscrizione per recuperare il suo record Referente eseguendo l’azione Get_Customer_Details.)
   
8. Nell’ultimo paragrafo, evidenzia il testo Get_Customer_Details e digita @.
   

Se il menu contestuale non viene visualizzato quando digiti “@”, ignora i passaggi 8 e 9 e segui invece questi passaggi.

1. Seleziona l’elenco a discesa Canvas (Area di disegno) e seleziona Script.
   
2. Cerca la riga di istruzioni che inizia con If the customer is not (Se non conosci il cliente).
   
3. Su quella riga, aggiungi il testo seguente tra le parole “the” e “action”: {!@actions.Get_Customer_Details}.
4. Nell’elenco a discesa Script, seleziona nuovamente Canvas (Area di disegno). La quarta istruzione dovrebbe ora contenere l’azione Get Customer Details (Recupera dettagli cliente).
   

9. Seleziona Actions (Azioni) e poi Get Customer Details (Recupera dettagli cliente).
   
10. Salva l’agente.
    

Testare l'agente

Ora che l’agente secondario è pronto, puoi metterlo alla prova. Usa la scheda Preview (Anteprima) nell’Agentforce Builder (Generatore Agentforce) per eseguire l’agente e verificare che funzioni come previsto.

1. Nell’Agentforce Builder (Generatore Agentforce), fai clic sulla scheda Preview (Anteprima).
   
   
2. Nella casella “Describe your task or ask a question” (Descrivi l’operazione o poni una domanda) del riquadro Let’s Chat (Avvia la chat), inserisci Can you show me my booked activities? (Puoi mostrarmi le attività che ho prenotato?) e premi il tasto Invio.
   
3. Dopo la risposta dell’agente, inserisci il prompt successivo, I am sofiarodriguez@example.com and my membership number is 10008155 (Sono sofiarodriguez@example.com e il mio numero di iscrizione è 10008155), e premi il tasto Invio.
   

L’agente mostra un elenco delle attività correntemente prenotate per Sofia, che si presenta più o meno così:

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

Congratulazioni, hai creato un flusso che rende il tuo agente più preciso ed efficace, poi hai fornito all’agente le istruzioni necessarie per eseguire il flusso con coerenza. Nella sfida pratica aggiungerai un’azione agente per aggiornare i record Prenotazione del cliente.

Risorse

• Guida di Salesforce: Creare un'azione personalizzata
• Guida di Salesforce: Procedure consigliate per le istruzioni di azione degli agenti