Référence de composant dans la bibliothèque d’agents dans le kit d’agent Copilot

Les composants de la bibliothèque d’agents sont des collections de composants préconstruites et réutilisables que vous pouvez ajouter à n’importe quel agent Copilot Studio. Chaque composant est emballé comme sa propre collection de composants, donc vous n’installez que les composants dont vous avez besoin.

Cet article est la référence par composant. Pour un aperçu des composants, de la navigation et de l’installation des composants depuis le kit, et de la manière de les ajouter à votre agent, consultez la section Gestion des composants dans la bibliothèque d’agents.

Composants en un coup d’œil

La bibliothèque d’agents comprend les composants suivants intégrés à leurs solutions. Les composants qui ne nécessitent aucune référence de connexion sont dans leur propre solution de base. Les composants partageant un connecteur commun sont regroupés.

Prerequisites

Avant de commencer, vérifiez que les conditions préalables suivantes sont remplies :

• Installez et configurez Copilot Agent Kit dans votre environnement Power Platform.
• L’utilisateur connecté a le rôle de sécurité CSK - Maker assigné dans Copilot Agent Kit pour parcourir et installer les composants.
• L’environnement Power Platform dispose de Copilot Studio activé.
• Ayez des crédits AI Builder disponibles dans votre environnement (nécessaires pour les composants basés sur des prompts).
• Pour ServiceNow Ticket Assistant, ayez une instance ServiceNow avec accès à l’API REST et une connexion ServiceNow configurée dans Power Platform. En savoir plus sur la configuration du principal de service ServiceNow.

Document Extraction

L’extraction de documents transforme les documents téléchargés en données structurées. Il utilise une invite AI Builder pour analyser et extraire les champs clés selon un schéma configurable.

Quand utiliser : Traitement des factures, révision de contrats, numérisation de formulaires, ou tout scénario nécessitant de récupérer des informations structurées à partir de documents non structurés.

Fonctionnement de l’extraction de documents

1. L’utilisateur télécharge un document dans la conversation de l’agent.
2. Le composant traite le document avec AI Builder.
3. Le composant renvoie les données extraites sous forme de sortie structurée que vous pouvez stocker, afficher ou transmettre aux flux en aval.

Entrées d’extraction de documents

Sorties d’extraction de documents

Toutes les sorties des prompts d’AI Builder sont renvoyées.

Content Synthesizer

Content Synthesizer transforme les résultats bruts en une section de recherche structurée et fondée sur des preuves, avec des citations en ligne. C’est le moteur de synthèse partagée utilisé à la fois par les pipelines de composante de recherche et de composante exécutive brief. Il peut également être ajouté à n’importe quel agent comme outil autonome pour la synthèse de contenu à la demande.

Quand utiliser : Tout scénario nécessitant de synthétiser plusieurs documents sources en un récit cohérent, basé sur des citations, soit dans le cadre d’un pipeline en plusieurs étapes, soit comme outil autonome de génération de contenu.

Comment fonctionne le synthétiseur de contenu

1. Le pipeline parent (ou agent) transmet une invite de recherche, du contenu brut des résultats de recherche et des instructions de style optionnelles.
2. Le prompt intègre les insights de toutes les sources par thème. Il ne résume pas source par source.
3. Les preuves reposent sur le contenu fourni avec des données spécifiques telles que des chiffres, des pourcentages, des dates et des entités nommées.
4. La sortie est un objet JSON contenant la section de markdown synthétisée et un tableau de citations extraites.

Entrées du synthétiseur de contenu

Sorties du synthétiseur de contenu

L’invite renvoie un objet JSON avec deux champs :

Structure de sortie du synthétiseur de contenu

La section synthétisée suit cette structure :

• Ouverture : Commence avec les découvertes les plus importantes et présente les thèmes clés.
• Corps : Organisé par thème (non par source), avec des marqueurs d’attribution et [n] de citation en ligne, des appels en gras pour la recherche de clés et des marqueurs optionnels [CHART SUGGESTION] .
• Points clés : Trois à cinq points concis et exploitables.
• Pi-dessous : Évaluation de la confiance (de haut à faible), récentement des données et lacunes notables.

Research Component

La composante recherche synthétise des informations provenant de multiples sources dans un rapport de recherche complet. Il utilise un pipeline d’IA en trois étapes pour planifier, rechercher et compiler les résultats.

Quand utiliser : Analyse concurrentielle, étude de marché, revue de politique, ou tout scénario nécessitant une vision consolidée à travers plusieurs sources d’information.

Fonctionnement de la composante de recherche

1. L’utilisateur propose une question ou un sujet de recherche.
2. Étape 1 (Planificateur de recherche) : Crée un plan de recherche structuré avec des sections et des requêtes.
3. Étape 2 (Synthétiseur de contenu) : Recherche dans les sources web pour chaque section et génère du contenu avec des citations.
4. Étape 3 (Finalisateur de rapport) : Combine toutes les sections et citations dans un rapport soigné.
5. Le rapport final est affiché en ligne dans la conversation.

Contributions des composantes de recherche

Résultats des composantes de recherche

Le composant affiche le rapport en ligne dans la conversation.

Composante du Brief exécutif

Executive Brief Component génère des résumés concis et orientés vers la décision à partir d’entrées complexes. Il utilise un pipeline d’IA en trois étapes pour planifier, synthétiser les insights et compiler un brief exécutif soigné.

Quand utiliser : Préparation des réunions du conseil, mises à jour de l’état des projets, revues trimestrielles des affaires, ou tout scénario nécessitant un résumé soigné pour les parties prenantes.

Fonctionnement de la composante Executive Brief

1. L’utilisateur propose un bref sujet ou une question.
2. Étape 1 (Planificateur exécutif des briefs) : Crée un plan de recherche stratégique avec les domaines de recherche.
3. Étape 2 (Insight Synthesizer, propulsé par Content Synthesizer) : recherche dans les sources internes et web de chaque domaine et extrait les faits clés et les références.
4. Étape 3 (Finalisateur de mémoires) : Rassemble toutes les analyses et citations dans un mémoire exécutif soigné.
5. Le brief est affiché en ligne dans la conversation.

Contributions de la composante Executive Brief

Résultats des composantes Executive Brief

Le module affiche le brief exécutif en ligne dans la conversation.

Assistant de tickets ServiceNow

ServiceNow Ticket Assistant fournit une gestion complète des incidents ServiceNow directement depuis un agent de Copilot Studio. Il comprend cinq sujets couvrant l’ensemble du cycle de vie de l’incident.

Quand utiliser : le support informatique, l’auto-service des employés, ou tout scénario impliquant la gestion d’incidents ServiceNow.

ServiceNow incluait des sujets

ServiceNow prerequisites

Ce composant est livré dans sa propre solution (CopilotStudioKit_ServiceNow_Components) car il nécessite une référence de connexion ServiceNow lors de l’importation. Avant d’importer cette solution, assurez-vous d’avoir :

• Une instance ServiceNow avec accès à l’API REST.
• Une connexion configurée dans Power Platform pour ServiceNow. On vous invite à configurer cela lors de l’importation de la solution.
• Permissions utilisateur appropriées de ServiceNow pour les opérations nécessaires.

Configuration du principal de service ServiceNow

Pour configurer une connexion ServiceNow Power Platform utilisant Microsoft Entra ID, suivez les étapes de Comment configurer une connexion ServiceNow Power Platform utilisant Microsoft Entra ID.

Comment fonctionne ServiceNow Ticket Assistant

1. L’utilisateur exprime une intention (par exemple, « Je dois créer un ticket » ou « Quel est le statut de INC0012345 ? »).
2. Le sujet approprié est déclenché et présente une carte adaptative pour collecter les entrées requises.
3. Le composant appelle l’API ServiceNow via un connecteur et renvoie le résultat.
4. Après l’opération, le sujet Actions suivantes présente des options pour l’étape suivante.

Create incident

Crée un nouvel incident ServiceNow en collectant les informations de l’utilisateur et en les soumettant à ServiceNow via un connecteur.

Quand utiliser : le support informatique, le libre-service des employés, ou toute situation où les utilisateurs doivent enregistrer les nouveaux incidents directement depuis la conversation.

Créer un flux d’incidents

1. L’utilisateur exprime l’intention de créer un incident, par exemple « Je dois créer un ticket pour un ordinateur portable cassé. »
2. Une carte adaptative recueille les détails requis de l’incident.
3. Le composant appelle l’API ServiceNow pour créer l’incident et renvoie une confirmation avec le numéro d’incident.
4. Un menu Actions suivantes est présenté afin que l’utilisateur puisse poursuivre une autre opération ServiceNow.

Créer des entrées d’incident via une carte adaptative

Créer des sorties d’incidents

Message de confirmation avec le numéro d’incident créé affiché en ligne.

Vérifier l’état de l’incident

Récupère le dernier statut et les détails d’un incident ServiceNow existant.

Vérifier le flux d’état de l’incident

1. L’utilisateur demande à propos d’un incident, par exemple : « Quel est le statut de INC0010002 ? »
2. Une carte adaptative collecte le numéro d’incident.
3. Le composant interroge ServiceNow et renvoie les détails de l’incident.

Vérifiez les entrées d’état de l’incident via une carte adaptative

Vérifier les sorties de l’état des incidents

Résolution ou fermeture d’incident

Met à jour l’état d’un incident ServiceNow existant en Résolu, Fermé, Annulé, En attente ou en cours, ainsi que les détails de la résolution.

Résoudre ou fermer le flux d’incident

1. L’utilisateur exprime l’intention de résoudre ou de clore un incident, par exemple « Fermer le INC0010002 du ticket ».
2. Une carte adaptative collecte le numéro d’incident, l’état de la cible, le code de résolution et les notes de résolution.
3. Le composant met à jour l’incident dans ServiceNow et renvoie une confirmation.

Prérequis pour résoudre ou clôturer les incidents

Une instance ServiceNow avec accès à l’API REST et une connexion ServiceNow dans Power Platform.

Résoudre ou fermer les entrées d’incident via une carte adaptative

Résoudre ou fermer les sorties d’incident

Message de confirmation avec l’état de l’incident mis à jour affiché en ligne.

Obtenez des incidents récents

Récupère et affiche jusqu’à 10 incidents récents ServiceNow pour l’utilisateur actuel. Aucun champ d’entrée n’est nécessaire. Le composant utilise automatiquement l’adresse e-mail de l’utilisateur connecté.

Quand utiliser : Lorsque les utilisateurs souhaitent un aperçu rapide de leurs incidents récents ou en cours.

Faites circuler les incidents récents

1. L’utilisateur pose des questions sur ses incidents, par exemple « Affichez mes incidents récents. »
2. Le composant interroge ServiceNow pour jusqu’à 10 incidents récents correspondant à l’adresse e-mail de l’utilisateur connecté.
3. Les détails de l’incident sont affichés en ligne dans la conversation.

Obtenez les informations sur les incidents récents

None. Le composant utilise automatiquement l’adresse e-mail de l’utilisateur connecté.

Obtenez les résultats des incidents récents

Panneau de détails des composants

Lorsque vous ouvrez un composant depuis la bibliothèque d’agents dans Copilot Agent Kit, le panneau de détails affiche la description du composant, la catégorie, les variables d’entrée et de sortie, ainsi que la technologie utilisée.

Pour installer un composant et l’ajouter à un flux de travail d’agent, voir Gestion des composants.

Utilisez des composants avec une solution gérée

Utilisez la solution managée pour la plupart des utilisateurs. Les composants importés sont en lecture seule. Vous pouvez les ajouter à vos agents et les utiliser sans risquer de modifier accidentellement les sujets, les prompts ou les flux sous-jacents.

Même sans modifier les composants eux-mêmes, vous avez deux façons de contrôler le comportement : les instructions de l’agent et les paramètres par défaut des entrées d’outils.

Agent instructions

Le champ Instructions de votre agent Copilot Studio est la principale façon de façonner l'utilisation des composants. Grâce aux instructions en langage naturel, vous pouvez contrôler :

• Lorsqu’un composant est invoqué : Décrivez les scénarios ou les intentions utilisateur qui devraient déclencher chaque outil.
• Quelles données sont transmises : Indiquez à l’agent quel contexte, variables ou historique de conversation inclure.
• Comment les résultats sont présentés : Spécifiez la mise en forme, le tonalité, les actions de suivi ou le routage après qu’un composant ait retourné sa sortie.
• Orchestration globale : Définissez l’ordre des opérations lorsque plusieurs composants sont impliqués, par exemple : « Après avoir terminé la recherche, générez un brief exécutif à partir des résultats. »

Paramètres par défaut des entrées d’outil

Lorsque vous ajoutez des composants comme outils, comme les invites AI Builder, vous pouvez configurer directement les paramètres d’entrée dans Copilot Studio, même en utilisant une solution gérée. Ces entrées permettent de définir des paramètres par défaut plus spécifiques que ce que les instructions agent seules peuvent obtenir. For example:

• Indiquez un code par défaut ExtractionSchema adapté à vos documents professionnels, comme des champs de facture tels que le nom, le numéro de facture et la date.
• Remplissez AdditionalInstructions à l’avance avec le style d’écriture préféré de votre organisation ou les exigences de conformité.

Les paramètres par défaut d’entrée sont configurés par agent, de sorte que différents agents peuvent transmettre différentes valeurs au même composant partagé.

Personnalisez les composants avec une solution non gérée

Si vous devez modifier l’intérieur des composants, comme modifier la logique des invites, modifier les flux de sujet ou recâbler les connecteurs, vous devez importer la solution non gérée. Cette solution vous donne un accès complet à chaque sujet, invite et flux dans la bibliothèque d’agents.

Les personnalisations courantes sont les suivantes :

• Modifier les prompts : Ajustez les prompts d’AI Builder pour qu’ils correspondent à votre domaine et au format de sortie.
• Modifier les sources de données : pointez les composants vers vos propres tables Dataverse, listes SharePoint ou connecteurs externes.
• Ajustez les sujets : Mettez à jour les flux de conversation pour qu’ils correspondent à la terminologie et aux processus de votre organisation.
• Mettez à jour les phrases déclencheuses : Ajoutez des phrases déclencheuses qui reflètent la manière dont vos utilisateurs demandent naturellement des choses.
• Ajouter l’authentification : Configurez l’authentification si les composants doivent accéder à des données spécifiques à l’utilisateur.

Related information

• Components management
• Documentation d’AI Builder