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 agente secondario.
  
• 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. Nell’App Launcher (Programma di avvio app) , cerca e seleziona Agentforce Studio.
   
2. Fai clic su Agent Customization (Personalizzazione agente).
   
3. Fai clic su New Versione (Nuova versione).
   
4. Sotto Subagents (Agenti secondari), seleziona Answer Weather Questions (Rispondi a domande sul meteo).
   
5. Sotto Actions Available For Reasoning (Azioni disponibili per il ragionamento), fai clic su Select action (Seleziona azione) e seleziona Create a custom action (Crea un’azione personalizzata).
   
6. In Action Name (Nome Azione), inserisci Check Weather (Controlla meteo).
   
7. In Description (Descrizione), inserisci This action will return the local weather information. (Questa azione restituisce le informazioni sul meteo locale.)
8. In Reference Action Type (Tipo di azione riferimento), scegli Apex.
   
9. In Reference Action Category (Categoria azione di riferimento), seleziona Invocable Method (Metodo invocabile).
   
10. In Reference Action (Azione riferimento), seleziona Check Weather (Controlla meteo).
    
11. Fai clic su Create and Open (Crea e apri).
    

Come vedrai, nella sezione Inputs (Input), il campo della variabile dateToCheck è stato precompilato con la descrizione specificata nel parametro description (descrizione) della variabile invocabile Apex. Puoi aggiornare o aggiungere testo alle istruzioni, se necessario.

12. Assicurati che la casella di controllo Require input to execute action (Richiedi input per eseguire l’azione) sia selezionata. Questa impostazione deriva dal codice, in cui il parametro required (obbligatorio) è impostato su true.
    
    

In Outputs (Output), sono state trasferite tre variabili invocabili Apex: maxTemperature, minTemperature e temperatureDescription. I campi Instructions (Istruzioni) di ciascuna variabile sono stati precompilati con i parametri Apex description (descrizione) e Data Type (Tipo di dati) corrispondenti.

13. Per il terzo output, temperatureDescription, seleziona Show in conversation (Mostra nella conversazione).
    
    

14. Fai clic su Save (Salva).
    
15. Fai clic su Commit Version (Conferma versione).
    
16. Fai di nuovo clic su Commit Version (Conferma versione).
    
17. Fai clic su Activate (Attiva).
    
18. Fai di nuovo clic su Activate (Attiva).
    

Ottimo! L’azione è completata. Adesso sai cosa bisogna fare per aggiungere codice Apex alle azioni. Inoltre, ti è più chiaro in che modo i parametri Apex contribuiscono a creare l’azione. Ora puoi testarla.

Guardiamo le previsioni meteo

Il Generatore Agentforce consente di lavorare con gli agenti e visualizzarne l’anteprima direttamente nello strumento.

1. Nel Generatore Agentforce, fai clic su Preview (Anteprima).
   
2. La modalità attiva dovrebbe essere Live Test Mode (Modalità Test live).
   
3. Nella casella Describe your task or ask a question (Descrivi l’operazione o poni una domanda), inserisci What’s the weather like this Monday? (Come sarà il tempo lunedì?) e premi Invio. L’agente potrebbe chiederti di inserire una data precisa e darti la possibilità di selezionarla. Seleziona la data corrispondente a lunedì prossimo e fai clic su Submit (Invia).
   
4. 
   
   

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

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)