Risoluzione degli errori di aggiornamento degli agenti
Quando si aggiorna un agente esistente, Agentforce esegue automaticamente la maggior parte del lavoro. Tuttavia, le differenze di metadati e sintassi tra i Generatori Agentforce nuovi e legacy possono comunque causare errori di convalida quando si salva o si conferma l'agente aggiornato. Ulteriori informazioni sui problemi comuni e su come risolverli.
Versioni (Edition) richieste
| Disponibile nelle versioni: Lightning Experience |
| Disponibile in: Edizioni Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition with Foundations o Agenteforce 1 o Einstein 1 Edition |
- Libreria di dati non valida
Possono verificarsi errori della libreria di dati non validi perché il formato richiesto per gli ID libreria di dati varia tra il generatore legacy e Agentforce Builder.
Se viene visualizzato un errore che indica che il
knowledge.rag_feature_config_idnon è valido, aggiungere manualmente la libreria di dati alla versione aggiornata dell'agente da Explorer in Agentforce Builder.- Origine non valida per un'azione agente
Nello script agente, il campo di origine è il nome API di un'azione agente. Quando è inclusa in un'azione agente, funziona insieme al campo di destinazione per indicare all'agente quale azione eseguire e quale azione di riferimento (la funzionalità sottostante, ad esempio una classe Apex, un flusso o un modello di prompt) chiamare. Possono verificarsi errori di origine non validi a causa di discrepanze nei metadati o perché il generatore legacy ha aggiunto un suffisso ID alle fonti delle azioni agente che Agentforce Builder non richiede.
Se viene visualizzato un errore che indica che Agentforce non riesce a trovare un'origine per un'azione agente, nella visualizzazione Script:
- Eliminare il suffisso ID alfanumerico dall'origine. Ad esempio,
My_Action_1792ce20299b41cdiventaMy_Action. - Per le azioni personalizzate degli agenti, è anche possibile eliminare completamente il campo di origine dall'azione, a meno che l'azione non provenga da un pacchetto gestito. Le azioni personalizzate degli agenti in genere possono utilizzare il solo campo di destinazione. Le azioni di un pacchetto gestito possono richiedere uno spazio dei nomi dal campo di origine.
Se l'azione è disponibile nella libreria di asset, è possibile rimuoverla dall'agente e quindi aggiungerla nuovamente. Oppure, se si tratta di un'azione personalizzata specifica del proprio agente, è possibile rimuoverla e ricrearla in base alla stessa azione di riferimento.
- Eliminare il suffisso ID alfanumerico dall'origine. Ad esempio,
- Campo di origine mancante per le variabili collegate
-
Le variabili di contesto (dette anche variabili collegate) vengono mappate a un campo oggetto, che viene identificato come origine della variabile in Agentforce Builder e Agent Script. Ad esempio, l'origine della variabile RoutableId è il campo ID dell'oggetto Sessione di Messaggistica. Quando si aggiorna un agente che contiene variabili di contesto, è possibile che il campo di origine non sia presente nello script agente.
Se viene visualizzato un errore che indica che il campo di origine di una variabile non è valido o manca quando si salva o si conferma l'agente aggiornato, aggiungere manualmente l'origine nella visualizzazione Script. Se non si utilizzano le variabili, è possibile eliminarle. In questa tabella sono elencate le variabili di contesto comuni e le relative fonti.
Variabile di contesto Origine VoiceCallId@VoiceCall.IdEndUserId@MessagingSession.MessagingEndUserIdChannelType@MessagingSession.ChannelTypeRoutableId@MessagingSession.IdEndUserLanguage@MessagingSession.EndUserLanguageContactId@MessagingEndUser.ContactId
