Aggiungere un flusso come azione agente

Obiettivi di apprendimento

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

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

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.

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.

Trailcast

Se vuoi ascoltare una registrazione di questo modulo, usa il player qui sotto. Quando hai finito, ricorda di tornare a ciascuna unità, consultare le risorse e completare le valutazioni associate.

Ora che hai creato i flussi che servono all’agente esperienze Coral Cloud per aiutare i clienti a gestire le attività prenotate, crea un argomento nell’agente e assegna all’argomento le azioni basate su flusso necessarie per prestare assistenza ai clienti.

Impostazione di 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. Accertati che Einstein sia 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 argomento

Prima di creare l’argomento dell’agente, segui queste linee guida e best practice relative alla configurazione degli argomenti.

• Radica l’argomento 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’argomento specifica che non vanno usati dati di Salesforce che non siano stati forniti tramite un’azione. Non dimenticare che gli agenti hanno accesso a tutti gli oggetti e i campi che gli sono concessi dalle autorizzazioni. Questa istruzione impedisce all’agente di parlare di dati non pertinenti o che non devono essere condivisi.
  
• Nell’argomento specifica che non deve mostrare all’utente alcun valore ID. Le variabili raccolta che contengono record includono sempre i relativi, 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 menzioni un’azione agente, assicurati di usare il nome API dell’azione. Ad esempio, fai riferimento all’azione usando “Get_Customer_Details action” e non “Get Customer Details action”(azione Recupera dettagli cliente). Questa prassi aiuta l’agente a distinguere i nomi delle azioni dal testo circostante.
  

Quando configuri un argomento, fornisci la descrizione classificazione, l’ambito e le istruzioni relativi.

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

1. Nella casella Quick Find (Ricerca veloce) di Setup (Imposta), cerca e seleziona Agentforce Agents (Agenti Agentforce).
   
2. Seleziona Coral Cloud Experience Agent (Agente esperienze Coral Cloud).
   
3. Fa clic su Open in Builder (Apri nel Generatore).
   
4. Nel riquadro Topics (Argomenti), fai clic su New (Crea) e seleziona New Topic (Nuovo argomento).
   Se il pulsante New (Crea) non è visualizzato, controlla che l’agente sia disattivato. Se l’agente è già disattivato, torna alla pagina di impostazione degli agenti, disattiva Agentforce utilizzando il relativo pulsante di alternanza e poi riattivalo.
   

5. Lascia vuota la casella “What do you want this topic to do?” (Che cosa dovrà fare questo argomento?) e fai clic su Next (Avanti).
   Il campo “What do you want this topic to do?” (Che cosa dovrà fare questo argomento) compila automaticamente altri valori dell’argomento, così non devi farlo tu. Per questo esercizio, imposterai i valori manualmente in modo che possiamo vederli uno ad uno.
   
6. Nella finestra di dialogo Create a Topic (Crea un argomento), configura l’argomento come segue.
   
   • In Name (Nome), inserisci Booked Activity Management (Gestione attività prenotate).
     
   • In Classification Description (Descrizione classificazione), inserisci:
     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. (Questo argomento aiuta gli ospiti di Coral Cloud Resort a gestire e comprendere le attività prenotate. Le attività prenotate sono archiviate nell’oggetto “Prenotazioni” di Salesforce. Gli ospiti sono rappresentati dall’oggetto “Referente” di Salesforce.)
     
   • In Scope (Ambito), inserisci:
     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 Resort a prenotare le attività, dare 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 al cliente i valori degli ID.)
     
7. Nella parte bassa della finestra, fai clic su Add Instructions (Aggiungi istruzioni) tre (3) volte per visualizzare in totale tre caselle di testo per le istruzioni.
   
8. Aggiungi le istruzioni seguenti:
   
   • Nella prima istruzione inserisci:
     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.)
     
   • Nella seconda istruzione inserisci:
     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.)
     
   • Nella terza istruzione inserisci:
     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 sue attività prenotate, esegui l’azione Get_Contact_s_Upcoming_Bookings, poi presenta l’output al cliente.)
     
     
9. Fai clic su Next (Avanti).
   
10. Fai clic su Fine.
    Se viene visualizzato il messaggio Topic Overlap Detected (Rilevata sovrapposizione di argomenti), fai clic su Ignore (Ignora). Il messaggio avvisa l’autore dell’agente che potrebbe già esserci un messaggio analogo nella libreria degli argomenti dell’organizzazione. Tuttavia, questo non è rilevante ai fini di questo badge.
    

Aggiungere i flussi come azioni dell’agente

Ora dobbiamo aggiungere i flussi all’agente. Crea un’azione agente per ciascun flusso e assegnale all’argomento. Fortunatamente puoi creare queste azioni agente senza uscire dal Generatore Agentforce.

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

1. Fai clic sull’argomento Booked Activity Management (Gestione attività prenotate).
   
2. Fai clic sulla scheda This Topic's Actions (Azioni di questo argomento).
   
   
3. Fai clic su New (Crea) e seleziona Create New Action (Crea nuova azione).
   
4. In Reference Action Type (Tipo di azione riferimento), seleziona Flow (Flusso).
   
5. In Reference Action (Azione riferimento), seleziona Get Customer Details (Recupera dettagli cliente).
   
6. Lascia invariati i valori predefiniti di Label (Etichetta) e API Name (Nome API) e fai clic su Next (Avanti).
   
7. Assicurati che in Agent Action Instructions (Istruzioni azione agente) sia inserito 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 l’indirizzo email e il numero di iscrizione per vedere se esiste un referente correlato).
   
8. Disattiva la casella Show loading text for this action (Mostra testo caricamento per questa azione).
   
9. Configura le impostazioni di input della variabile email.
   
   • Verifica che il testo presente in Instructions (Istruzioni) sia The Email Address of the customer that is validating their identity.(L’indirizzo email del cliente che convalida la propria identità).
     
   • Seleziona Require Input (Input obbligatorio).
     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.
     
10. Configura le impostazioni di input della variabile memberNumber.
    
    • Verifica che il testo presente in Instructions (Istruzioni) 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 (Input obbligatorio).
      
11. Configura le impostazioni di output della variabile contact.
    
    • Verifica che il testo presente in Instructions (Istruzioni) sia The contact that was returned in the search for records.(Il referente che è stato restituito dalla ricerca nei 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.
      
12. Fai clic su Fine.
    

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

1. Nella scheda This Topic’s Actions (Azioni di questo argomento) dell’argomento Booked Activity Management (Gestione attività prenotate), fai clic su New (Crea) e seleziona Create New Action (Crea nuova azione).
   
2. In Reference Action Type (Tipo di azione riferimento), seleziona Flow (Flusso).
   
3. In Reference Action (Azione riferimento), seleziona Get Contact’s Upcoming Bookings (Recupera prossime prenotazioni del referente).
   
4. Lascia invariati i valori predefiniti di Label (Etichetta) e API Name (Nome API) e fai clic su Next (Avanti).
   
5. Assicurati che il campo Agent Action Instructions (Istruzioni azione agente) contenga 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).
   Nota che il contenuto predefinito di Agent Action Instructions (Istruzioni azione agente) corrisponde alla descrizione del flusso. Se scrivi una buona descrizione del flusso che delinea con precisione che cosa fa, ti risparmi la fatica di doverlo fare dopo.
   
6. In Loading Text (Testo caricamento) inserisci Retrieving your booked activities (Recupero delle attività prenotate).
   
7. Configura le impostazioni di input della variabile Contact_ID.
   
   • Verifica che il testo presente in Instructions (Istruzioni) 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 le Istruzioni predefinite corrispondono alla descrizione della variabile Contact_ID del flusso. Capito come funziona?
     
   • Seleziona Require Input (Input obbligatorio).
     
8. Configura le impostazioni di output della variabile Contact_Bookings.
   
   • Verifica che il testo presente in Instructions (Istruzioni) 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).
     
9. Configura le impostazioni di output della variabile Error_Message_Output.
   
   • Verifica che il testo presente in Instructions (Istruzioni) 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 ha esito negativo).
   • Seleziona Show in conversation (Mostra nella conversazione).
     
10. Fai clic su Fine.
    

Testare l'agente

Ora che l’argomento è pronto, puoi metterlo alla prova. Usa il riquadro Conversation Preview (Anteprima conversazione) nell’Agentforce Builder (Generatore Agentforce) per eseguire l’agente e verificare che funzioni come previsto.

1. Sempre nell’Agentforce Builder (Generatore Agentforce), fai clic su Refresh (Aggiorna) (freccia circolare) nell’angolo superiore destro del riquadro Conversation Preview (Anteprima conversazione).
   
   
2. Inserisci questo prompt: Can you show me my booked activities? (Puoi mostrarmi le attività che ho prenotato?), quindi 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 è 1000815). 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:
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

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 creerai un’altra azione agente per aggiornare i record Prenotazione del cliente.

Risorse

• Guida di Salesforce: Creazione di un’azione agente personalizzata
• Guida di Salesforce: Procedure consigliate per le istruzioni di azione degli agenti