Creazione di un'azione agente personalizzata in Legacy Builder
Con le azioni personalizzate, è possibile estendere le funzionalità di Salesforce all'agente in modo che sia pronto ad assistere gli utenti nelle operazioni specifiche della propria azienda. Creare azioni personalizzate utilizzando Apex, flussi, modelli di prompt e integrazioni API.
Versioni (Edition) richieste
| Disponibile in: Lightning Experience |
| Disponibile in: Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition. Le licenze aggiuntive richieste variano a seconda del tipo di agente. |
| Autorizzazioni utente richieste | |
|---|---|
| Per creare un'azione agente personalizzata: | Gestisci agenti AI E le autorizzazioni richieste |
| Per creare o modificare i modelli di prompt: | Gestore modelli di prompt |
| Per creare o modificare i flussi: | Gestisci flusso |
Prima di iniziare:
- Rivedere le considerazioni sulle azioni personalizzate.
- creare la funzionalità Salesforce sottostante che si desidera utilizzare con l'agente. Quando si crea un'azione personalizzata, si configura la funzionalità da utilizzare con l'agente. È possibile creare un'azione personalizzata che chiama metodi invocabili e classi Apex REST, servizi esterni, flussi AutoLaunched, API MuleSoft o modelli di prompt.
L'accesso a un'azione agente personalizzata dipende dal tipo di funzionalità Salesforce a cui fa riferimento. Ad esempio, se un'azione personalizzata viene creata utilizzando un flusso, l'azione personalizzata rispetta le autorizzazioni, la protezione a livello di campo e le impostazioni di condivisione configurate nel flusso. Per eseguire l'azione, l'utente o l'Utente agente deve disporre dell'autorizzazione Esegui flussi e dell'accesso al flusso specifico, a seconda del tipo di agente.
- Da Imposta, nella casella Ricerca veloce, immettere Agente e quindi selezionare Asset Agentforce per visualizzare tutte le azioni nell'organizzazione Salesforce.
- Fare clic su Azione Nuovo agente.
- Dall'elenco a discesa Tipo di azione di riferimento, selezionare il tipo di funzionalità che si desidera utilizzare per creare l'azione dell'agente, ad esempio un flusso o un modello di prompt. Quindi selezionare la categoria, se richiesto, e l'azione di riferimento.
- L'etichetta dell'azione agente e il nome API sono compilati con il nome dell'azione di riferimento e il nome API. Esaminare questi campi e, se necessario, modificare i valori per descrivere in modo preciso l'azione. Quindi fare clic su Avanti.
-
Le istruzioni per l'azione personalizzata e ogni input e output vengono compilati con le descrizioni dell'azione di riferimento. Esaminare questi campi e apportare modifiche. Vedere Procedure consigliate per le istruzioni di azione degli agenti.
Le descrizioni dell'azione di riferimento vengono copiate per offrire un vantaggio, ma le istruzioni dell'azione agente sono diverse dalle descrizioni tradizionali. Un agente utilizza un modello di linguaggio di grandi dimensioni (LLM) e il motore di ragionamento per determinare quando avviare subagenti e azioni in una conversazione. Le istruzioni per l'azione, gli input e gli output indicano a un agente che cosa fa l'azione e quando e come utilizzarla. Le istruzioni efficaci variano a seconda dell'azione e del caso d'uso. Pianificare il test e l'iterazione secondo le istruzioni per assicurarsi che l'azione funzioni come previsto.
-
Per ogni input e output, specificare le impostazioni applicabili.
Impostazione Dettagli Raccogliere dati dall'utente Richiedere che questo parametro venga fornito dall'utente. Filtra dall'azione agente Quando si crea un'azione agente, tutti gli input e gli output dell'azione di riferimento vengono aggiunti all'azione agente. Abilitare questa impostazione quando non si desidera utilizzare un parametro dell'azione di riferimento con l'azione agente. Almeno un output deve essere utilizzato con l'azione agente. Richiedi input Richiedere questo parametro per eseguire l'azione. Tutti gli altri input sono considerati facoltativi. Se l'azione di riferimento richiede un input, questa impostazione è abilitata per impostazione predefinita e di sola lettura. Mostra nella conversazione Quando questa impostazione è abilitata per alcuni o tutti gli output, gli output in cui è abilitata vengono inclusi nella risposta dell'agente. In alcuni canali, alcuni output vengono convertiti in contenuti strutturati (ad esempio, il riquadro Agentforce in Lightning Experience riconosce le pagine dei record).
Quando questa impostazione è disabilitata per tutti gli output, l'agente utilizza il componente LLM per riepilogare gli output in linguaggio naturale nella risposta dell'agente.
Mostra testo di caricamento per questa azione Mostra il testo di caricamento nella conversazione dell'agente mentre l'azione è in esecuzione in background.
Per un'azione personalizzata, è possibile specificare il testo di caricamento per l'azione nel campo Testo di caricamento. Con 1–3 parole senza punteggiatura, indicare agli utenti l'azione che stanno eseguendo. Ad esempio, "Creare l'email", "Eseguire aggiornamenti" o "Ottenere i dettagli dell'attività".
Quando questa impostazione è disabilitata o è abilitata ma non viene specificato alcun testo di caricamento, viene visualizzato il testo di caricamento predefinito. Ad esempio, "Lavoro", "Fare progressi" o "Controllare le mie note".
Per visualizzare il testo di caricamento nelle conversazioni del canale di messaggistica ottimizzato, è necessaria una configurazione aggiuntiva per Chat ottimizzata e Porta il tuo canale.
Suggerimento Quando un'azione apporta una modifica a un record, è possibile richiedere a un agente di chiedere all'utente di confermare la modifica prima che l'agente possa eseguirla. Nella pagina del record dell'azione, abilitare l'impostazione Richiedi conferma utente. - Fare clic su Fine.
Dopo aver creato l'azione, assegnarla a un sottoagente per aggiungerla all'agente.
Per testare l'azione e visualizzare in anteprima l'output in una conversazione dell'agente, aprire l'agente in Agentforce Builder e avviare una conversazione di anteprima. Immettere le enunciazioni che si prevede attiveranno il subagente e l'azione e quindi modificare l'azione e le istruzioni del subagente in base ai risultati. L'azione deve essere assegnata a un agente per testarla. Ogni agente che utilizza l'azione personalizzata ha la propria copia indipendente dell'azione. È possibile aggiornare l'azione personalizzata per un agente specifico e gli aggiornamenti non verranno condivisi con altri agenti.
- Procedure consigliate per le istruzioni di azione degli agenti
Le istruzioni per l'azione indicano a un agente che cosa fa l'azione e quando utilizzarla. Quando si crea un'azione personalizzata, pianificare e testare attentamente le istruzioni per assicurarsi che l'azione funzioni come previsto. - Ottimizzazione dell'interfaccia utente delle azioni degli agenti con tipi Lightning personalizzati
Personalizzare l'interfaccia utente (UI) per l'input e l'output di un'azione agente utilizzando tipi Lightning personalizzati.
