Créer et partager des collections de composants réutilisables

Les collections de composants permettent aux créateurs de créer et de partager des composants réutilisables entre les agents.

Lorsque vous utilisez des collections, vous pouvez :

Gérez, recherchez et créez des collections de composants depuis la barre latérale de Copilot Studio, sans avoir besoin d’ouvrir un agent, ce qui facilite la recherche et la réutilisation des blocs de construction partagés.
Utilisez l’exportation en un clic et l’importation simplifiée. Copilot Studio empaquete les collections dans des solutions gérées versionnées et vous permet d’importer directement depuis les paramètres de l’agent, simplifiant ainsi l’expérience maker.
Partagez des collections avec vos collègues tout en contrôlant l’accès aux modifications, ce qui permet une collaboration sécurisée et protège les ressources principales.
Limitez une collection afin qu’elle ne puisse être utilisée que par l’agent prévu ( l’agent principal), ce qui permet aux équipes de modulariser les copilotes volumineux ou sensibles sans réutilisation involontaire.
Testez le comportement d’une collection dans différents agents directement à partir de l’espace de travail Collections de composants, ce qui accélère l’itération et garantit des résultats cohérents.
Collectez et partagez de nouveaux types de connecteurs, y compris des agents enfants, des protocoles de contexte de modèle, des connecteurs et des flux.
Supprimez ou ajustez les dépendances pour découpler les ressources et prendre en charge des cycles de publication indépendants entre les équipes.

Les composants de l’agent sont les suivants :

topics
connaissance
outils
Agents enfants
Protocoles de contexte de modèle
connectors
flows
Entités

Pour modifier une collection de composants ou ajouter une collection de composants à un assistant, vous devez être la personne qui a créé la collection ou un utilisateur ayant le rôle de personnalisateur de système ou d’administrateur système. Une fois qu’une collection de composants est disponible pour un assistant, tous les auteurs d’assistant 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 à partir de la page Paramètres d’un agent ou de la page Collections de composants . Lorsque vous ajoutez des composants d’un agent à une collection, les composants sont déplacés vers la collection et l’agent fait référence aux composants de la collection.

Vous pouvez partager la collection avec d’autres agents de votre environnement ou l’exporter pour l’importer dans d’autres environnements.

Créer une collection de composants à partir d’un assistant

Ouvrez l’assistant qui contient les composants que vous souhaitez rendre disponibles en tant que collection de composants.
Accédez à Paramètres et sélectionnez Collections de composants.
Si vous êtes sur le point de créer la première collection de composants dans votre environnement, sélectionnez Créer. Sinon, sélectionnez Nouveau.
Entrez un nom et une description pour votre collection de composants.
Cliquez sur Suivant.
Sélectionnez les composants que vous souhaitez ajouter à la collection de composants. Vous pouvez utiliser les catégories et le champ de recherche pour affiner la liste des composants. Vous pouvez connecter des agents enfants lors de la révision de la collection.

Toutes les dépendances de composant sont automatiquement sélectionnées et ajoutées à la collection. Vous ne pouvez exclure des dépendances que si vous avez défini un agent principal pour la collection de composants.

L’agent principal est l’agent qui possède les composants de la collection. Si vous ne définissez pas d’agent principal, la collection de composants appartient à l’environnement et doit donc avoir accès aux dépendances.

Conseil / Astuce

Si vous avez chargé des fichiers en tant que sources de connaissances pour un assistant, l’ajout de ces fichiers à une collection de composants les supprime de l’assistant d’origine.
Pour contourner ce problème, vous pouvez déplacer ces fichiers de la collection de composants vers leur assistant d’origine.
Cliquez sur Suivant.
Passez en revue le contenu de votre collection et sélectionnez Créer.

Création d’une collection de composants au niveau de l’environnement

Dans la barre latérale, sélectionnez les trois points (...), puis sélectionnez Collections de composants.
Sélectionnez Ajouter nouveau, puis sélectionnez Collection de composants.
Entrez un nom et une description pour votre collection de composants.
Cliquez sur Terminer.
Connectez l’assistant contenant les composants que vous souhaitez partager à votre nouvelle collection de composants.
Ajoutez des composants de l’assistant sélectionné à la collection.

Connecter un assistant à une collection de composants

Dans la barre latérale, sélectionnez les trois points (...), puis sélectionnez Collections de composants.
Sélectionnez le regroupement que vous souhaitez connecter à un agent.
Dans la section Agents connectés , sélectionnez Ajouter un agent. Sélectionnez l’agent que vous souhaitez connecter, puis Ajouter.

Vous pouvez ajouter n’importe quel composant des assistants connectés à votre collection de composants. Tous les assistants connectés peuvent également utiliser n’importe quel composant de cette collection.

Ajouter des composants d’un assistant à une collection

Dans la barre latérale, sélectionnez les trois points (...), puis sélectionnez Collections de composants.
Sélectionnez la collection dans laquelle vous souhaitez ajouter des composants.
Connectez l’agent qui contient les composants que vous souhaitez réutiliser dans la collection, si ce n’est pas déjà fait.
Dans la section Ajouter des composants , sélectionnez Ajouter à partir d’un agent.

Note

Si vous n’avez connecté aucun agent à la collection de composants, l’option permettant d’ajouter des composants à partir d’un agent ne sera pas disponible.
Sélectionnez l’assistant souhaité et sélectionnez Suivant.
Sélectionnez les composants que vous souhaitez ajouter à la collection de composants. Vous pouvez utiliser les libellés de catégorie et le champ Rechercher des composants pour affiner la liste des composants.
Cliquez sur Suivant.
Passez en revue le contenu de votre collection et sélectionnez Ajouter à la collection.

Définir un agent principal pour une collection de composants et exclure les dépendances

Vous pouvez définir un seul agent comme agent principal pour une collection de composants. Les fabricants ont la possibilité de sélectionner un agent principal s’ils souhaitent qu’un seul agent spécifique utilise la collection de composants.

Si votre collection comporte plusieurs agents connectés, vous ne pouvez pas définir d’agent principal. Vous devez d’abord déconnecter tous les autres agents.

Lorsque vous définissez un agent principal, vous pouvez également exclure des dépendances lors de l’ajout de composants à partir de cet agent. Cela vous permet de créer des collections de composants plus petites qui n’incluent pas toutes les dépendances, ce qui peut être utile lorsque vous souhaitez partager uniquement des composants spécifiques.

Dans la barre latérale, sélectionnez les trois points (...), puis sélectionnez Collections de composants.
Sélectionnez le regroupement pour lequel vous souhaitez définir un agent principal.
Dans la section Agents connectés , sélectionnez les trois points (...) à côté de l’agent puis sélectionnez Définir l’agent principal.

Important

Si votre collection comporte plusieurs agents connectés, l’option permettant de définir un agent principal n’est pas disponible. Pour chaque agent autre que celui que vous souhaitez définir comme principal, sélectionnez Déconnecter de l’agent.

Pour exclure des dépendances lors de l’ajout de composants à partir de l’agent principal :

Sélectionnez Ajouter à partir d’un agent dans la collection de composants.
Sélectionnez l’agent principal, puis sélectionnez Suivant.
Sélectionnez les composants que vous souhaitez ajouter à la collection de composants. Désactivez l’option Inclure les dépendances des composants.
Cliquez sur Suivant.
Passez en revue le contenu de votre collection et sélectionnez Ajouter à la collection.

Vous pouvez partager une collection de composants avec d’autres utilisateurs de votre organisation et spécifier s’ils disposent des autorisations Visionneuse ou Éditeur . Pour plus d’informations sur les rôles d’autorisation pour les utilisateurs de Copilot Studio, consultez Contrôler le partage des agents.

Dans la barre latérale, sélectionnez les trois points (...), puis sélectionnez Collections de composants.
Sélectionnez la collection que vous souhaitez partager.
Dans la barre de menu supérieure, sélectionnez Partager.
Dans le panneau de partage, entrez les noms ou les adresses e-mail d’autres personnes avec lesquelles vous souhaitez partager la collection de composants. Pour chaque utilisateur, spécifiez les rôles d’autorisation (Visionneuse ou Éditeur).

Collections d’importation et d’exportation

Vous pouvez exporter des collections afin de les importer dans d’autres environnements. Lorsque vous exportez une collection, elle est gérée. Pour exporter une collection sans qu’elle ne soit gérée, consultez Utiliser des solutions pour les collections complexes.

Pour exporter une collection :

Dans la barre latérale, sélectionnez les trois points (...), puis sélectionnez Collections de composants.
Ouvrez la collection que vous souhaitez exporter.
Dans la barre de menu supérieure, sélectionnez Exporter.

L’exportation commence et une barre de notification s’affiche. Lorsque l’exportation est prête, la notification change pour inclure un lien permettant de télécharger la collection sous forme de fichier .zip.

Pour importer une collection :

Dans Copilot Studio, assurez-vous que l’environnement dans lequel vous souhaitez importer votre collection est sélectionné :
Ouvrez l’agent que vous souhaitez connecter à la collection, puis sélectionnez Paramètres dans la barre supérieure.
Sélectionnez Collections de composants dans le menu latéral, puis sélectionnez Importer la solution.
Dans le panneau qui s’affiche, sélectionnez Parcourir les fichiers , puis choisissez la collection exportée.
Les détails de la collection sont présentés. Vous pouvez exclure les étapes et les flux du plug-in dans la section Paramètres avancés .

Conseil / Astuce

Si vous essayez d’importer une collection dans le même environnement que celui à partir duquel vous l’avez exportée, un message d’erreur s’affiche. Vérifiez que vous êtes dans l’environnement ciblé qui ne contient pas la collection.
Cliquez sur Suivant. Le panneau d’importation se ferme, et un message indique que la collection a été importée avec succès.

Utilisez des solutions pour les collections complexes

Vous pouvez également utiliser des solutions pour exporter des composants d’agent à partir d’un environnement et les importer dans un autre. La solution fait office de moyen de transfert pour les composants. Vous pouvez exporter et importer plusieurs composants d’assistant dans une seule solution.

En général, utilisez des solutions pour les collections de composants complexes. Par exemple, si votre collection comporte des connecteurs ou des variables d’environnement.

Créer une solution

Allez sur la page Solutions.
Sélectionnez Nouvelle solution.
Entrez les informations suivantes pour la nouvelle solution :
- Nom d’affichage : le nom à afficher dans la liste de solutions. Vous pourrez le modifier par la suite.
- Nom : nom unique de la solution, généré à partir du Nom d’affichage. Vous pouvez le modifier avant d’enregistrer la solution.
- Éditeur : sélectionnez 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 : 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.
Cliquez sur Créer.

Ajouter des collections de composants à une solution

Accédez à la page Solutions et ouvrez la solution souhaitée si ce n’est pas déjà fait.
Sélectionnez Ajouter existant, pointez sur assistant et sélectionnez Collection de composants.

Un volet s’affiche, affichant toutes les collections de composants disponibles.
Sélectionnez les collections de composants que vous souhaitez exporter, puis sélectionnez Ajouter en bas du volet.

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

Allez sur la page Solutions.
Sélectionnez les trois points (⋮) pour la solution contenant les collections de composants que vous souhaitez exporter, puis sélectionnez Exporter la solution.
Entrez ou sélectionnez les options suivantes :
- 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, soit Géré, soit 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, sélectionnez le bouton Télécharger pour télécharger un fichier .zip.

Le nom du fichier a le format suivant : SolutionName_Version_SolutionType.zip, par exemple, ContosoSolution_1_0_0_1_managed.zip.

Importer une solution pour ajouter des collections de composants à un environnement

Allez sur la page Solutions.
Sélectionnez l’environnement où vous souhaitez importer votre collection de composants.
Cliquez sur Importer la solution.
Dans le volet Importer, sélectionnez Parcourir, sélectionnez le fichier .zip contenant la solution avec votre collection de composants, puis sélectionnez 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é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.

Ajouter des collections de composants importées à votre assistant

Après avoir importé une collection de composants, vous pouvez l’utiliser dans vos assistants.

Ouvrez l’assistant dans lequel vous souhaitez utiliser la collection de composants.
Accédez à la page Paramètres et sélectionnez Collections de composants.
En regard de la collection de composants importée, sélectionnez les trois points (...) et sélectionnez Ajouter à l’assistant.

Un message s’affiche vous invitant à confirmer.
Sélectionnez Ajouter à l’assistant.

Le nom de votre assistant s’affiche sous Actif pour pour cette collection de composants.
Passez en revue les composants de la collection importée et publiez l’assistant pour mettre les modifications à la disposition de vos clients.

Ajouter des composants à une collection de composants dans une solution personnalisée

Si vous ajoutez de nouveaux composants d’assistant à 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 contenant la collection de composants à mettre à jour.
Dans le volet Objets, sélectionnez Collections de composants de l’assistant.
Sélectionnez les trois points (⋮) de la collection que vous souhaitez mettre à jour, pointez vers Avancé, puis sélectionnez Ajouter les objets requis.
Cliquez sur OK.

Dans le volet Objets, vous pouvez sélectionner Composants de l’assistant pour vérifier que les composants attendus apparaissent maintenant.

Ouvrir l’explorateur de solutions

Dans Copilot Studio, sélectionnez les trois points (...) dans la barre latérale, puis sélectionnez Solutions.

La page Solutions s’ouvre dans un nouvel onglet du navigateur.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-11-17