Exportation et importation des agents à l'aide de solutions

Vous pouvez exporter et importer des agents en utilisant les solutions pour vous permettre de déplacer vos agents entre différents environnements.

Tout d’abord, créez une solution personnalisée et ajoutez-y votre assistant. Ensuite, vous exportez la solution avec votre agent et l’importez 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érez les solutions dans Copilot Studio.

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 connaître les concepts de solution, comme décrit dans Solution concepts et Create 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.

• 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 dont le nom de l'un de ses sujets comporte des points (.).

Créer une solution personnalisée et ajouter votre assistant

1. 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.

2. La solution que vous avez créée doit s’ouvrir automatiquement. Si elle n’apparaît pas, sélectionnez-la dans la liste des solutions.

3. Sélectionnez Ajouter existant, puis sélectionnez Agent, puis Agent à nouveau.

4. Dans la liste Ajouter des assistants existants, sélectionnez le ou les assistants que vous souhaitez exporter, puis sélectionnez Ajouter.

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.

1. Ouvrez l'explorateur de solutions dans Copilot Studio.

2. Sélectionnez la solution contenant votre assistant.

3. Dans le volet Objets, localisez votre agent sous Agents.

4. Sélectionnez les trois points (⋮), sélectionnez Avancé, puis sélectionnez Ajouter les objets requis.

Vous devez également consulter les instructions et les exigences de la documentation Power Apps pour addiez 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.

Ajouter des flux de Power Automate

Lorsque vous utilisez des flux et des variables d’environnement, ajoutez les objets nécessaires pour les flux et les variables d’environnement.

1. Ouvrez l'explorateur de solutions dans Copilot Studio.

2. Sélectionnez la solution contenant votre assistant.

3. Dans le volet Objets , localisez vos flux de travail.

4. 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 :

1. Ouvrez l'explorateur de solutions dans Copilot Studio.

2. Sélectionnez la solution contenant votre assistant.

3. Si les variables d’environnement n’existent pas dans la solution, sélectionnez Ajouter des variables existantes, Plus, puis sélectionnez Variable d’environnement.

   1. Sélectionnez les variables d’environnement requises.

   2. Sélectionnez Suivant, puis Ajouter.

4. Si toutes les variables d’environnement existent dans la solution, sélectionnez les trois points (⋮), sélectionnez Avancé, puis sélectionnez Ajouter les objets requis pour vous assurer que toutes les dépendances sont ajoutées à la solution.

Personnaliser les composants pour des solutions gérées

Pour rendre les composants personnalisables dans une solution gérée, voir Voir et modifier les propriétés gérées dans 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 :

1. Ouvrez l'explorateur de solutions dans Copilot Studio.

2. Dans la liste des solutions non gérées, sélectionnez la solution qui contient votre assistant.

3. Sélectionnez Exporter la solution. Comme dans l’expérience Power Apps exporter des solutions, le volet droit Avant d'exporter s’affiche.

4. 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.

Importer la solution avec votre agent

Pour importer la solution avec votre assistant dans un autre environnement, procédez comme suit :

1. Dans l’environnement cible, ouvrez l’Explorateur de solutions dans Copilot Studio.

2. Cliquez sur Importer la solution. Comme dans l’expérience Power Apps importer des solutions, le volet droit Importer une solution s’affiche.

3. 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.

1. Dans l’explorateur de solutions, sélectionnez la nouvelle solution importée dans la liste.

2. 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.

3. Configurez à nouveau l’authentification utilisateur pour l’assistant.

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 opérationnel depuis une équipe Teams (équipe A), puis que vous l’importez dans l’équipe B, vous n’avez pas besoin de le recréer 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. Vous pouvez utiliser le filtre dans le volet latéral pour afficher uniquement les agents pour 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.