Créer des collections de composants réutilisables (version préliminaire)
Une collection de composants est une collection de composants agent réutilisables. Les composants Copilot incluent des sujets, des connaissances, des actions et des entités. Vous pouvez Partager regrouper des collections de composants entre plusieurs agents au sein de votre environnement. Vous pouvez également utiliser une solution pour exporter et importer des collections de composants afin de déplacer leur contenu dans plusieurs environnements pour répondre à vos scénarios de gestion du cycle de vie des applications (ALM) .
Pour modifier une collection de composants ou ajouter une collection de composants à un agent, vous devez être la personne qui a créé la collection ou un utilisateur avec le rôle personnalisateur du système ou administrateur système. Une fois qu’une collection de composants est disponible pour un agent, tous les auteurs agent peuvent voir et utiliser la collection, mais ils ne peuvent pas modifier les composants à l’intérieur de la collection. En savoir plus sur la configuration de la sécurité utilisateur dans un environnement.
Créer des collections de composants
Vous pouvez créer des collections de composants directement depuis la page Paramètres pour un agent. Vous pouvez également les créer à partir de la page Bibliothèque . Lorsque vous ajoutez des composants agent à une collection, cette opération déplace les composants sélectionnés vers la collection. Le agent d’origine contient désormais des références à ces composants au sein de la collection. Vous pouvez maintenant Partager la collection avec d’autres agents dans votre environnement, ou la conditionner dans une solution à importer dans d’autres environnements.
Créer une collection de composants à partir d’un agent
Ouvrez le agent qui contient les composants que vous souhaitez rendre disponibles en tant que collection de composants.
Accédez à Paramètres et Sélectionner Collections de composants.
Si vous êtes sur le point de créer la première collection de composants dans votre environnement, Sélectionner Créer. Sinon, Sélectionner Nouveau.
Saisissez un nom et une description pour votre collection de composants.
Sélectionnez Suivant.
Sélectionner les composants que vous souhaitez ajouter à la collection de composants. Vous pouvez utiliser les catégories et le champ Rechercher pour affiner la liste des composants.
Sélectionnez Suivant.
Passez en revue le contenu de votre collection et Sélectionner Créez.
Créer une collection de composants à partir de la bibliothèque
Dans la navigation latérale, Sélectionner Bibliothèque.
Sélectionner Ajoutez un nouveau, puis Sélectionner Collection de composants.
Saisissez un nom et une description pour votre collection de composants.
Cliquez sur Terminer.
Connecter le agent qui contient les composants que vous souhaitez Partager ajouter à votre nouvelle collection de composants.
Ajoutez des composants du agent sélectionné à la collection.
Connecter et agent vers une collection de composants
Accédez à la bibliothèque et Sélectionner la collection de composants souhaitée. Vous pouvez Sélectionner la catégorie Collection de composants et le champ Rechercher pour affiner la liste des collections de composants.
Dans la zone Installé sur , Sélectionner Add agent.
Sélectionner le agent dans lequel vous souhaitez utiliser la collection de composants, et Sélectionner Ajouter.
Vous pouvez ajouter n’importe quel composant des agents connectés à votre collection de composants. Tous les agents connectés peuvent également utiliser n’importe quel composant de cette collection.
Ajouter des composants d’un agent à une collection
Accédez à la bibliothèque et Sélectionner la collection de composants souhaitée. Vous pouvez Sélectionner la catégorie Collection de composants et le champ Rechercher pour affiner la liste des collections de composants.
[Connecter le agent](#connect-an agent-to-a-component-collection) que vous souhaitez ajouter à la collection de composants, s’il n’est pas déjà répertorié dans la zone Installé sur .
Sélectionner Ajouter, puis Sélectionner Ajouter à partir d’un agent.
Sélectionner le agent souhaité, et Sélectionner Suivant.
Sélectionner les composants que vous souhaitez ajouter à la collection de composants. Vous pouvez utiliser les catégories et le champ Rechercher pour affiner la liste des composants.
Sélectionnez Suivant.
Passez en revue le contenu de votre collection et Sélectionner Ajoutez à la collection.
Créer une solution pour exporter et importer des collections de composants
Vous utilisez des solutions pour exporter des composants agent d’un environnement et les importer dans un autre. La solution agit comme un support pour les composants. Vous pouvez exporter et importer plusieurs composants agent dans une seule solution.
Accédez à la page Solutions .
Sélectionnez Nouvelle solution.
Entrez les informations suivantes pour la nouvelle solution :
- nom complet : Le nom à afficher dans la liste des solutions. Vous pourrez le modifier par la suite.
- Nom : Le nom unique de la solution, généré à partir de nom complet. Vous pouvez le modifier avant d’enregistrer la solution.
- Éditeur : Sélectionner l’éditeur par défaut ou créez-en un nouveau. Envisagez de créer un éditeur unique et utilisez-le de manière cohérente dans tous les environnements pour votre solution. En savoir plus sur les éditeurs de solutions.
- Version : saisissez un numéro pour la version de votre solution. Le numéro de version est inclus dans le nom de fichier quand vous exportez la solution.
Sélectionnez Créer.
Ajouter des collections de composants à une solution
Accédez à la page Solutions et ouvrez la solution souhaitée si elle n’est pas déjà là.
Sélectionner Ajouter un composant existant, pointer à agent et Sélectionner composant collection.
Un panneau apparaît, affichant toutes les collections de composants disponibles.
Sélectionner les collections de composants que vous souhaitez exporter, puis Sélectionner Ajouter en bas du panneau.
Exporter une solution vers des collections de composants Partager dans d’autres environnements
Vous exportez et importez des collections de composants en exportant et en important les solutions qui les contiennent d’un Sélectionner à un autre.
Accédez à la page Solutions .
Sélectionner l’icône Commandes (⋮) pour la solution qui contient les collections de composants que vous souhaitez exporter, puis Sélectionner Exporter la solution.
Entrez ou sélectionnez les options suivantes :
- Numéro de version : Copilot Studio augmente automatiquement la version de votre solution. Vous pouvez accepter la version par défaut ou entrer la vôtre.
- Exporter comme : Sélectionner le type de package, soit Géré ou Non géré. En savoir plus sur les solutions gérées et non gérées.
Cliquez sur Exporter. L’exportation peut prendre plusieurs minutes. Regardez le message du statut en haut de la page Solutions.
Une fois l’exportation terminée, cliquez sur le bouton Télécharger pour télécharger un fichier .zip.
Le nom du fichier a ce format : SolutionName_Version_SolutionType.zip, par exemple, ContosoSolution_1_0_0_1_managed.zip.
Importez une solution pour ajouter des collections de composants à un environnement
Accédez à la page Solutions .
Sélectionner le environnement où vous souhaitez importer votre collection de composants.
Cliquez sur Importer la solution.
Dans le panneau Importer , Sélectionner Browse, Sélectionner le fichier .zip qui contient la solution avec votre collection de composants, puis Sélectionner Suivant.
Cliquez sur Importer. L’importation peut prendre plusieurs minutes. Regardez le message du statut en haut de la page Solutions.
Attendez quelques instants que l’importation de la solution se termine.
Si l’importation échoue, Sélectionner Téléchargez 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 pour laquelle une importation échoue est que la solution ne contient pas certains composants requis.
Ajoutez des collections de composants importés à votre agent
Après avoir importé une collection de composants, vous pouvez l’utiliser dans vos agents.
Ouvrez le agent où vous souhaitez utiliser la collection de composants.
Accédez à la page Paramètres et Sélectionner Collections de composants.
À côté de la collection de composants importés, Sélectionner les points de suspension (…) et Sélectionner Ajoutez à agent.
Un message apparaît vous invitant à confirmer.
Sélectionner Ajouter à agent.
Le nom de votre agent apparaît sous Actif pour pour cette collection de composants.
Passez en revue les composants de la collection importée et publiez le agent pour rendre les modifications disponibles pour vos clients.
Ajouter des composants à une collection de composants dans une solution personnalisée
Si vous ajoutez de nouveaux composants agent à une collection de composants dans Copilot Studio, vous devez également les ajouter à toute solution non gérée qui fait référence à cette collection de composants.
Accédez à la page Solutions et ouvrez la solution non gérée qui contient la collection de composants à mettre à jour.
Dans le volet Objets , Sélectionner agent collections de composants.
Sélectionner l’icône Commandes (⋮) pour la collection que vous souhaitez mettre à jour, pointer sur Avancé, et Sélectionner Ajouter les objets requis.
Sélectionnez OK.
Dans le volet Objets , vous pouvez Sélectionner agent composants pour vérifier que les composants attendus apparaissent désormais.
Ouvrir l’explorateur de solutions
Dans Copilot Studio, Sélectionner les points de suspension (…) dans la navigation latérale, et Sélectionner Solutions.
La page Solutions s’ouvre dans un nouvel onglet de navigateur.
Problème connu
Si vous avez téléchargé des fichiers comme sources de connaissances pour un agent, l’ajout de ces fichiers à une collection de composants les supprime du agent d’origine. Pour contourner ce problème, vous pouvez déplacer ces fichiers de la collection de composants vers leur répertoire d’origine agent.