Introduzione ad Agentforce DX

Obiettivi di apprendimento

Gli obiettivi di questo progetto sono:

• Spiegare in che modo Agentforce DX facilita la creazione di agenti.
  
• Configurare l’ambiente di sviluppo di Agentforce DX.
  
• Clonare un repository che contiene un agente di esempio in un progetto DX.
  

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.

Coral Clouds Resorts e Agentforce DX

Congratulazioni! Hai appena iniziato a lavorare nel team di sviluppo di Coral Cloud Resorts e non vedi l’ora di metterti al lavoro. Il tuo nuovo responsabile ti spiega che il team sta lavorando sodo alla creazione di agenti. Hanno già iniziato a svilupparne uno chiamato “Local Info Agent” (Agente info locali), che fornisce ai clienti aggiornamenti meteo locali e informazioni sugli eventi che hanno luogo in zona, e ora sarai tu a occuparti del progetto. Ma tu non hai mai sviluppato un agente su Salesforce prima d’ora, quindi hai bisogno di un po’ di formazione per imparare le nozioni di base. Continua a leggere!

Come professionista dello sviluppo al passo con i tempi, utilizzi abitualmente gli strumenti di sviluppo più recenti, quali i sistemi di controllo delle versioni come GitHub per l’archiviazione del codice sorgente e l’integrazione di sviluppo e testing in job CI (Continuous Integration). Sembra un lavoro perfetto per Agentforce DX.

Che cos’è Agentforce DX?

Finora, hai probabilmente creato agenti utilizzando l’interfaccia utente del Generatore Agentforce, ossia il metodo low-code che consente di creare agenti con pochi clic, senza dover scrivere codice. Tuttavia, per integrare l’IA in una moderna pipeline DevOps, è necessario andare oltre il browser ed entrare nel mondo pro-code di Agentforce Developer Experience (DX). Questo cambiamento consente di trattare la logica degli agenti sotto forma di codice sorgente, gestirne le versioni in un repository e distribuirla insieme ai componenti Apex e Lightning.

Se hai esperienza nello sviluppo su Salesforce, probabilmente conosci già Salesforce DX, un insieme di strumenti per creare, testare e rilasciare applicazioni su Salesforce Platform. Questi strumenti comprendono Agentforce Vibes, le estensioni per Visual Studio Code (VS Code), Salesforce CLI e molto altro. Agentforce DX estende questi strumenti per applicarli anche agli agenti.

Gli agenti sono composti da metadati, come qualsiasi altra personalizzazione di Salesforce. Agentforce DX fornisce strumenti pro-code per creare, modificare, visualizzare in anteprima e testare gli agenti al di fuori dell’interfaccia utente del Generatore Agentforce. È inoltre utile per spostare i metadati degli agenti tra i progetti DX e le organizzazioni vuote, gli ambienti sandbox e le organizzazioni di produzione con cui lavori. Queste funzionalità permettono di incorporare gli agenti nel moderno processo di sviluppo di software.

Registrarsi per un’organizzazione Developer Edition con Agentforce

Per completare questo progetto hai bisogno di una speciale organizzazione Developer Edition che contenga Agentforce e i nostri dati di esempio. Accedi alla versione gratuita di Developer Edition e collegala a Trailhead adesso per poter completare le sfide di questo progetto. Tieni presente che questa Developer Edition è destinata a funzionare con le sfide presenti in questo badge e potrebbe non funzionare con altri badge. Controlla sempre se stai utilizzando un Trailhead Playground o la speciale organizzazione Developer Edition consigliata da noi.

1. Registrati per un’organizzazione Developer Edition gratuita con Agentforce.
   
2. Compila il modulo.
   
   • In Email, inserisci un indirizzo email attivo.
     
   • In Username (Nome utente), inserisci un indirizzo email univoco, ad esempio: tuonome@test.com. Non è necessario che l’indirizzo corrisponda a un account reale.
     
3. Al termine, fai clic su Sign me up (Registrami). Viene visualizzato un messaggio di conferma.
   
4. Quando ricevi l'email di attivazione (potresti dover attendere qualche minuto), aprila e fai clic su Verifica account.
   
5. Completa la registrazione impostando la password e la domanda di controllo.
   
   • Suggerimento: per ritrovare facilmente il nome utente, la password e l’URL di accesso, salvali in un posto sicuro, ad esempio un gestore di password. Queste informazioni ti serviranno in seguito, per autorizzare Salesforce CLI a usare la tua organizzazione Developer Edition.
     
6. Hai eseguito l'accesso alla tua Developer Edition.
   

Ora collega la nuova organizzazione Developer Edition a Trailhead.

1. Assicurati di aver eseguito l’accesso al tuo account Trailhead.
   
2. Nella sezione Verifica passaggio, in fondo a questa pagina, fai clic sull’organizzazione di prova visualizzata e quindi su Connetti organizzazione.
   
3. Nella schermata di accesso, inserisci il nome utente e la password associati alla Developer Edition che hai appena impostato.
   
4. Nella schermata Allow Access? (Consentire l’accesso?), fai clic su Allow (Consenti).
   
5. Nella schermata Want to connect this org for hands-on challenges? (Vuoi connettere questa organizzazione per le sfide pratiche?) fai clic su Yes! Save it (Sì! Salva). Il sistema ti reindirizzerà alla pagina della sfida, dove potrai subito iniziare a utilizzare la tua nuova Developer Edition per ottenere questo badge.
   

Attivare Agentforce nell’organizzazione Developer Edition

Per sviluppare agenti con Agentforce DX, è necessario attivare Agentforce nell’organizzazione Developer Edition.

1. Accedi alla tua organizzazione Developer Edition e fai clic sull’icona Setup (Imposta) a forma di ingranaggio, in alto a destra.
   
2. Fai clic su Setup (Imposta) nel menu a discesa.
   
3. Inserisci Einstein Setup (Impostazione Einstein) nella casella Quick Find (Ricerca veloce) e fai clic su Einstein Setup (Impostazione Einstein).
   
4. Accertati che il pulsante di alternanza in corrispondenza di Turn on Einstein (Attiva Einstein) sia impostato su On (Attivato).
   
   
5. Inserisci Einstein Bots (Bot Einstein) nella casella Quick Find (Ricerca veloce) e fai clic su Einstein Bots (Bot Einstein).
   
6. Sposta il pulsante di alternanza in corrispondenza di Einstein Bots (Bot Einstein) su On (Attivato).
   
   
7. Inserisci Salesforce Go nella casella Quick Find (Ricerca veloce), quindi seleziona Salesforce Go.
   
8. Nella casella di testo Search features… (Cerca funzioni…), inserisci Agentforce e seleziona Agentforce (Default) (Agentforce (predefinito)).
   
9. Fai clic su Get Started (Per iniziare).
   
10. Fai clic su Turn On (Attiva).
    
    
11. Fai clic su Confirm (Conferma).
    

Configurare l’ambiente di sviluppo

Il passaggio successivo consiste nel configurare l’ambiente di sviluppo locale. Per la creazione degli agenti, il team di sviluppo di Coral Cloud Resorts utilizza sia VS Code, sia i comandi CLI. VS Code è un ambiente di sviluppo integrato (IDE, Integrated Development Environment), che comprende un editor di codice, strumenti di automazione della compilazione, un debugger e funzionalità di completamento intelligente del codice.

Se hai esperienza nello sviluppo su Salesforce e usi strumenti pro-code, probabilmente hai già installato VS Code (con le estensioni Salesforce) sul tuo computer. Puoi utilizzare la stessa configurazione, ma assicurati di aggiornare tutte le estensioni per VS Code alla release più recente. Devi anche installare Node.js sul tuo computer.

Segui questi passaggi per configurare l’ambiente.

1. Per installare VS Code sul tuo computer, vai all’indirizzo code.visualstudio.com e fai clic su Download (Scarica).
   
2. Istalla il pacchetto di estensioni Salesforce dal VS Code Marketplace. Agentforce DX e Agentforce Vibes sono due delle estensioni che vengono installate automaticamente.
   
3. Installa Salesforce CLI.
   
4. Installa Node.js.
   Installa Node.js globalmente sul tuo computer adesso, così potrai eseguire lo script di installazione più avanti in questa unità.
   

Clonare il repository di esempio

Come già accennato, i membri del team di sviluppo hanno iniziato a lavorare sul Local Info Agent (Agente info locali) e hanno archiviato il codice in un repository GitHub. Il codice sorgente è organizzato mediante un progetto Salesforce DX standard, che fornisce una struttura per i metadati (codice e configurazione) dell’organizzazione, per i dati di esempio e per tutti i test del team. Gli agenti sono come qualsiasi altro elemento dell’organizzazione Salesforce, nel senso che sono composti da metadati. Pertanto, per archiviarli e lavorare con gli agenti è comunque opportuno utilizzare progetti DX.

Assicurati che Git sia installato sul tuo computer, in modo da poter clonare il repository in VS Code. In alternativa, puoi scaricare il repository di esempio come file ZIP ed espanderlo in locale.

Segui questi passaggi per usare Git per clonare il repository di esempio in modo da poter iniziare a sviluppare l’agente.

1. Apri VS Code e fai clic su View | Command Palette (Visualizza | Riquadro comandi), quindi scegli Git: Clone (Git: Clona).
   
2. Inserisci https://github.com/forcedotcom/afdx-pro-code-testdrive come URL del repository.
   
3. Vai alla directory dove vuoi salvare il codice sorgente e fai clic su Select as Repository Destination (Seleziona come destinazione del repository).
   
4. Fai clic su Open (Apri).
   

In VS Code viene visualizzato un progetto Salesforce DX standard denominato afdx-pro-code-testdrive. Se lo desideri, puoi esaminare il codice esistente. Più avanti in questo badge verranno discussi alcuni degli artefatti correlati all’agente.

Autorizzare l’organizzazione Developer Edition

Utilizza il nome utente e la password dell’organizzazione Developer Edition per autorizzare l’organizzazione in locale, in modo che VS Code e i comandi CLI possano interagire con l’organizzazione.

1. In VS Code fai clic su View | Command Palette (Visualizza | Riquadro comandi), quindi scegli SFDX: Authorize an Org (SFDX: Autorizza un’organizzazione).
   
2. Fai clic su Production (Produzione).
   
3. Inserisci agentforce come alias dell’organizzazione.
   
4. Nella finestra del browser che si apre, accedi alla tua organizzazione Developer Edition con le credenziali di accesso.
   
5. Fai clic su Allow (Consenti), per permettere a Salesforce CLI di accedere alla tua organizzazione.
   Assicurati che venga visualizzato il messaggio di Authentication Successful (Autenticazione riuscita) e
   
6. chiudi la finestra del browser.
   

La tua organizzazione Developer Edition ora è autorizzata e impostata come organizzazione predefinita.

Eseguire uno script per creare e distribuire gli artefatti dell’organizzazione richiesti

Il repository di esempio che hai clonato contiene i file sorgente associati agli artefatti che implementano il nuovo Local Info Agent (Agente info locali), ad esempio: classi Apex, un modello di prompt e un flusso. La descrizione di questi artefatti esula dall’ambito di questo modulo. Tuttavia, gli artefatti sono necessari nell’organizzazione Developer Edition per proseguire con questo badge. Quindi, nel repository che hai appena clonato, forniamo uno script

che puoi eseguire per distribuire i file sorgente, assegnare le autorizzazioni e creare un utente agente. Gli agenti Agentforce vengono eseguiti utilizzando un utente dedicato con il profilo Einstein Agent User (Utente agente Einstein). Questo utente rappresenta l’identità di runtime dell’agente.

1. Nel terminale integrato di VS Code, esegui lo script di configurazione.
   ./setup(macOS o Linux)
   setup.cmd (Windows)
   
2. Lo script visualizza i passaggi in fase di esecuzione, aggiungendo un segno di spunta verde quando un passaggio viene completato correttamente.
   Importante: salva il nome utente univoco creato dallo script: ti servirà nella prossima unità.
   
   

Visualizzare i comandi dell’agente

Dai uno sguardo ai comandi agent prima di iniziare a utilizzarne alcuni. La maggior parte di questi comandi CLI hanno equivalenti accessibili dal riquadro dei comandi di VS Code, che utilizzerai a loro volta. Visualizzare tutti i comandi CLI è utile per farsi un’idea generale delle funzionalità di Agentforce DX.

1. Nel terminale integrato di VS Code, esegui il comando CLI sf search per visualizzare tutti i comandi agent disponibili. Man mano che scorri l’elenco dei comandi con i tasti freccia, in fondo alla pagina viene visualizzato un riepilogo del comando evidenziato.
   
   Per informazioni tecniche sul plugin Salesforce CLI che contiene i comandi agent, esegui il comando seguente:
   sf plugins inspect agent
2. Per visualizzare informazioni dettagliate su un determinato comando, come i flag disponibili e gli esempi per utilizzarlo, esegui quel comando con il flag --help. Per informazioni sintetiche, usa -h.
   sf agent validate authoring-bundle --help

Questo badge Trailhead mette in evidenza i comandi CLI agent validate authoring-bundle e agent publish authoring-bundle o i loro equivalenti di VS Code.

Ora che sai che cos’è Agentforce DX e hai preparato l’ambiente di sviluppo, è il momento di passare all’azione e sviluppare un agente.

Risorse

• Salesforce Developers: Build Agents with Agentforce DX (Creazione di agenti con Agentforce DX)
• Salesforce Developers: Salesforce CLI Command Reference, agent Commands (Guida di riferimento per i comandi CLI, comandi agent)
• Salesforce Developers: Estensione Agentforce Vibes
• Salesforce Developers: How Salesforce Developer Experience (DX) Tooling Changes the Way You Work (Come cambia il modo di lavorare con gli strumenti di Salesforce Developer Experience (DX))
• Salesforce Developers: Salesforce Extensions for Visual Studio Code (Guida per gli sviluppatori: Estensioni Salesforce per Visual Studio Code)
• Salesforce Developers: Salesforce CLI Setup Guide, Quick Start (Guida alla configurazione di Salesforce CLI, Avvio rapido)
• Guida di Salesforce: Progettazione e implementazione degli agenti
• Trailhead: Introduzione al nuovo Generatore Agentforce