Crea elemento agente
Utilizzare un agente Agentforce per gestire le operazioni in modo dinamico nel flusso. Selezionare un agente esistente o creare un agente con istruzioni e azioni personalizzate.
Versioni (Edition) richieste
Autorizzazioni
Per utilizzare gli agenti esistenti nei flussi, è necessaria l'autorizzazione utente Visualizza impostazione. Per creare agenti da Flow Builder, è necessario disporre dell'autorizzazione utente Personalizza applicazione, Einstein Copilot Builder, Einstein Agent Platform Builder o Self-Service Copilot Builder. Gli utenti con il profilo Amministratore di sistema possono sia creare che utilizzare gli agenti.
Se non si dispone delle autorizzazioni per creare agenti, il pulsante Crea agente non viene visualizzato nel riquadro di selezione degli agenti. È possibile selezionare solo gli agenti esistenti.
Utilizzo
Aggiungere un elemento Crea agente al flusso. Nel campo Agente, cercare e selezionare un agente attivo oppure fare clic su Crea agente per crearne uno nuovo.
Selezione di un agente esistente
Per utilizzare un agente esistente, cercarlo per nome nel campo Agente. Nell'elenco vengono visualizzati solo gli agenti attivi. Dopo aver selezionato un agente, configurare gli input e gli output dell'agente nel riquadro delle proprietà.
Creazione di un nuovo agente
Per creare un agente, fare clic su Crea agente. Nella finestra Nuovo agente, configurare le informazioni di base dell'agente.
| Campo | Descrizione |
|---|---|
| Etichetta | Il nome dell'agente. |
| Nome API | Il requisito di univocità si applica solo agli elementi all'interno del flusso corrente. Due elementi possono avere lo stesso nome API, a condizione che vengano utilizzati in flussi diversi.Un nome API può contenere caratteri di sottolineatura e alfanumerici senza spazi. Deve iniziare con una lettera e non può terminare con un carattere di sottolineatura. Inoltre, non può contenere due caratteri di sottolineatura consecutivi. |
| Descrizione | Descrizione delle operazioni eseguite dall'agente. |
| Accesso degli utenti | Record utente come viene eseguito dall'agente. Selezionare un utente esistente o fare in modo che il sistema crei un utente. |
| Istruzioni | Istruzioni che descrivono le operazioni dell'agente e ne guidano il ragionamento. |
| Azioni | Le azioni che l'agente può utilizzare. Selezionare le azioni esistenti dalla libreria di asset o creare azioni personalizzate. |
Aggiunta di azioni all'agente
L'agente richiede almeno un'azione per eseguire le operazioni. Aggiungere azioni prima di fare clic su Crea e attiva o in Agentforce Builder dopo aver attivato l'agente.
Per selezionare le azioni esistenti, fare clic su Seleziona azioni. Cercare e selezionare una o più azioni dalla libreria di asset, quindi fare clic su Aggiungi all'agente. Le azioni disponibili includono azioni Knowledge, flussi configurati come azioni invocabili e azioni standard.
Per creare un'azione, fare clic su Crea azione. Nella finestra Crea azione, configurare l'azione.
| Campo | Descrizione |
|---|---|
| Etichetta strumento agente | Nome dell'azione. |
| Nome API | Il requisito di univocità si applica solo agli elementi all'interno del flusso corrente. Due elementi possono avere lo stesso nome API, a condizione che vengano utilizzati in flussi diversi.Un nome API può contenere caratteri di sottolineatura e alfanumerici senza spazi. Deve iniziare con una lettera e non può terminare con un carattere di sottolineatura. Inoltre, non può contenere due caratteri di sottolineatura consecutivi. |
| Descrizione | Nome dell'azione. L'agente utilizza queste informazioni per determinare come e quando utilizzare questa azione. |
| Tipo di azione di riferimento | Il tipo di azione, ad esempio Flusso o Apex. |
| Categoria di azione riferimento | Sottotipo del tipo di azione di riferimento. Non tutte le azioni hanno una categoria di azione di riferimento. |
| Azione di riferimento | Nome dell'azione a cui fare riferimento. |
Per ogni input, aggiungere una descrizione delle operazioni eseguite dall'input. L'agente utilizza la descrizione per determinare come utilizzare l'input quando chiama l'azione. Selezionare Richiedi input per rendere obbligatorio l'input.
Per ogni output, aggiungere una descrizione dei risultati dell'output e di come utilizzare il risultato nel flusso. Selezionare Filtra dal contesto per escludere l'output dal ragionamento dell'agente. Selezionare Mostra nella conversazione per includere questo output nella risposta dell'agente.
Fare clic su Crea e attiva per creare e attivare l'agente.
Configurazione dell'elemento
Dopo aver selezionato o creato un agente, configurare l'elemento Crea agente nel riquadro delle proprietà.
| Campo | Descrizione |
|---|---|
| Etichetta | Etichetta dell'azione nell'area di disegno e nel Gestore caselle degli strumenti. |
| Nome API | Il requisito di univocità si applica solo agli elementi all'interno del flusso corrente. Due elementi possono avere lo stesso nome API, a condizione che vengano utilizzati in flussi diversi.Un nome API può contenere caratteri di sottolineatura e alfanumerici senza spazi. Deve iniziare con una lettera e non può terminare con un carattere di sottolineatura. Inoltre, non può contenere due caratteri di sottolineatura consecutivi. |
| Descrizione | Descrizione dell'elemento. |
Impostazione dei valori di input
Configurare gli input dell'elemento Crea agente nel riquadro delle proprietà.
| Campo | Descrizione |
|---|---|
| Richiesta agente | Domanda o richiesta da inviare all'agente per l'esecuzione di questo flusso. L'agente applica le istruzioni a questa richiesta specifica per generare output. |
| ID sessione | Facoltativo. Utilizzare l'ID sessione restituito da un elemento Crea agente eseguito in precedenza nel flusso. L'agente mantiene il contesto di ragionamento completo e la memoria di quella conversazione. Se non si specifica un ID sessione, l'agente avvia una nuova conversazione, ma è sempre possibile specificare gli output degli elementi Crea agente precedenti come input. |
Configurazione dell'output strutturato
Per configurare l'agente in modo che restituisca dati strutturati che il flusso può utilizzare, definire campi di output strutturati. Ogni campo rappresenta un'informazione che l'agente estrae o genera.
Se si configura l'output strutturato, l'agente restituisce solo i dati strutturati nel campo Risposta agente strutturata. Il campo Risposta agente restituisce null. Se non si configura l'output strutturato, l'agente restituisce solo testo non strutturato nel campo Risposta agente.
Per configurare l'output strutturato, fare clic su Configura. Configurare i campi per ogni campo di output strutturato:
| campo | Descrizione |
|---|---|
| Nome campo | Obbligatorio. Nome alfanumerico univoco del campo di output strutturato. Il nome non può contenere caratteri speciali o spazi. |
| Descrizione | Breve descrizione utilizzata con il nome del campo per aumentare la precisione del modello LLM (large language model). |
| Tipo di dati | Obbligatorio. Tipo di dati del campo. Valori validi: Stringa, Numero, Booleano. |
| Obbligatorio | Indica che il componente LLM deve generare una risposta per questo campo di output. La richiesta di righe di output può causare risposte imprecise o dannose da parte di LLM. |
Memorizzazione dei valori di output
| Campo | Descrizione |
|---|---|
| Risposta agente | La risposta non strutturata dell'agente. Restituisce nullo se è configurato l'output strutturato. |
| ID sessione | ID della sessione di conversazione in cui si trova la risposta dell'agente. |
| Risposta agente strutturata | Output strutturato dell'agente. Restituisce nullo se non è configurato alcun output strutturato. |
Utilizzo di output strutturati
Prima di configurare l'output strutturato, immettere un'etichetta e un nome API per l'elemento Crea agente e salvare il flusso.
Quando si configura l'output strutturato, definire almeno 1 campo di output strutturato prima di salvare.
Per ogni campo di output strutturato definito vengono creati due campi: uno con il nome definito e un campo _set booleano correlato. Ad esempio, se è stato definito un campo di output strutturato denominato summary, viene creato anche un campo booleano denominato summary_set.
| Campo | Descrizione |
|---|---|
| Vero | Il campo è stato incluso nella risposta strutturata dell'agente, ma non aveva un valore impostato. |
| Falso | Il campo non è stato incluso nella risposta strutturata dell'agente. |
Quando un output strutturato definito restituisce null, utilizzare il campo _set correlato più avanti nel flusso per determinare perché il campo è null.
Note sull'utilizzo
- Testare il flusso prima di attivarlo per assicurarsi che l'elemento Crea agente funzioni come previsto.
- È possibile trovare e modificare gli agenti creati in Flow Builder in Agentforce Builder in qualsiasi momento.
- A partire dalla versione 67.0 dell'API, le azioni dell'agente AI non sono più disponibili dall'elemento Azione. Utilizzare l'elemento Crea agente per lavorare con gli agenti. Quando si apre un flusso con un elemento Azione che fa riferimento a un'azione Agente AI, viene visualizzato automaticamente come elemento Crea agente. La configurazione originale viene mantenuta.
