Exporter et importer des copilotes à l’aide de solutions

  • Article

Important

Les capacités et les fonctionnalités de Power Virtual Agents font maintenant partie de Microsoft Copilot Studio, suite à des investissements significatifs dans l’IA générative et des intégrations améliorées dans Microsoft Copilot.

Certains articles et captures d’écran peuvent faire référence à Power Virtual Agents pendant que nous mettons à jour la documentation et le contenu de la formation.

Vous pouvez exporter et importer des copilotes à l’aide de solutions afin de pouvoir déplacer vos copilotes entre différents environnements.

Cela peut être utile si vous utilisez différents environnements à des fins différentes ou si vous utilisez des méthodologies de déploiement en anneau. Par exemple, vous pouvez avoir un environnement spécifique dans lequel vous testez et validez des copilotes en interne, un autre environnement dans lequel vous testez des copilotes uniquement pour un sous-ensemble d’utilisateurs et un environnement de production final dans lequel vous partagez des copilotes avec des clients et des utilisateurs finaux.

Note

Vous ne pouvez pas exporter les commentaires au niveau de la rubrique ou au niveau du nœud lorsque vous exportez un copilote.

Conditions préalables

Important

Cet article contient la documentation sur Microsoft Copilot Studio en version préliminaire et peut faire l’objet de modifications.

Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que vous puissiez y accéder en avant-première et fournir des commentaires.

Si vous créez un copilote prêt pour la production, consultez Vue d’ensemble de Microsoft Copilot Studio.

Déplacez vos copilotes entre des environnements en les exportant et en les important à l’aide de solutions. L’exportation et l’importation de vos copilotes peut être utile si vous utilisez différents environnements à des fins différentes ou si vous utilisez des méthodologies de déploiement en anneau. Par exemple, vous pouvez avoir un environnement spécifique dans lequel vous testez et validez des copilotes en interne, un autre environnement dans lequel vous testez des copilotes avec un sous-ensemble d’utilisateurs et un environnement de production dans lequel vous partagez vos copilotes avec des clients.

É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 copilote.

  • La suppression d’un copilote d’une solution ne supprime pas ses composants de la solution. Vous devez supprimer les composants séparément.

    Avertissement 

    Ne supprimez pas les composants de copilote non gérés, comme les rubriques de copilote, directement à partir du portail Power Apps, sauf si vous avez supprimé le copilote de la solution.

    Vous ne devez apporter de modifications aux rubriques que depuis Copilot Studio. La suppression ou la modification des composants d’un copilote depuis Power Apps entraînera l’échec de l’exportation et de l’importation.

  • Vous ne pouvez pas exporter les solutions gérées. Lorsque vous créez une solution, par défaut, elle n’est pas gérée. Si vous la modifiez ultérieurement en solution gérée, vous ne pouvez pas l’exporter. Vous devez créer une solution.

  • Si votre copilote comporte un grand nombre de composants (par exemple, plus de 250 rubriques ou plus de 100 entités), exportez-le en utilisant le portail Power Apps classique à la place.

Créer une solution pour gérer l’exportation et l’importation

Vous utilisez des solutions pour exporter des copilotes depuis un environnement et les importer dans un autre. La solution agit comme un « transporteur » pour les copilotes. Vous pouvez exporter et importer plusieurs copilotes dans une seule solution.

  1. Dans Copilot Studio, ouvrez le copilote que vous souhaitez exporter.

  2. Accédez à Paramètres, sélectionnez Détails du copilote, puis sélectionnez Exporter.

    Capture d’écran de l’onglet Détails du copilote dans Copilot Studio, avec le bouton Exporter mis en évidence.

  3. Sélectionnez Accéder aux solutions Power Apps.

    Capture d’écran de l’invite d’exportation du copilote.

  4. Dans Power Apps, sur l’onglet Solutions, sélectionnez Nouvelle solution.

    Capture d’écran de la page des solutions Power Apps, avec le bouton Nouvelle solution en surbrillance.

  5. Entrez les informations suivantes pour la nouvelle solution :

    Champ Description
    Display name Le nom indiqué dans la liste des solutions. Vous pourrez le modifier par la suite.
    Nom Nom unique de la solution, généré à partir de Nom complet. Vous pouvez le modifier avant d’enregistrer la solution, mais une fois la solution sauvegardée, vous ne pourrez plus le modifier.
    Serveur de publication Sélectionnez l’éditeur par défaut, ou créez-en un. Nous vous recommandons de créer un éditeur utilisable de manière cohérente dans tous les environnements où vous utiliserez la solution. En savoir plus sur les éditeurs de solutions.
    Version Entrez un numéro pour la version de la solution. Le numéro de version est inclus dans le nom de fichier quand vous exportez la solution.

  6. Sélectionnez Créer.

Ajouter votre copilote à la solution

  1. La solution que vous venez de créer doit être ouverte dans Power Apps. Si ce n’est pas le cas, sélectionnez-la dans la liste des solutions.

  2. Cliquez sur Ajouter existant, puis Chatbot.

  3. Dans la liste Ajouter des chatbots existants, sélectionnez le ou les copilotes 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.

Capture d’écran montrant le bouton Retirer de cette solution.

La suppression d’un copilote d’une solution ne supprime pas ses composants de la solution. Vous devez supprimer les composants séparément.

Avertissement 

Ne supprimez pas les sous-composants de copilote non gérés (tels que les rubriques de copilote) directement du portail Power Apps, sauf si vous avez supprimé le copilote lui-même de la solution.

Vous ne devez apporter de modifications aux rubriques que depuis le portail Copilot Studio.

La suppression ou la modification des sous-composants du copilote depuis Power Apps entraînera l’échec de l’exportation et de l’importation.

Exporter la solution avec votre copilote

Vous exportez et importez des copilotes en exportant et en important les solutions qui les contiennent d’un environnement à un autre.

Important

Si votre copilote comporte un grand nombre de composants (par exemple, plus de 250 rubriques ou plus de 100 entités), consultez Exporter à l’aide de l’expérience classique.

  1. Dans la page Power Apps Solutions, sélectionnez la solution contenant votre copilote, puis sélectionnez Exporter la solution.

    Capture d’écran du bouton Exporter dans Power Apps.

  2. Sélectionnez Suivant dans le volet Avant d’exporter.

  3. Entrez ou sélectionnez les options suivantes :

    Option Description
    Numéro de version Copilot Studio incrémente automatiquement la version de votre solution. Vous pouvez accepter la version par défaut ou entrer la vôtre.
    Exporter en tant que Sélectionnez le type de package Géré ou Non géré. En savoir plus sur les solutions gérées et non gérées.

  4. Cliquez sur Exporter.

L’exportation peut prendre plusieurs minutes. Regardez le message du statut en haut de la page Solutions. Lorsque l’export est terminé, votre navigateur télécharge un fichier .zip. Le nom du fichier est au format SolutionName_Version_ManagementType.zip ; par exemple, MyBotPublisher_1.0.0.0.1_Unmanaged.zip.

Importer la solution avec votre copilote

  1. Dans Power Apps, sélectionnez l’environnement où vous souhaitez importer votre copilote.

    Capture d’écran de la sélection d’un environnement Power Apps.

  2. Sur la page Solutions , assurez-vous qu’aucune solution n’est sélectionnée, puis sélectionnez Importer la solution.

    Capture d’écran de la page des solutions Power Apps, avec le bouton Solutions d’importation en surbrillance.

  3. Dans le volet Importer une solution, sélectionnez Parcourir, sélectionnez le fichier .zip contenant la solution avec votre copilote, puis sélectionnez Suivant.

  4. Cliquez sur Importer.

  5. Attendez quelques instants que l’importation de la solution se termine. Affichez les résultats, puis sélectionnez Fermer.

    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 plupart du temps, l’échec d’une importation est dû au fait que la solution ne contenait pas certains composants requis.

  6. Si l’authentification utilisateur est activée pour votre copilote, vous devrez le configurer à nouveau.

  7. Dans le volet Objets, sélectionnez Chatbot. Ensuite, sélectionnez le nom du copilote pour ouvrir le copilote dans le portail Copilot Studio.

    Capture d’écran d’une liste de copilotes et d’environnements dans Copilot Studio.

    Vous pouvez également ouvrir Copilot Studio directement, puis ouvrir votre copilote dans l’environnement dans lequel vous l’avez importé.

Important

Ajouter des composants à un copilote dans une solution personnalisée

Si vous ajoutez des composants, par exemple des rubriques ou des flux, à votre copilote dans Copilot Studio, vous devrez également les ajouter au copilote dans votre solution non gérée.

  1. Ouvrez votre solution dans le portail Power Apps.

  2. Sélectionnez Chatbots, puis sélectionnez votre copilote dans la liste.

  3. Sélectionnez Commandes (⋮), sélectionnez Avancé, puis sélectionnez +Ajouter les objets requis.

    Capture d’écran mettant en évidence l’option Ajouter les composants nécessaires sous le menu Commandes dans Power Apps.

Mettre à niveau ou mettre à jour une solution avec un copilote

Découvrez comment mettre à jour ou mettre à niveau une solution.

Supprimer une couche non gérée d’un copilote géré

Les solutions gérées et non gérées existent à différents niveaux au sein d’un environnement Microsoft Dataverse. Pour en savoir plus, accédez à Couches de solution.

Lorsque vous modifiez un composant géré, comme une rubrique ou un flux, il obtient une couche « Active » non gérée. Pour afficher les dernières mises à jour une fois la solution déployée, vous devez supprimer cette couche.

Utilisez l’option Voir les couches de solution pour voir toutes les solutions dont un composant fait partie. Vous pouvez également voir une solution « active » au-dessus de toutes les autres solutions si vous avez effectué des modifications directement.

  1. Ouvrez votre solution dans le portail Power Apps.

  2. Sélectionnez Chatbots, puis sélectionnez votre copilote dans la liste.

  3. Sélectionnez Commandes (⋮), sélectionnez Avancé, puis sélectionnez Voir les couches de solution.

    Capture d’écran mettant en évidence l’option Voir les couches de solution sous le menu Commandes dans Power Apps.

  4. Dans la page Couches de solution, sélectionnez la couche non gérée, puis sélectionnez Supprimer la couche non gérée.