Creare un?azione agente Apex

Obiettivi di apprendimento

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

• Creare un’Azione agente Apex.
  
• Aggiungere un’Azione agente a un argomento.
  
• Testare l’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.

Creare un’Azione agente Apex

Ora che il codice Apex è pronto, aggiungiamolo a un’azione. Potrai vedere in che punto i parametri del codice Apex si trasferiscono nell’azione.

1. Fai clic su e seleziona Setup (Imposta).
   
2. Utilizzando la casella Quick Find (Ricerca veloce) di Setup (Imposta), cerca e seleziona Agentforce Assets (Asset Agentforce).
   
3. Fai clic sulla scheda Actions (Azioni).
   
4. Fai clic su New Agent Action (Nuova azione agente).
   
5. In Reference Action Type (Tipo di azione riferimento), scegli Apex.
   
6. In Reference Action Category (Categoria azione di riferimento), seleziona Invocable Method (Metodo invocabile).
   
7. In Reference Action (Azione riferimento), seleziona Check Weather (Controlla meteo). Questo è il metodo invocabile.
   
   
   

8. In Agent Action Label (Etichetta azione agente) lascia il testo precompilato Check Weather (Controlla meteo) derivato dal parametro label (etichetta) del metodo invocabile.
   
9. In Agent Action API name (Nome API azione agente) lascia il testo precompilato Check_Weather.
   
10. Fai clic su Next (Avanti).
    

Il passaggio successivo consiste nel configurare l’azione agente. Qui si cominciano a vedere i vantaggi dell’aver impostato i parametri nel codice Apex.

1. In Agent Action Instructions (Istruzioni azione agente) lascia il testo precompilato fornito dal parametro description (descrizione) del metodo invocabile Apex.
   
2. Deseleziona Show loading text for this action (Mostra testo caricamento per questa azione).
   
3. In Input, nota che il campo dateToCheck è già compilato.
   
4. In Instructions (Istruzioni) nota che il campo è precompilato con il parametro description (descrizione) della variabile invocabile Apex. Puoi aggiornare o aggiungere testo alle istruzioni, se necessario.
   
5. Il campo Data Type (Tipo di dati) è precompilato con il tipo di dati di Apex.
   
6. Required input (Input obbligatorio) è selezionato automaticamente per effetto del parametro corrispondente in Apex, impostato su true (vero).
   
7. Seleziona Collect data from user (Raccogli dati da utente).
   
   
   

8. In Outputs (Output), le variabili invocabili Apex hanno trasferiti tre voci: maxTemperature (Temperatura max), minTemperature (Temperatura min.) e temperatureDescription (Descrizione temperatura). I campi Instructions (Istruzioni) di ciascuna voce sono precompilati con i parametri description (descrizione) e Data Type (Tipo di dati) Apex corrispondenti.
   
9. Per il terzo output, temperatureDescription (Descrizione temperatura), seleziona Show in conversation (Mostra nella conversazione).
   
   
   

10. Fai clic su Fine.
    

Ottimo! L’azione è completata. Adesso sai cosa comporta l’aggiunta di Apex alle azioni. Inoltre, ti è più chiaro in che modo i parametri Apex contribuiscono a creare l’azione. Aggiungiamo l’Azione agente Check Weather (Controlla meteo) a un argomento e proviamola.

Aggiornare l’argomento

1. Fai clic su e seleziona Setup (Imposta).
   
2. Utilizzando la casella Quick Find (Ricerca veloce) di Setup (Imposta), cerca e seleziona Agentforce Agents (Agenti Agentforce).
   
3. Seleziona Einstein Copilot o Agentforce (Default) (Agentforce (predefinito)).
   
4. Fa clic su Open in Builder (Apri nel Generatore).
   
5. Accertati che l'agente sia disattivato.
   
6. Seleziona MigrationDefaultTopic.
   
7. Fai clic su This Topic's Actions (Azioni di questo argomento).
   
8. Fai clic su New (Crea) e seleziona Add from Asset Library (Aggiungi da libreria di asset).
   
9. Seleziona la casella corrispondente all’azione Check Weather (Controlla meteo) e fai clic su Finish (Fine).
   
10. Aggiorna la finestra del browser e seleziona MigrationDefaultTopic.
    
11. Fai clic su This Topic’s Actions (Azioni di questo argomento) e verifica che l’azione Check Weather (Controlla meteo) sia ancora presente nell’elenco. Se non lo è, ripeti i passaggi da 8 a 11. In alcuni casi, negli ambienti di prova può succedere che, quando si salva un argomento per la prima volta, l’associazione delle azioni aggiunte a quell’argomento non venga preservata.
    
12. Fai clic su Activate (Attiva). Nota: se viene visualizzata la finestra popup Configuration Issues Detected (Rilevati problemi di configurazione), fai clic su Ignore & Activate (Ignora e attiva).
    

Guardiamo le previsioni meteo

1. Sempre in Agentforce Builder (Generatore Agentforce), inserisci Check the weather for tomorrow (Controlla le previsioni per domani) in Conversation Preview (Anteprima conversazione).
   
   
   

2. Dai un’occhiata ai passaggi che ha seguito l’agente e osserva che ha selezionato l’azione Check Weather (Controlla meteo) per esaudire la richiesta.
   
   
   

3. Vuoi conoscere le previsioni per la settimana prossima? Digita Check the weather for next week (Controlla il meteo della settimana prossima).
   
4. Osserva di nuovo i passaggi. L’agente ha inviato la data di ciascun giorno della settimana per creare la risposta.
   
   
   

Ben fatto! Hai compiuto un grande passo verso l’uso di tutta la funzionalità Apex già presente nell’organizzazione e nel renderla disponibile agli agenti IA affinché possano usarla. Hai appreso alcune best practice e le impostazioni da applicare ai parametri per sfruttare tutto il potenziale dei tuoi agenti.

Risorse

• Guida di Salesforce: Procedure consigliate per le istruzioni di azione degli agenti
• YouTube: Best Practices for Building Agentforce Apex Actions | TDX 2025: Developer Highlights (Best practice per la creazione di azioni Apex in Agentforce | TDX 2025: Developer Highlights)
• Blog per gli sviluppatori Salesforce: Build Advanced Custom Agent Actions with Code (Creare azioni agente personalizzate avanzate utilizzando il codice)