Partage via


Source de données d’inventaire de l’agent

Cet article est la référence faisant autorité pour la table Détails de l’agent dans Dataverse, qui alimente la page Inventaire de l’agent dans Copilot Studio Kit. La table Détails de l’agent répertorie chaque champ, la règle de source ou de détection Dataverse, la version et une description concise pour les consommateurs en aval.

Public visé

  • Ingénieurs et intégrateurs de plateforme implémentant la logique de synchronisation ou de validation
  • Opérateurs et équipes de support pour résoudre les problèmes des configurations d’agent
  • Analystes et auteurs de rapports consommant les détails de l’agent pour les tableaux de bord et les rapports

Comment utiliser cet article

  • Utilisez la table de schémas pour les noms de colonnes, les types de données et les sources exacts.
  • Utilisez les règles de dérivation lors de l’implémentation de tests de logique de détection ou de validation.
  • La colonne de version indique la maturité du champ (V1, V2).

Terminologie

  • Les tables Dataverse référencées incluent bot, botcomponent, processeset conversationtranscript.
  • « Rubrique v2 » désigne le schéma de rubrique de plateforme utilisé dans les flux conversationnels.

Table Détails de l’agent

Le tableau suivant fournit des détails sur la table Dataverse détails de l’agent, qui alimente la page Inventaire de l’agent .

Conseil / Astuce

Pour une meilleure lisibilité, sélectionnez Développer la table pour afficher l’intégralité de la table.

Non Nom de colonne Nom du schéma de colonne Type de données Origine Version Descriptif
1 ID d’agent cat_agentid Texto Dataverse : Colonne → bot table botid V1 Identificateur unique Dataverse pour l’agent (botid).
2 Nom cat_name Texto Dataverse : Colonne → bot table name V1 Nom complet de l’agent.
3 Type cat_type Texto Valeur codée en dur en tant que personnalisée V2 Type d’agent (déclaratif, personnalisé).
4 Nom de l’environnement cat_environmentname Texto Connecteur d’administration Power Platform :List environments as admin sortie : préférerfriendlyName, revenir en arrière ou displayNameproperties.linkedEnvironmentMetadata.friendlyName V1 Nom complet de l’environnement où l’agent est déployé.
5 ID environnement cat_environmentid Texto Connecteur d’administration Power Platform :List environments as admin sortie : name (identificateur d’instance) V1 Identificateur unique de l’environnement (nom de l’instance).
6 Type d’environnement cat_environmenttype Texto Connecteur d’administration Power Platform :List environments as admin sortie : properties.environmentSku V1 Référence SKU/type d’environnement (Production, Développement).
7 Descriptif cat_description Texte multiligne Dataverse : Table botcomponentcomponenttypename = Colonne de → description GPT personnalisée (15) V1 Description lisible par l’homme de l’agent.
8 Instructions cat_Instructions Texte multiligne Dataverse : Table botcomponent (GPT personnalisé) → propriété → data de colonne YAML instructions V1 Instructions d’administration ou conseils d’utilisation pour l’agent.
9 Date de création de l’agent cat_agentcreateddate Date et heure Dataverse : Colonne → bot table createdon V1 Horodatage de création de l’agent.
10 Date de modification de l’agent cat_agentmodifieddate Date et heure Dataverse : Colonne → bot table modifiedon V1 Horodatage de la dernière modification de l’agent.
11 Agent créé par cat_agentcreatedby Texto Dataverse : Colonne → bot table createdby V1 Utilisateur qui a créé l’agent.
12 Agent modifié par cat_agentmodifiedby Texto Dataverse : Colonne → bot table modifiedby V1 Utilisateur qui a modifié l’agent pour la dernière fois.
13 État managé cat_managedstate Texto Dataverse : Colonne → bot table ismanaged V1 Indique si l’agent est géré ou non géré.
14 Publiée cat_published Booléen Dataverse : Date de publication → table bot présente → true V1 True si l’agent a une date de publication.
15 Date de publication cat_publisheddate Date et heure Dataverse : Colonne → bot table published (date publiée) V1 Horodatage lorsque l’agent a été publié.
16 Publié par cat_publishedby Texto Dataverse : Colonne → bot table publishedby V2 Utilisateur qui a publié l’agent.
17 ID d’application par défaut cat_defaultapplicationid Texto Dataverse : Table botsynchronizationstatus propriété → applicationId JSON V1 ID d’application par défaut associé à l’agent.
18 Utilise Gen AI cat_usesgenai Booléen Dérivé : true si l’agent utilise l’une des actions, invites, sources de connaissances, MCP, réponses personnalisées, sources génératives classiques, connaissance de l’IA ou orchestration générative V1 Indique si l’agent utilise des fonctionnalités d’IA génératives.
19 Type d’orchestration cat_orchestrationtype Texto Dataverse : Table botconfigurationGenerativeActionsEnabled JSON (true → générative ; sinon classique) V1 Type d’orchestration (génératif ou classique).
20 Agent autonome cat_AutonomousAgent Booléen Dataverse : Table botcomponentcomponenttypename = Déclencheur externe (17) → présence = true V2 True si l’agent contient un composant de déclencheur externe (autonome).
Vingt-et-un Utilise les résultats de recherche améliorés cat_usesenhancedsearchresults Booléen Dataverse : Table botconfiguration JSON → isSemanticSearchEnabled (true → true) V1 Indique si la recherche sémantique/améliorée est activée.
22 Utilise les outils cat_usesactions Booléen Dataverse : Table botcomponent (Rubrique v2) → data contient TaskDialog → true V1 True si l’agent utilise des nœuds d’outil/action.
23 Utilise la connaissance de l’IA cat_usesaiknowledge Booléen Dataverse : Table botconfiguration JSON → useModelKnowledge (true → true) V1 Indique si l’agent est autorisé à utiliser des connaissances générales sur l’IA.
Vingt-quatre Utilise des sources de connaissances cat_UsesKnowledgeSources Booléen Dataverse : Table botcomponentcomponenttypename = Pièce jointe de fichier bot ou sources de connaissances → data.KnowledgeSourceConfiguration présente → true V1 True si des sources de connaissances sont configurées.
25 Utilise des sources de réponses génératives classiques cat_UsesClassicGenerativeAnswersSources Booléen Dataverse : Table botcomponent (Rubrique v2) → Dans la data colonne, la propriété searchAndSummarizeContent contient l’une des sources classiques : publicdatasource, sharePointSearchDataSource, customdatasource et azureopenaionyourdatasource → true V2 True si les sources de réponses génératives classiques sont configurées.
26 Utilise des invites cat_usesaibuilderprompts Booléen Dataverse : Table botcomponent (Rubrique v2) → data contient InvokeAIBuilderModelAction → true V1 True si des invites sont utilisées.
27 Utilise MCP cat_UsesMCP Booléen Dataverse : Table botcomponent (Rubrique v2) → data contient kind: InvokeExternalAgentTaskAction → true V2 True si les actions MCP (Model Context Protocol) sont présentes.
28 Utilise une réponse personnalisée cat_UsesCustomizedResponse Booléen Dataverse : Table botcomponent (Rubrique v2) → data contient kind: AnswerQuestionWithAI → true V2 True si des nœuds de réponse personnalisés sont présents.
29 Utilise le contexte d’authentification connector Maker cat_UsesConnectorMakerAuthContext Booléen Dataverse : botcomponent.data → →connectionProperties.mode = maker true V2 True si un connecteur est configuré pour s’exécuter en mode d’authentification maker.
30 Utilise le contexte d’authentification de flux cloud cat_UsesCloudFlowAuthContext Booléen Dataverse : logique processes de table →clientdata.connectionreferences + impersonation/runtimesource (emprunt d’identité = {} ou runtimesource incorporée → maker ; impersonation.source=invoker → invoker) V2 Indique si les flux cloud appelés nécessitent un contexte d’authentification de créateur ou d’appelant.
31 type d’authentification End-User cat_enduserauthenticationtype Texto Dataverse : Colonne → bot table authenticationmode V1 Mode d’authentification de l’utilisateur final pour l’agent.
32 Utilise les requêtes HTTP cat_useshttprequests Booléen Dataverse : Table botcomponent (Rubrique v2) → data contient HttpRequestAction → true V1 True si l’agent émet des actions de requête HTTP.
33 Utilise des compétences cat_usesskills Booléen Dataverse : Table botcomponent (Rubrique v2) → data contient InvokeSkillAction → true V2 True si l’agent appelle des compétences.
34 Sources de connaissances cat_knowledgesources Texte multiligne Dataverse : Table botcomponentcomponenttypename = Pièce jointe de fichier bot ->FileDataName ou sources de connaissances → data.KnowledgeSourceConfiguration V1 Liste des sources de connaissances configurées (configuration brute).
35 Sources de données classiques cat_ClassicDataSources Texte multiligne Dataverse : Table botcomponent (Rubrique v2) → Dans la data colonne, la propriété searchAndSummarizeContent contient l’une des sources classiques : publicdatasource, sharePointSearchDataSource, customdatasource et azureopenaionyourdatasource V2 Liste des sources de données classiques référencées par l’agent.
36 Actions de requête HTTP cat_httprequestactions Texte multiligne Dataverse : Table botcomponent (Rubrique v2) → data contient HttpRequestAction des entrées V1 Liste des actions de requête HTTP configurées.
37 Invites cat_aibuilderprompts Texte multiligne Dataverse : Table botcomponent (Rubrique v2) → data contient InvokeAIBuilderModelAction des entrées V1 Liste des invites utilisées par l’agent.
38 Connections cat_Connections Texte multiligne Connexions de l’agent : botcomponent.data.connectionreference + connectionProperties.mode; Connexions de flux : processes.clientdata.connectionreferences (nom d’API, emprunt d’identité, runtimesource) : dériver le nom de connexion et le mode d’authentification (créateur ou appelant) V2 Noms de connexion de connecteur/flux et modes d’authentification déduits (maker/invoker).
39 Déclencheurs d’agent cat_AgentTriggers Texte multiligne Dataverse : Table botcomponentcomponenttypename = Déclencheur externe (17) → data.triggerConnectionType V2 Liste des connecteurs de déclencheur utilisés par l’agent.
40 Utilise des sources de connaissances personnalisées cat_UsesCustomKnowledgesSources Booléen Dataverse : Table botcomponent (Rubrique v2) → data commence par kind: AdaptiveDialog et beginDialog.kind: OnKnowledgeRequested → true V2 True si des boîtes de dialogue de demande de connaissances adaptatives personnalisées sont présentes.
41 Utilise des modèles de raisonnement profond cat_UsesDeepReasoningModels Booléen Dataverse : table botconfiguration.optInUseLatestModels (true → true) V2 True si l’agent opte dans les modèles de raisonnement les plus récents/plus approfondis.
42 Utilise l’entrée de fichier cat_UsesFileInput Booléen Dataverse : table botconfiguration.isFileAnalysisEnabled (true → true) V2 True si l’analyse/l’entrée de fichier est activée.
43 EnvironmentUrl cat_EnvironmentUrl Texto Connecteur d’administration Power Platform :List environments as admin sortie : URL de l’instance V2 URL de l’instance d’environnement.
44 IsTranscriptAvailable cat_IsTranscriptAvailable Texto Dataverse : table : conversationtranscript présence indique la disponibilité V2 Indique si les transcriptions de conversation existent pour l’agent.

Règles de dérivation et de détection de champ

Les règles de détection suivantes s’appliquent à chaque champ dérivé ou booléen. Les noms de colonnes de schéma sont indiqués entre parenthèses.

  • ID de l’agent (cat_agentid) : Dataverse bot.botid.
  • Nom (cat_name) : Dataverse bot.name.
  • Type (cat_type) : valeur Custom codée en dur (V2).
  • Nom de l’environnement (cat_environmentname) : connecteur List environments as admind’administration Power Platform : préférez friendlyName, basculez vers displayName ou properties.linkedEnvironmentMetadata.friendlyName.
  • ID d’environnement (cat_environmentid) : connecteur name administrateur (identificateur d’instance).
  • Type d’environnement (cat_environmenttype) : connecteur properties.environmentSkud’administration .
  • Description (cat_description) : botcomponentcomponenttypename = GPT personnalisé (15) → description.
  • Instructions (cat_Instructions) : botcomponent (GPT personnalisé) → YAML data.instructions.
  • Date de création de l’agent (cat_agentcreateddate) : bot.createdon.
  • Date de modification de l’agent (cat_agentmodifieddate) : bot.modifiedon.
  • Agent créé par (cat_agentcreatedby) : bot.createdby.
  • Agent modifié par (cat_agentmodifiedby) : bot.modifiedby.
  • État managé (cat_managedstate) : bot.ismanaged (managé ou non managé).
  • Publié (cat_published) : true lorsqu’il bot contient un horodatage publié.
  • Date de publication (cat_publisheddate) : bot.published horodatage.
  • Publié par (cat_publishedby) : bot.publishedby.
  • ID d’application par défaut (cat_defaultapplicationid) : bot.synchronizationstatusapplicationIdJSON .
  • Utilise Gen AI (cat_usesgenai) : true si l’agent utilise l’un des outils/actions, les invites, les sources de connaissances, MCP, les réponses personnalisées, les sources de génération classiques, les connaissances de l’IA ou l’orchestration générative activée.
  • Type d’orchestration (cat_orchestrationtype) : bot.configuration.GenerativeActionsEnabled → autregenerativeclassic.
  • Agent autonome (cat_AutonomousAgent) : true quand botcomponent.componenttypename = Déclencheur externe (17) existe.
  • Utilise les résultats de recherche améliorés (cat_usesenhancedsearchresults) : bot.configuration.isSemanticSearchEnabled = true.
  • Utilise Les outils (cat_usesactions) : la rubrique v2 botcomponent.data contient TaskDialog des entrées.
  • Utilise la connaissance de l’IA (cat_usesaiknowledge) : bot.configuration.useModelKnowledge = true.
  • Utilise des sources de connaissances (cat_UsesKnowledgeSources) : présence d’entrées KnowledgeSources botcomponent (data.KnowledgeSourceConfiguration ou entrées de pièce jointe de fichier bot).
  • Utilise des sources de réponses génératives classiques (cat_UsesClassicGenerativeAnswersSources) : la rubrique v2 data.searchAndSummarizeContent inclut des types de sources classiques (publicdatasource, sharePointSearchDataSource, customdatasource, azureopenaionyourdatasource).
  • Utilise les invites (cat_usesaibuilderprompts) : la rubrique v2 data contient InvokeAIBuilderModelAction.
  • Utilise MCP (cat_UsesMCP) : la rubrique v2 data contient kind: InvokeExternalAgentTaskAction.
  • Utilise la réponse personnalisée (cat_UsesCustomizedResponse) : la rubrique v2 data contient kind: AnswerQuestionWithAI.
  • Utilise le contexte d’authentification connector Maker (cat_UsesConnectorMakerAuthContext) : n’importe quelbotcomponent.data.connectionProperties.mode = maker .
  • Utilise le contexte d’authentification de flux cloud (cat_UsesCloudFlowAuthContext) : dérivé de l’utilisation processes.clientdata.connectionreferences et impersonation des runtimesource règles (emprunt d’identité = {} ou runtimesource incorporée → maker ; impersonation.source = invoker → invoker).
  • End-User Type d’authentification (cat_enduserauthenticationtype) : bot.authenticationmode.
  • Utilise les requêtes HTTP (cat_useshttprequests) : la rubrique v2 data contient HttpRequestAction des entrées.
  • Utilise les compétences (cat_usesskills) : la rubrique v2 data contient InvokeSkillAction des entrées.
  • Sources de connaissances (cat_knowledgesources) : brute data.KnowledgeSourceConfiguration à partir de botcomponent (JSON/YAML multiligne).
  • Sources de données classiques (cat_ClassicDataSources) : rubrique v2 data.searchAndSummarizeContent entrées classiques agrégées.
  • Actions de requête Http (cat_httprequestactions) : configurations de → data rubrique v2 HttpRequestAction .
  • Invites (cat_aibuilderpromts) : Rubrique v2 dataInvokeAIBuilderModelAction configurations.
  • Connexions (cat_Connections) : agréger à partir etbotcomponent.data.connectionreference + connectionProperties.modeprocesses.clientdata.connectionreferences (nom d’API, emprunt d’identité, runtimesource) pour dériver le nom de connexion et le mode d’authentification (maker/invoker).
  • Déclencheurs d’agent (cat_AgentTriggers) : botcomponent lignes où componenttypename = Déclencheur externe (17) → data.triggerConnectionType.
  • Informations d’utilisation : collectées à partir de points de terminaison d’API de licence pour les rapports de droits d’utilisation et de consommation.
  • Utilise des sources de connaissances personnalisées (cat_UsesCustomKnowledgesSources) : la rubrique v2 data commence par kind: AdaptiveDialog et beginDialog.kind: OnKnowledgeRequested.
  • Utilise des modèles de raisonnement profond (cat_UsesDeepReasoningModels) : bot.configuration.optInUseLatestModels = true.
  • Utilise l’entrée de fichier (cat_UsesFileInput) : bot.configuration.isFileAnalysisEnabled = true.
  • EnvironmentUrl (cat_EnvironmentUrl) : URL d’instance → connecteur List environments as admin d’administration.
  • IsTranscriptAvailable (cat_IsTranscriptAvailable) : true lorsque les enregistrements existent pour l’agent dans conversationtranscript.