Dépannage des erreurs de mise à niveau des agents

Des erreurs de bibliothèque de données non valides peuvent se produire, car le format requis pour les ID de bibliothèque de données varie entre le générateur hérité et Agentforce Builder.

Si vous recevez une erreur indiquant que votre knowledge.rag_feature_config_id n'est pas valide, ajoutez manuellement la bibliothèque de données à la version mise à niveau de votre agent depuis l'Explorateur dans Agentforce Builder.

Dans Agent Script, le champ source est le nom d'API d'une action de l'agent. Lorsqu'il est inclus dans une action d'agent, il fonctionne avec le champ cible pour indiquer à l'agent l'action à exécuter et l'action de référence (la fonctionnalité sous-jacente, par exemple une classe Apex, un flux ou un modèle d'invite) à appeler. Des erreurs sources non valides peuvent se produire en raison d'incohérences dans les métadonnées ou parce que le générateur hérité a ajouté un suffixe ID aux sources d'action de l'agent dont Agentforce Builder n'a pas besoin.

Si vous obtenez une erreur indiquant qu'Agentforce ne trouve pas de source pour une action de l'agent, dans la vue Script:

• Supprimez le suffixe ID alphanumérique de la source. Par exemple, My_Action_1792ce20299b41c devient My_Action.
• Pour des actions d'agent personnalisées, vous pouvez également supprimer entièrement le champ source de l'action, sauf si l'action provient d'un package géré. Généralement, les actions d'agent personnalisées peuvent utiliser uniquement le champ cible. Les actions d'un package géré peuvent nécessiter un espace de noms dans le champ source.

Si l'action est disponible dans la bibliothèque d'actifs, vous pouvez la retirer de votre agent, puis la rajouter. Alternativement, s'il s'agit d'une action personnalisée spécifique à votre agent, vous pouvez la retirer et la recréer en fonction de la même action de référence.

Les variables de contexte (également appelées variables liées) sont mappées avec un champ d'objet, qui est identifié en tant que source de la variable dans Agentforce Builder et Agent Script. Par exemple, la source de la variable RoutableId est le champ ID de l'objet Session de messagerie. Lorsque vous mettez à niveau un agent qui contient des variables de contexte, le champ source peut être manquant dans le script Agent.

Si vous recevez une erreur indiquant que le champ source d'une variable n'est pas valide ou est manquant lorsque vous enregistrez ou validez votre agent mis à niveau, ajoutez manuellement la source dans la vue Script. Si vous n'utilisez pas les variables, vous pouvez les supprimer en toute sécurité. Le tableau ci-dessous répertorie les variables de contexte courantes et leurs sources.