Dépannage Générateur de répliques

Mon aperçu ou test échoue avec une erreur.

Si vous cliquez sur Aperçu et qu'une erreur s'affiche, par exemple Internal Server Error, vérifiez les éléments ci-dessous avant de contacter le Support client de Salesforce.

• Vérifiez que le Générateur de répliques est inclus avec votre édition Salesforce et vos compléments. Les éditions prises en charge sont affichées en haut de cette page.
• Confirmez qu'Einstein est activé. dans Configuration, saisissez Configuration Einstein dans la case Recherche rapide, puis sélectionnez Configuration Einstein. En savoir plus sur l'activation du Générateur de répliques.
• Vérifiez que l'ensemble d'autorisations Gestionnaire de modèle d'invite ou Utilisateur de modèle d'invite vous a été attribué, et que l'ensemble d'autorisations inclut Exécuter des modèles d'invite. En savoir plus sur l'activation du Générateur de répliques.
• Si vous avez vérifié Einstein, les licences et les autorisations et que l'erreur persiste, attendez quelques minutes et réessayez. Le problème est souvent une interruption temporaire du service. Vérifiez Salesforce Trust avant de créer une requête de support.

Mon modèle d'invite fonctionne dans Aperçu, mais échoue lorsqu'il est utilisé par un agent.

Un modèle d'invite peut générer une réponse dans Générateur de répliques et échouer lorsque le même modèle est appelé depuis Agentforce Builder ou exécuté dans une conversation d'agent. L'agent peut transmettre des valeurs d'entrée différentes de celles que vous avez sélectionnées dans Aperçu.

• Si le modèle utilise un récupérateur, vérifiez que la source de données du récupérateur est active et que le récupérateur renvoie lui-même les résultats. En savoir plus sur les récupérateurs individuels.
• Si vous ancrez le modèle avec une Bibliothèque de données Agentforce ou des fichiers non structurés, vérifiez que l'indexation est terminée. En savoir plus sur le dépannage de la bibliothèque de données Agentforce.
• Prévisualisez de nouveau le modèle avec les mêmes valeurs d'entrée que l'agent transmet à l'exécution. En savoir plus sur la prévisualisation d'une réponse générée.

Ma réponse structurée contient des champs manquants ou vides lorsque la Couche de Trust Einstein est activée.

Lorsque la couche Trust Einstein est activée et que vous utilisez les sorties structurées pour générer une réponse JSON, certains champs peuvent revenir vides ou null. La couche Trust Einstein masque les informations personnelles, telles que les noms ou les adresses e-mail, avant d'envoyer l'invite au modèle IA. Si un champ n'est pas restauré après le retour de la réponse, il peut être vide.

Dans la section Réponse, ouvrez Détails du masquage et notez les champs masqués et s'ils contiennent des informations d'identification personnelle. Les renseignements personnels masqués sont la cause la plus fréquente. En savoir plus sur les sorties structurées. Pour examiner les paramètres de masquage, voir Einstein Trust Layer Settings (Paramètres de la couche de confiance Einstein).

Mon modèle d'invite n'utilise pas l'accès aux données de l'utilisateur actif.

Si un modèle renvoie des données qu'un utilisateur ne devrait pas afficher ou omet des données qu'il devrait afficher, ajoutez une action Apex ou de flux qui filtre les enregistrements avant que ces données soient ancrées dans le modèle d'invite. En savoir plus sur l'ajout d'une action.

Mon fichier est trop volumineux pour être ancré.

Les fichiers utilisés pour l'ancrage sont limités à 15 Mo par requête et la plupart des modèles prennent en charge au moins un type de fichier. Si votre fichier dépasse la limite, divisez-le en petits fichiers ou résumez le contenu avant de le charger en tant que source d'ancrage. Les fichiers non pris en charge sont exclus de la demande et répertoriés dans le panneau Résolution. En savoir plus sur les limites du Générateur de répliques. En savoir plus sur l'ancrage avec des entrées de fichier.

Le champ Objet est manquant.

L'affichage du champ Objet dépend du type de modèle d'invite.

• Pour un modèle de génération de champ, sélectionnez un Objet et un Champ d'objet en créant le modèle, avant d'ouvrir l'espace de travail. En savoir plus sur la création d'un modèle d'invite Génération de champ.
• Pour un modèle Flex, les ressources d'objet sont facultatives. Ajoutez-les ultérieurement depuis l'onglet Ressources. Le champ Objet n'est pas affiché à l'écran de configuration initial. En savoir plus sur la création d'un modèle d'invite Flex.

Si vous vous attendiez à afficher immédiatement l'objet et que vous ne le voyez pas, vérifiez le type de modèle que vous créez.

Je reçois des résultats incohérents du même modèle d'invite.

Les modèles d'invite utilisent un grand modèle de langage (LLM). Les modèles IA ne renvoient pas toujours la même réponse pour les mêmes entrées. Par conséquent, les résultats peuvent varier d'une exécution à l'autre. Les modèles qui utilisent des retrievers pour des tâches de style classification peuvent également ne pas analyser une réponse en tant que JSON valide.

• Prévisualisez plusieurs fois les mêmes entrées pour déterminer si le problème est intermittent. En savoir plus sur la prévisualisation d'une réponse générée.
• Définissez des instructions spécifiques et ajoutez un traitement explicite pour les valeurs vides ou inattendues. En savoir plus sur l'affinage d'un modèle d'invite.
• Ne répétez pas plusieurs fois le même champ de fusion. Les champs de fusion répétés peuvent entraîner des résultats incohérents. En savoir plus sur l'organisation des invites complexes.
• Si les échecs sont fréquents, par exemple environ une exécution sur deux, créez une requête de support et incluez des exemples d'entrée.

Je reçois une erreur en résolvant les fournisseurs de données.

Si une erreur telle que Error occurred while resolving data providers; cannot describe data provider est affichée, une action sous l'onglet Ressources est manquante, mal configurée ou non disponible. Dans Générateur de répliques, ces ressources sont appelées actions. Ils comprennent des actions de flux, Apex et retriever.

• Ouvrez l'onglet Ressources et vérifiez chaque action. Vérifiez que le flux référencé, la classe Apex ou le retriever existe toujours et que vous y avez accès. En savoir plus sur l'ajout d'une action.
• Si vous avez récemment renommé, supprimé ou désactivé un flux ou une classe, mettez à jour ou remplacez l'action dans le modèle d'invite, puis enregistrez et prévisualisez de nouveau.

Je ne peux pas supprimer une entrée.

Vous ne pouvez pas supprimer une entrée qui est toujours référencée par une action. Sous l'onglet Ressources, retirez ou mettez à jour l'action de flux, Apex ou retriever qui utilise l'entrée. Supprimez ensuite l'entrée. En savoir plus sur l'ajout d'une entrée.

Mes ressources ou flux sont manquants après l'enregistrement et l'activation.

Après avoir enregistré et activé, vérifiez que vous visualisez la version qui contient vos ressources. L'activation d'une version de modèle rend cette version immuable. Par conséquent, elle ne peut pas être modifiée.

• Actualisez la page, puis utilisez la liste déroulante des versions en haut de l'espace de travail Modèle d'invite pour ouvrir la version que vous venez d'activer. En savoir plus sur l'utilisation de plusieurs versions.
• Vérifiez que les ressources ont été enregistrées dans la version désormais active. Si vous avez ajouté un flux ou une action Apex après l'activation, enregistrez le travail sous une nouvelle version et activez cette version. En savoir plus sur l'activation et la désactivation des modèles d'invite.

L'enregistrement de mon modèle d'invite échoue.

La validation du délai d'enregistrement échoue lorsqu'un champ de fusion, une action ou une entrée obligatoire n'est pas valide.

• Vérifiez la syntaxe des champs de fusion. Par exemple, utilisez {!$Input:Account.Id} plutôt que la {!$account.Id} syntaxique Winter ’24. En savoir plus sur la syntaxe des champs de fusion de ressources.
• Vérifiez que chaque entrée requise a une valeur et que chaque action dans Ressources reste résolue. En savoir plus sur l'ajout d'une entrée.
• Si le modèle utilise un flux ou une classe Apex du Générateur de répliques, recréez ces ressources pour la syntaxe actuelle. En savoir plus sur les changements de flux après le pilote. En savoir plus sur les changements de classe Apex après le pilote.

Ma réponse est masquée, marquée pour un contenu préjudiciable ou coupée.

Einstein Trust Layer analyse les réponses des modèles d'invite pour détecter tout langage toxique. Lorsqu'un langage toxique est détecté, le badge de contenu nocif est affiché dans la section Réponse avec un nombre d'avertissements. Révisez le modèle d'invite et prévisualisez de nouveau jusqu'à ce que le nombre d'avertissements revienne à 0. En savoir plus sur les notifications de contenu nocif.

Si la réponse est coupée, l'invite résolue peut dépasser ce que le modèle IA accepte. Lorsqu'une invite est trop volumineuse, le Générateur de répliques peut générer un résumé dans le panneau Résolution. Utilisez l'invite résumée ou raccourcissez le modèle. En savoir plus sur l'utilisation d'invites volumineuses.

Des valeurs masquées dans la réponse sont attendues lorsque la Couche de Trust Einstein remplace les données confidentielles par des espaces réservés, puis les restaure. Ouvrez Détails de masquage dans la section Réponse pour inspecter le mappage. En savoir plus sur Data Trust et le masquage.

Je dois documenter et déboguer mes modèles d'invite.

Le Générateur de répliques ne prend pas en charge les commentaires en ligne dans le corps du modèle. Utilisez des versions pour comparer les modifications et consignez brièvement les modifications apportées à chaque version.

• Cliquez sur Enregistrer sous | Enregistrer sous une nouvelle version avant une modification importante pour comparer les réponses côte à côte. En savoir plus sur l'utilisation de plusieurs versions.
• Prévisualisez chaque fois avec le même enregistrement de test, puis notez l'instruction ou la ressource que vous avez modifiée.
• Pour une logique complexe, testez le texte de l'instruction dans Aperçu, puis ajoutez des ressources et prévisualisez de nouveau. En savoir plus sur l'organisation des invites complexes.