Vous êtes ici :
Considérations relatives à l'empaquetage pour les modèles d'invite
Insérez un modèle d'invite dans des packages gérés, non gérés ou déverrouillés. Avant de créer, de mettre à jour ou de déployer un package qui contient un modèle d'invite, comprenez les limitations et les comportements des packages.
Éditions requises
| Disponible avec : Lightning Experience |
| Disponible avec : éditions Enterprise, Performance et Unlimited avec le complément Einstein pour Platform, ou Einstein ou Agentforce pour la vente ou Service, ou Agentforce Foundations |
Créer des packages
- Les modèles d'invite qui contiennent un flux avec une entrée d'objet personnalisé peuvent entraîner l'échec de l'installation du package, car l'empaquetage des flux d'invite avec des objets personnalisés n'est pas encore pris en charge.
- Incluez uniquement les versions publiées. Des versions brouillons peuvent être ajoutées au package, mais elles ne sont pas installées dans les organisations clientes pour des packages gérés.
- Toute modification future d'une version publiée est ignorée sans erreur pendant la mise à niveau.
- Si une version publiée est active et différente de la version actuelle, elle est automatiquement activée dans l'organisation du client.
- Si aucune version n'est publiée, n'empaquetez pas le modèle. Si vous empaquetez un modèle sans version publiée, toute installation ou mise à niveau échoue en raison d'un modèle vide.
- Les modèles d'invite avec des modèles personnalisés ne peuvent pas être empaquetés.
- Si vous incluez une classe Apex dans un modèle d'invite et que vous l'empaquetez, la classe doit être globale.
- Pour des packages non gérés, déverrouillés ou gérés, ignorez l'empaquetage si un modèle remplace un modèle prêt à l'emploi. Actuellement, les modèles remplaçables ne peuvent pas être empaquetés.
- Les récupérateurs tels que Recherche de données et Graphiques de données ne sont pas inclus dans les packages. À la place, ils font partie d'un kit de données dans Data 360. Les éditeurs de logiciels indépendants (ISV) Salesforce sont invités à fournir des récupérateurs au client, sinon l'installation échoue en raison de métadonnées manquantes.
- De nouvelles versions peuvent être ajoutées à un modèle existant, mais les anciennes versions ne peuvent pas être modifiées ni supprimées.
- Les nouvelles versions peuvent être activées et les anciennes versions peuvent être désactivées.
- Les clients ne peuvent pas modifier les modèles empaquetés, mais ils peuvent être clonés dans de nouveaux modèles si les clients souhaitent les modifier.
- Un modèle sans version active peut être livré, mais les clients ne peuvent pas l'utiliser, car le modèle n'est pas actif. Les clients peuvent cloner le modèle pour créer leur propre modèle personnalisé et le modifier pour leurs propres cas d'utilisation.
- L'autorisation ManagePromptTemplates doit être attribuée lors de la création de versions de package de deuxième génération (2GP). Cet extrait de code peut être utilisé
sfdx-project.jsonspécifier l'autorisation à attribuer à l'utilisateur de l'élaboration lors de la création de l'organisation et de l'élaboration du package.{ "packageDirectories": [{ "versionName": "ver 0.2", "versionNumber": "0.2.0.NEXT", "path": "force-app", "default": true, "package": "Prompt Template 2GP Pkg", "versionDescription": "", "definitionFile": "config/project-scratch-def.json", "packageMetadataAccess": { "permissionSets": [ "EinsteinGPTPromptTemplateManager" ] } }], "name": "managed", "namespace": "NAMESPACE", "sfdcLoginUrl": "https://login.salesforce.com", "sourceApiVersion": "63.0" }
Installation et mise à niveau des modèles d'invite installés
- Dans la Configuration Einstein, si l'option Ajouter ou exiger des entrées après l'activation n'est pas activée et que vous changez les entrées entre les versions du modèle, l'installation du package échoue avec l'erreur suivante : 'Cette application ne peut pas être mise à niveau.'
- Avant d'installer ou de mettre à niveau un package en production, testez l'installation ou la mise à niveau en sandbox et testez.
- Les clients ne peuvent pas désactiver une version après l'installation ou la mise à niveau.
- Vous ne pouvez pas remplacer une version de modèle d'invite publiée.
- Si le modèle de modèle d'invite est masqué, le modèle existant fonctionne normalement. Cependant, si le modèle est cloné, il ne peut pas être utilisé.
- Pour les versions actives, activez-les automatiquement dans l'organisation cliente. Testez toujours les modifications dans les organisations sandbox avant d'installer ou de mettre à niveau un package.
- L'IA générative Einstein doit être activée pour l'installation de packages avec des modèles d'invite sinon l'installation échoue.
- Les flux ne sont pas automatiquement activés lorsqu'un package est installé. Les flux suivent le processus d'activation standard des packages gérés qui est établi.
- Les partenaires peuvent désactiver un modèle. Cependant, si ce modèle est utilisé pour le client, la mise à niveau échoue. Pour mettre à niveau le package, les clients doivent retirer ce modèle de son utilisation.
- Si vous empaquetez un modèle avec une configuration de modèle LLM personnalisé, vérifiez que votre organisation cliente a un modèle portant le même nom, sinon l'installation ou la mise à niveau échoue.
- Les champs personnalisés des pages Lightning activées pour les formulaires dynamiques peuvent référencer des modèles d'invite. Si vous installez un package géré contenant un modèle d'invite qui est référencé par un champ personnalisé dans une page Lightning activée pour les Formulaires dynamiques, et que ce modèle d'invite référence un champ personnalisé avec un espace de noms différent de celui de la page Lightning, l'installation du package peut échouer.
Suppression des modèles d'invite installés
- Les versions ne peuvent pas être supprimées d'un modèle géré.
- Un modèle géré peut être supprimé d'un package 2GP, mais il n'est pas supprimé dans l'organisation du client. Les clients affichent les modèles dépréciés et peuvent les supprimer.
Voir également :
Cet article a-t-il résolu votre problème ?
Dites-nous ce que nous pouvons améliorer !
