Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Vous pouvez exporter et importer des agents à l’aide de solutions, afin de pouvoir déplacer vos agents dans plusieurs environnements.
Tout d’abord, créez une solution personnalisée et ajoutez-y votre agent. Ensuite, exportez la solution avec votre agent et importez-la dans un autre environnement. Vous pouvez également mettre à niveau ou mettre à jour une solution contenant un assistant et supprimer une couche non gérée d’un assistant géré.
Pour plus d’informations sur l’Explorateur de solutions dans Copilot Studio, consultez View et gérer des solutions dans Copilot Studio.
Note
Vous ne pouvez pas exporter les commentaires au niveau de la rubrique ou au niveau du nœud lorsque vous exportez un agent.
Prérequis
- Vous devez disposer au minimum du rôle de sécurité Personnalisateur du système pour utiliser cette fonctionnalité. En savoir plus sur la configuration de la sécurité utilisateur dans un environnement.
- Vous devez être familiarisé avec les concepts de solution, comme décrit dans Concepts de solution et Créer et gérer des solutions dans Copilot Studio.
Éléments à connaître
Vous ne pouvez pas exporter les commentaires au niveau de la rubrique ou au niveau du nœud lorsque vous exportez un agent.
Note
Lorsque vous exportez et importez un agent à l’aide de solutions, tous les composants de l’agent ne sont pas inclus.
Les instructions de l’agent (commande principale) sont incluses. Toutefois, certains composants tels que des rubriques personnalisées et des sources de connaissances peuvent ne pas être inclus s’ils sont stockés en tant que ressources distinctes ou tables Dataverse, selon la façon dont ils sont créés ou liés.
La suppression d’un agent d’une solution ne supprime pas ses composants de la solution. Vous devez supprimer les composants séparément.
Avertissement
Ne supprimez pas directement les composants des agents non gérés, tels que les rubriques des agents, depuis la solution, sauf si vous supprimez également l'agent de la solution.
Vous devez uniquement apporter des modifications aux rubriques dans le cadre du processus de création standard dans l’interface utilisateur Copilot Studio. La suppression ou la modification des composants d’un agent directement depuis la solution provoque un échec lors de l'exportation et de l'importation.
Vous ne pouvez pas exporter des solutions managées. Lorsque vous créez une solution, par défaut, elle n’est pas gérée. Si vous la remplacez par une solution gérée, vous ne pouvez pas l’exporter. Vous devez créer une nouvelle solution.
Il n’est pas possible d’exporter une solution contenant un agent avec des points (
.) dans le nom de l’une de ses rubriques.
Créer une solution personnalisée et ajouter votre assistant
Pour créer une solution dans l’Explorateur de solutions Copilot Studio, suivez les étapes décrites dans Creater et gérer des solutions dans Copilot Studio.
La solution que vous avez créée s’ouvre automatiquement. Si elle n’apparaît pas, sélectionnez-la dans la liste des solutions.
Sélectionnez Ajouter un agent existant, puis sélectionnez Agent à nouveau.
Dans la liste Ajouter des agents existants , sélectionnez les agents que vous souhaitez exporter, puis sélectionnez Ajouter.
Note
Pour un chatbot classique :
Si vous utilisez les compétences, supprimez la variable d’environnement de la compétence Valeur actuelle en sélectionnant Retirer de cette solution.
La suppression d’un agent d’une solution ne supprime pas ses composants de la solution. Vous devez supprimer les composants séparément.
Ajouter des composants à un agent dans une solution personnalisée
Si vous ajoutez des composants, tels que des rubriques ou des flux, à votre agent dans Copilot Studio, vous devez également les ajouter à l’agent dans votre solution non managée avant d’exporter.
Sélectionnez la solution contenant votre assistant.
Dans le volet Objets, localisez votre agent sous Agents.
Sélectionnez les trois points (⋮), sélectionnez Avancé, puis sélectionnez Ajouter les objets requis.
Passez en revue les instructions et les exigences de la documentation Power Apps pour ajouter un composant existant à une solution.
Ajoutez des connecteurs personnalisés à votre solution
Si votre agent utilise des connecteurs personnalisés, suivez les étapes de Créer des connecteurs personnalisés dans les solutions et découvrez les limites connues.
Important
Vous devez d’abord importer des connecteurs personnalisés, puis la référence de connexion avec la solution agent.
Ajouter des flux de Power Automate
Lorsque vous utilisez des flux et des variables d’environnement, ajoutez les objets requis pour les flux et les variables d’environnement.
Sélectionnez la solution contenant votre assistant.
Dans le volet Objets , localisez vos flux de travail.
Sélectionnez les trois points (⋮), sélectionnez Avancé, puis sélectionnez Ajouter les objets requis.
Ajouter des variables d’environnement
Pour ajouter des variables d’environnement, suivez ces étapes :
Sélectionnez la solution contenant votre assistant.
Si la solution n’a pas de variables d’environnement, sélectionnez Ajouter un élément existant, sélectionnez Autres, puis sélectionnez Variable d’environnement.
Sélectionnez les variables d’environnement requises.
Sélectionnez Suivant, puis Ajouter.
Si la solution possède déjà toutes les variables d’environnement, sélectionnez les trois points (⋮), sélectionnez Avancé, puis ajoutez les objets requis pour vous assurer que la solution a toutes les dépendances.
Personnaliser les composants pour des solutions gérées
Pour rendre les composants personnalisables dans une solution managée, consultez Afficher et modifier les propriétés gérées par la table.
Assurez-vous que votre environnement permet la personnalisation avant d’importer des solutions gérées. Vérifiez que votre environnement ne bloque pas les personnalisations ou les solutions non gérées. En savoir plus dans Coups de personnalisation non gérés bloqués dans Dataverse.
Exporter la solution avec votre agent
Vous exportez et importez les assistants en exportant et en important les solutions qui les contiennent d’un environnement à un autre.
Pour exporter la solution avec votre assistant, procédez comme suit :
Dans la liste des solutions non gérées, sélectionnez la solution qui contient votre assistant.
Sélectionnez Exporter la solution. Comme dans l'expérience Power Apps exporter des solutions, le volet droit Avant d'exporter s'affiche.
Le reste des étapes est identique à l’exportation de solutions dans Power Apps. Pour terminer exporter la solution, suivez les instructions et les exigences de la documentation Power Apps.
Important
Si votre assistant a un grand nombre de composants (par exemple, plus de 250 rubriques ou plus de 100 entités), consultez Exporter en utilisant l’expérience classique.
Importer la solution avec votre agent
Pour importer la solution avec votre assistant dans un autre environnement, procédez comme suit :
Dans l’environnement cible, ouvrez l’Explorateur de solutions dans Copilot Studio.
Cliquez sur Importer la solution. Comme dans l’expérience Power Apps importer des solutions, le volet droit Importer une solution s’affiche.
Le reste des étapes est identique à l’importation de solutions dans Power Apps. Pour terminer importer la solution, suivez les instructions et les exigences de la documentation Power Apps.
Si l’importation échoue, sélectionnez Télécharger le fichier journal pour télécharger un fichier XML contenant des détails sur la cause de l’échec de l’importation. La raison la plus courante de l’échec d’une importation est que la solution ne contient pas certains composants obligatoires.
Dans l’explorateur de solutions, sélectionnez la nouvelle solution importée dans la liste.
Dans le volet Objets, sélectionnez Agents. Sélectionnez ensuite le nom de l'agent pour ouvrir l'agent dans Copilot Studio dans un nouvel onglet.
Configurez à nouveau l’authentification utilisateur pour l’assistant.
Important
- Vous devez publier votre agent importé avant de pouvoir le partager.
- L’icône de votre assistant peut mettre jusqu’à 24 heures pour apparaître partout.
Exporter et importer des agents dans Teams
Dans Microsoft Teams, vous pouvez exporter et importer des agents entre des équipes individuelles à l’aide de l’application Power Apps Teams.
Par exemple, si vous exportez un agent de travail à partir d’une équipe Teams (équipe A), puis que vous l’importez dans l’équipe B, vous n’avez pas besoin de le générer à partir de zéro pour l’équipe B.
Suivez les instructions de la section Exporter les personnalisations à partir de Dataverse for Teams.
Lors de la sélection des personnalisations à exporter, sélectionnez l’agent que vous souhaitez exporter. Utilisez le filtre dans le volet latéral pour afficher uniquement les agents d’une équipe spécifique.
L’agent est enregistré dans le dossier Téléchargements de votre ordinateur.
Pour importer dans Teams, suivez les instructions fournies dans Importer des personnalisations dans Dataverse for Teams.
Votre agent apparaît dans l’application Copilot Studio dans Teams, sous l’équipe dans laquelle vous l’avez importée.