代理清单数据源

本文是 Dataverse 中代理详细信息表的权威参考，该表为 Copilot Studio Kit 中的“代理清单”页提供支持。 代理详细信息表 列出了每个字段、Dataverse 源或检测规则、版本和下游使用者的简明说明。

观众

  • 实现同步或验证逻辑的平台工程师和集成商
  • 操作员和支持团队对代理配置进行故障排除
  • 分析师和报表作者使用仪表板和报表的代理详细信息

如何使用本文

  • 将架构表用于确切的列名、数据类型和源。
  • 实现检测逻辑或验证测试时，请使用派生规则。
  • 版本 列指示字段成熟度（V1、V2）。

术语

  • 引用的 Dataverse 表包括bot、botcomponent和 processesconversationtranscript。
  • “Topic v2”表示对话流中使用的平台主题架构。

代理详细信息表

下表提供有关代理详细信息 Dataverse 表的详细信息，该表为 代理清单 页提供支持。

提示

为了提高可读性，请选择 “展开表 ”以查看整个表。

No 列名称 列架构名称 数据类型 来源 版本 Description
1 代理标识 cat_agentid 文本 Dataverse：表 bot → botid 列 V1 代理（botid）的 Dataverse 唯一标识符。
2 Name cat_name 文本 Dataverse：表 bot → name 列 V1 代理的显示名称。
3 类型 cat_type 文本 硬编码值作为自定义 V2 代理类型（声明性、自定义）。
4 环境名称 cat_environmentname 文本 Power Platform 管理连接器 —List environments as admin 输出：首选friendlyName、回退或displayNameproperties.linkedEnvironmentMetadata.friendlyName V1 部署代理的环境显示名称。
5 环境 ID cat_environmentid 文本 Power Platform Admin 连接器 —List environments as admin 输出： name （实例标识符） V1 环境的唯一标识符（实例名称）。
6 环境类型 cat_environmenttype 文本 Power Platform 管理连接器 —List environments as admin 输出： properties.environmentSku V1 环境 SKU/类型（生产、开发）。
7 Description cat_description 多行文本 Dataverse：表 botcomponent = componenttypename 自定义 GPT （15） → description 列 V1 代理的可读说明。
8 说明 cat_Instructions 多行文本 Dataverse：表 botcomponent （自定义 GPT）→ YAML data 列→ instructions 属性 V1 代理的面向管理员的说明或使用指南。
9 代理创建日期 cat_agentcreateddate DateTime Dataverse：表 bot → createdon 列 V1 代理的创建时间戳。
10 代理修改日期 cat_agentmodifieddate DateTime Dataverse：表 bot → modifiedon 列 V1 代理的上次修改时间戳。
11 代理创建者 cat_agentcreatedby 文本 Dataverse：表 bot → createdby 列 V1 创建代理的用户。
12 代理修改者 cat_agentmodifiedby 文本 Dataverse：表 bot → modifiedby 列 V1 上次修改代理的用户。
13 托管状态 cat_managedstate 文本 Dataverse：表 bot → ismanaged 列 V1 指示代理是托管代理还是非托管代理。
14 已发布 cat_published 布尔 Dataverse：表 bot →发布日期→ true V1 如此 如果代理有发布日期。
15 发布日期 cat_publisheddate DateTime Dataverse：表 bot → published （发布日期）列 V1 发布代理时的时间戳。
16 发布者 cat_publishedby 文本 Dataverse：表 bot → publishedby 列 V2 发布代理的用户。
17 默认应用程序 ID cat_defaultapplicationid 文本 Dataverse：表 bot → synchronizationstatus JSON → applicationId 属性 V1 与代理关联的默认应用程序 ID。
18 使用 Gen AI cat_usesgenai 布尔 派生：如此 如果代理使用任何作、提示、知识源、MCP、自定义响应、经典生成源、AI 知识或具有生成业务流程 V1 指示代理是否使用生成 AI 功能。
19 业务流程类型 cat_orchestrationtype 文本 Dataverse：表 bot → configuration JSON →（真实→ GenerativeActionsEnabled 生成;否则为经典） V1 业务流程类型（生成或经典）。
20 自治代理 cat_AutonomousAgent 布尔 Dataverse：表 botcomponent → componenttypename = 外部触发器 （17） →状态 = true V2 如此 如果代理包含外部触发器组件（自治）。
21 使用增强型搜索结果 cat_usesenhancedsearchresults 布尔 Dataverse：表 bot → configuration JSON → isSemanticSearchEnabled （true → true） V1 指示是否启用语义/增强搜索。
22 使用工具 cat_usesactions 布尔 Dataverse：表 botcomponent （主题 v2）→ data 包含 TaskDialog true → V1 如此 如果代理使用工具/作节点。
23 使用 AI 知识 cat_usesaiknowledge 布尔 Dataverse：表 bot → configuration JSON → useModelKnowledge （true → true） V1 指示是否允许代理使用常规 AI 知识。
24 使用知识源 cat_UsesKnowledgeSources 布尔 Dataverse：表 botcomponent = componenttypename 机器人文件附件或知识源→ data.KnowledgeSourceConfiguration 存在→ true V1 如果配置了任何知识源，则为 True。
25 使用经典生成答案源 cat_UsesClassicGenerativeAnswersSources 布尔 Dataverse：表 botcomponent （主题 v2）→列中 data ，属性 searchAndSummarizeContent 包含任何经典源：publicdatasource、sharePointSearchDataSource、customdatasource 和 azureopenaionyourdatasource → true V2 如此 如果配置了经典生成答案源。
26 使用提示 cat_usesaibuilderprompts 布尔 Dataverse：表 botcomponent （主题 v2）→ data 包含 InvokeAIBuilderModelAction true → V1 如果使用提示，则为 True。
二十七 使用 MCP cat_UsesMCP 布尔 Dataverse：表 botcomponent （主题 v2）→ data 包含 kind: InvokeExternalAgentTaskAction true → V2 如此 如果存在模型上下文协议 （MCP）作。
28 使用自定义响应 cat_UsesCustomizedResponse 布尔 Dataverse：表 botcomponent （主题 v2）→ data 包含 kind: AnswerQuestionWithAI true → V2 如此 如果存在自定义响应节点。
二十九 使用连接器 Maker 身份验证上下文 cat_UsesConnectorMakerAuthContext 布尔 Dataverse： botcomponent.data → connectionProperties.mode = maker → true V2 如此 如果任何连接器配置为在创建者身份验证模式下运行。
30 使用云流身份验证上下文 cat_UsesCloudFlowAuthContext 布尔 Dataverse：表processes→clientdata.connectionreferences + impersonation/runtimesource逻辑（模拟 = {} 或嵌入式运行时源→ maker;impersonation.source=invoker →调用程序） V2 指示调用的云流是否需要创建者或调用方身份验证上下文。
31 End-User 身份验证类型 cat_enduserauthenticationtype 文本 Dataverse：表 bot → authenticationmode 列 V1 代理的最终用户身份验证模式。
32 使用 HTTP 请求 cat_useshttprequests 布尔 Dataverse：表 botcomponent （主题 v2）→ data 包含 HttpRequestAction true → V1 如此 如果代理发出 HTTP 请求作。
33 使用技能 cat_usesskills 布尔 Dataverse：表 botcomponent （主题 v2）→ data 包含 InvokeSkillAction true → V2 如此 如果代理调用技能。
34 知识源 cat_knowledgesources 多行文本 Dataverse：表 botcomponent = componenttypename 机器人文件附件 ->FileDataName 或知识源→ data.KnowledgeSourceConfiguration V1 已配置的知识源列表（原始配置）。
35 经典数据源 cat_ClassicDataSources 多行文本 Dataverse：表 botcomponent （主题 v2）→列中 data ，该属性 searchAndSummarizeContent 包含任何经典源：publicdatasource、sharePointSearchDataSource、customdatasource 和 azureopenaionyourdatasource V2 代理引用的经典数据源列表。
36 Http 请求作 cat_httprequestactions 多行文本 Dataverse：表 botcomponent （主题 v2）→ data 包含 HttpRequestAction 条目 V1 配置的 HTTP 请求作的列表。
37 提示语 cat_aibuilderprompts 多行文本 Dataverse：表 botcomponent （主题 v2）→ data 包含 InvokeAIBuilderModelAction 条目 V1 代理使用的提示列表。
38 连接 cat_Connections 多行文本 代理连接： botcomponent.data.connectionreference + connectionProperties.mode;流连接： processes.clientdata.connectionreferences （api 名称、模拟、运行时源）- 派生连接名称和身份验证模式（创建者或调用方） V2 连接器/流连接名称和推断的身份验证模式（maker/invoker）。
39 代理触发器 cat_AgentTriggers 多行文本 Dataverse：表 botcomponent → componenttypename = 外部触发器 （17） → data.triggerConnectionType V2 代理使用的触发器连接器列表。
40 使用自定义知识源 cat_UsesCustomKnowledgesSources 布尔 Dataverse：表 botcomponent （主题 v2）→ data 以 kind: AdaptiveDialog true 开头并 beginDialog.kind: OnKnowledgeRequested → true V2 如此 如果存在自定义自适应知识请求对话框。
41 使用深层推理模型 cat_UsesDeepReasoningModels 布尔 Dataverse：表 bot → configuration.optInUseLatestModels （true → true） V2 如此 如果代理选择使用最新/更深层次的推理模型。
42 使用文件输入 cat_UsesFileInput 布尔 Dataverse：表 bot → configuration.isFileAnalysisEnabled （true → true） V2 如此 如果启用了文件分析/输入。
43 环境URL cat_EnvironmentUrl 文本 Power Platform Admin 连接器 —List environments as admin 输出：实例 URL V2 环境实例 URL。
44 IsTranscriptAvailable cat_IsTranscriptAvailable 文本 Dataverse： conversationtranscript 表 - 状态指示可用性 V2 指示代理是否存在对话脚本。

字段派生和检测规则

以下检测规则适用于每个派生字段或布尔字段。 架构列名称以括号表示。

  • 代理 ID （cat_agentid）： Dataverse bot.botid。
  • 名称 （cat_name）： Dataverse bot.name。
  • 类型 （cat_type）： 硬编码值 Custom （V2）。
  • 环境名称 （cat_environmentname）： Power Platform Admin 连接器 List environments as admin- 首选 friendlyName、回退 displayName 或 properties.linkedEnvironmentMetadata.friendlyName。
  • 环境 ID （cat_environmentid）： 管理连接器 name （实例标识符）。
  • 环境类型 （cat_environmenttype）： 管理连接器 properties.environmentSku。
  • 说明 （cat_description）： botcomponent where componenttypename = Custom GPT （15） → description.
  • 说明（cat_Instructions）： botcomponent （自定义 GPT） → YAML data.instructions。
  • 代理创建日期 （cat_agentcreateddate）： bot.createdon。
  • 代理修改日期 （cat_agentmodifieddate）： bot.modifiedon
  • 代理由 （cat_agentcreatedby）： bot.createdby
  • 代理修改者（cat_agentmodifiedby）： bot.modifiedby
  • 托管状态（cat_managedstate）： bot.ismanaged （托管状态和非托管状态）。
  • 已发布（cat_published）：当包含已发布时间戳时 bot 为 true。
  • 发布日期（cat_publisheddate）： bot.published 时间戳。
  • 作者：.cat_publishedbybot.publishedby.
  • 默认应用程序 ID （cat_defaultapplicationid）： bot.synchronizationstatus JSON → applicationId。
  • 使用 Gen AI（cat_usesgenai）：如果代理使用任何工具/作、提示、知识源、MCP、自定义响应、经典生成源、AI 知识或已启用生成业务流程，则为 true。
  • 业务流程类型（cat_orchestrationtype）： bot.configuration.GenerativeActionsEnabled →generative。classic
  • 自治代理 （cat_AutonomousAgent）： 当 = 外部触发器 （17） 存在时 botcomponent.componenttypename 为 true。
  • 使用增强型搜索结果（cat_usesenhancedsearchresults）： bot.configuration.isSemanticSearchEnabled = true。
  • 使用工具（cat_usesactions）：主题 v2 botcomponent.data 包含 TaskDialog 条目。
  • 使用 AI 知识 （cat_usesaiknowledge）： bot.configuration.useModelKnowledge = true。
  • 使用知识源（cat_UsesKnowledgeSources）：存在 KnowledgeSources botcomponent 条目（data.KnowledgeSourceConfiguration 或机器人文件附件条目）。
  • 使用经典生成答案源（cat_UsesClassicGenerativeAnswersSources）：主题 v2 data.searchAndSummarizeContent 包括经典源类型（publicdatasource、sharePointSearchDataSource、customdatasource、azureopenaionyourdatasource）。
  • 使用提示 （cat_usesaibuilderprompts）： 主题 v2 data 包含 InvokeAIBuilderModelAction。
  • 使用 MCP （cat_UsesMCP）： 主题 v2 data 包含 kind: InvokeExternalAgentTaskAction。
  • 使用自定义响应 （cat_UsesCustomizedResponse）： 主题 v2 data 包含 kind: AnswerQuestionWithAI。
  • 使用连接器 Maker 身份验证上下文（cat_UsesConnectorMakerAuthContext）：任何botcomponent.data.connectionProperties.mode = maker 。
  • 使用 Cloud Flow 身份验证上下文（cat_UsesCloudFlowAuthContext）：派生自 processes.clientdata.connectionreferences using impersonation 和 runtimesource 规则（模拟 = {} 或嵌入式运行时源→ maker;impersonation.source = invoker → invoker）。
  • End-User 身份验证类型 （cat_enduserauthenticationtype）： bot.authenticationmode。
  • 使用 HTTP 请求（cat_useshttprequests）：主题 v2 data 包含 HttpRequestAction 条目。
  • 使用技能（cat_usesskills）：主题 v2 data 包含 InvokeSkillAction 条目。
  • 知识来源（cat_knowledgesources）：原始 data.KnowledgeSourceConfiguration 来源 botcomponent （多行 JSON/YAML）。
  • 经典数据源（cat_ClassicDataSources）：聚合的主题 v2 data.searchAndSummarizeContent 经典条目。
  • Http 请求作（cat_httprequestactions）：主题 v2 data → HttpRequestAction 配置。
  • 提示（cat_aibuilderpromts）：主题 v2 data → InvokeAIBuilderModelAction 配置。
  • 连接（cat_Connections）：从botcomponent.data.connectionreference + connectionProperties.mode和processes.clientdata.connectionreferences（api 名称、模拟、运行时源）聚合以派生连接名称和身份验证模式（maker/invoker）。
  • 代理触发器（cat_AgentTriggers）： botcomponent 其中 componenttypename = 外部触发器 （17） → data.triggerConnectionType的行。
  • 使用情况信息：从授权 API 终结点收集的权利和使用情况报告。
  • 使用自定义知识源（cat_UsesCustomKnowledgesSources）：主题 v2 data 以 kind: AdaptiveDialog 和 beginDialog.kind: OnKnowledgeRequested.
  • 使用深度推理模型 （cat_UsesDeepReasoningModels）： bot.configuration.optInUseLatestModels = true。
  • 使用文件输入 （cat_UsesFileInput）： bot.configuration.isFileAnalysisEnabled = true。
  • EnvironmentUrl （cat_EnvironmentUrl）： 管理连接器 List environments as admin →实例 URL。
  • IsTranscriptAvailable （cat_IsTranscriptAvailable）：如果代理存在记录，则为 conversationtranscripttrue。
  • Last updated on