共用方式為


代理程式庫存資料來源

本文是 Dataverse 中專員詳細資料表的權威參考,可為 Copilot Studio Kit 中的專員清查頁面提供支援。 客服專員詳細資料表 會列出每個欄位、Dataverse 來源或偵測規則、版本,以及下游取用者的簡明描述。

觀眾

  • 實作同步或驗證邏輯的平台工程師和整合商
  • 操作員和支援團隊對代理程式設定進行疑難排解
  • 分析師和報告作者使用儀表板和報告的客服專員詳細資料

如何使用本文

  • 使用結構描述表格取得確切的欄名稱、資料類型和來源。
  • 在實作偵測邏輯或驗證測試時,請使用衍生規則。
  • 版本直 欄指出欄位成熟度 (V1、V2)。

術語

  • 參考的 Dataverse 資料表包括 bot、 、 botcomponentprocessesconversationtranscript
  • 「主題 v2」表示交談流程中使用的平台主題結構描述。

客服專員詳細資料表

下表提供有關專員詳細資料 Dataverse 資料表的詳細資訊,該資料表為 專員清查 頁面提供支援。

小提示

為了提高可讀性,請選取 [展開表格] 以檢視整個表格。

欄位名稱 資料行結構描述名稱 數據類型 來源 版本 Description
1 客服專員 ID cat_agentid 文字 Dataverse:資料表 botbotid V1 代理程式的 Dataverse 唯一識別碼 (botid)。
2 名稱 cat_name 文字 Dataverse:資料表 botname V1 客服專員的顯示名稱。
3 類型 cat_type 文字 硬式編碼值為自訂 V2 代理程式類型 (宣告式、自訂)。
4 環境名稱 cat_environmentname 文字 Power Platform 管理員連接器 —List environments as admin 輸出:prefer friendlyName、 fallback to displayNameproperties.linkedEnvironmentMetadata.friendlyName V1 部署代理程式的環境顯示名稱。
5 環境識別碼 cat_environmentid 文字 Power Platform 管理員連接器 —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:資料表 botcreatedon V1 代理程式的建立時間戳記。
10 客服專員修改日期 cat_agentmodifieddate DateTime Dataverse:資料表 botmodifiedon V1 代理程式的上次修改時間戳記。
11 代理程式建立者 cat_agentcreatedby 文字 Dataverse:資料表 botcreatedby V1 建立代理程式的使用者。
12 代理程式修改者 cat_agentmodifiedby 文字 Dataverse:資料表 botmodifiedby V1 上次修改代理程式的使用者。
13 受控狀態 cat_managedstate 文字 Dataverse:資料表 botismanaged V1 指出代理程式是受管理還是非受管理。
14 發布 cat_published 布林值 Dataverse:目前存在的表 bot →發佈日期→ true V1 如果專員有發佈日期,則為 True。
15 發佈日期 cat_publisheddate DateTime Dataverse:資料表 botpublished (發佈日期) 欄 V1 發佈代理程式的時間戳記。
16 發行人 cat_publishedby 文字 Dataverse:資料表 botpublishedby V2 發佈代理程式的使用者。
17 預設應用程式識別碼 cat_defaultapplicationid 文字 Dataverse:JSON →bot屬性→synchronizationstatus資料表applicationId V1 與代理程式相關聯的預設應用程式識別碼。
18 使用生成式 AI cat_usesgenai 布林值 衍生:如果客服專員使用任何動作、提示、知識來源、MCP、自訂回應、傳統生成來源、AI 知識或具有生成協調流程,則為 true V1 指出代理程式是否使用生成式 AI 功能。
19 協調流程類型 cat_orchestrationtype 文字 Dataverse:botJSON → configuration 表→ GenerativeActionsEnabled (true →生成式,否則為傳統) V1 協調流程類型 (生成式或傳統式)。
20 自主代理 cat_AutonomousAgent 布林值 Dataverse:表 botcomponentcomponenttypename = 外部觸發程序 (17) → 目前狀態 = true V2 如果代理程式包含外部觸發元件 (自主) ,則為 True。
21 使用增強的搜尋結果 cat_usesenhancedsearchresults 布林值 Dataverse:JSON → botconfiguration資料表 isSemanticSearchEnabled (true → true) V1 指出是否啟用語意/增強搜尋。
22 使用工具 cat_usesactions 布林值 Dataverse:資料表 botcomponent (主題 v2) → data 包含 TaskDialog → true V1 如果代理程式使用工具/動作節點,則為 True。
23 運用 AI 知識 cat_usesaiknowledge 布林值 Dataverse:JSON → botconfiguration資料表 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 如果已設定傳統生成式答案來源,則為 True。
26 使用提示 cat_usesaibuilderprompts 布林值 Dataverse:資料表 botcomponent (主題 v2) → data 包含 InvokeAIBuilderModelAction → true V1 如果使用提示,則為 True。
二十七 使用 MCP cat_UsesMCP 布林值 Dataverse:資料表 botcomponent (主題 v2) → data 包含 kind: InvokeExternalAgentTaskAction → true V2 如果存在模型內容通訊協定 (MCP) 動作,則為 true。
28 使用自訂回應 cat_UsesCustomizedResponse 布林值 Dataverse:資料表 botcomponent (主題 v2) → data 包含 kind: AnswerQuestionWithAI → true V2 如果存在自訂回應節點,則為 true。
二十九 使用連接器製作者驗證內容 cat_UsesConnectorMakerAuthContext 布林值 Dataverse: botcomponent.dataconnectionProperties.mode = maker → true V2 如果任何連接器設定為在製作者驗證模式中執行,則為 True。
30 使用雲端流程驗證內容 cat_UsesCloudFlowAuthContext 布林值 Dataverse:資料表 processesclientdata.connectionreferences + impersonation/runtimesource 邏輯 (模擬 = {} 或內嵌的執行階段來源 → 製作者;impersonation.source=調用者→呼叫者) V2 指出叫用的雲端流程是否需要製作者或呼叫者驗證內容。
31 End-User 驗證類型 cat_enduserauthenticationtype 文字 Dataverse:資料表 botauthenticationmode V1 代理程式的使用者驗證模式。
32 使用 HTTP 請求 cat_useshttprequests 布林值 Dataverse:資料表 botcomponent (主題 v2) → data 包含 HttpRequestAction → true V1 如果代理程式發出 HTTP 要求動作,則為 True。
33 使用技能 cat_usesskills 布林值 Dataverse:資料表 botcomponent (主題 v2) → data 包含 InvokeSkillAction → true V2 如果客服專員叫用技能,則為 true。
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) → dataHttpRequestAction V1 已設定的 HTTP 要求動作清單。
37 提示 cat_aibuilderprompts 多行文字 Dataverse:包含項目的資料表 botcomponent (主題 v2) → dataInvokeAIBuilderModelAction V1 代理程式使用的提示清單。
38 連結 cat_Connections 多行文字 代理程式連線: botcomponent.data.connectionreference + connectionProperties.mode;流程連線: processes.clientdata.connectionreferences (API 名稱、模擬、runtimesource) — 衍生連線名稱和驗證模式 (製作者或呼叫者) V2 連接器/流程連線名稱和推斷的驗證模式 (製作者/呼叫者)。
39 代理程式觸發器 cat_AgentTriggers 多行文字 Dataverse:表格 botcomponentcomponenttypename = 外部觸發程序 (17) → data.triggerConnectionType V2 代理程式使用的觸發連接器清單。
40 使用自訂知識來源 cat_UsesCustomKnowledgesSources 布林值 Dataverse:資料表 botcomponent (主題 v2) → data 開頭 kind: AdaptiveDialog 為 且 beginDialog.kind: OnKnowledgeRequested → true V2 如果存在自訂調適性知識請求對話方塊,則為 True。
41 使用深度推理模型 cat_UsesDeepReasoningModels 布林值 Dataverse:資料表 botconfiguration.optInUseLatestModels (true → true) V2 如果代理選擇使用最新/更深入的推理模型,則為 true。
42 使用檔案輸入 cat_UsesFileInput 布林值 Dataverse:資料表 botconfiguration.isFileAnalysisEnabled (true → true) V2 如果已啟用檔案分析/輸入,則為 True。
43 EnvironmentUrl cat_EnvironmentUrl 文字 Power Platform 管理員連接器 —List environments as admin 輸出:執行個體 URL V2 環境執行個體 URL。
44 是文字記錄可用 cat_IsTranscriptAvailable 文字 Dataverse: conversationtranscript 資料表 - 目前狀態表示可用性 V2 指出客服專員的對話文字記錄是否存在。

欄位衍生和偵測規則

下列偵測規則適用於每個衍生欄位或布林欄位。 結構描述資料行名稱會以括弧內表示。

  • 客服專員識別碼 ():cat_agentidDataverse bot.botid
  • 名稱 ():cat_nameDataverse bot.name
  • 類型 ():cat_type硬式編碼值 Custom (V2)。
  • 環境名稱 (cat_environmentname):Power Platform 管理員連接器 List environments as admin— 偏好 friendlyName、後援至 displayNameproperties.linkedEnvironmentMetadata.friendlyName
  • 環境識別碼 (cat_environmentid):管理員聯結器 name (執行個體識別碼)。
  • 環境類型 (cat_environmenttype):admin connector properties.environmentSku
  • 描述 (cat_description): botcomponent 其中 componenttypename = 自訂 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_publisheddatebot.published時間戳記。
  • 出版商 (cat_publishedby): bot.publishedby.
  • 預設應用程式 ID (cat_defaultapplicationid): bot.synchronizationstatus JSON → applicationId
  • 使用生成式 AI (cat_usesgenai):如果客服專員使用任何工具/動作、提示、知識來源、MCP、自訂回應、傳統生成來源、AI 知識,或已啟用生成式協調流程,則為 true。
  • 協調流程類型 (cat_orchestrationtype): bot.configuration.GenerativeActionsEnabledgenerative else 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.
  • 使用連接器製作者驗證內容 (cat_UsesConnectorMakerAuthContext):anybotcomponent.data.connectionProperties.mode = maker
  • 使用雲端流程驗證內容 (cat_UsesCloudFlowAuthContext):衍生自 processes.clientdata.connectionreferences using impersonationruntimesource rules (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 dataHttpRequestAction 組態。
  • 提示 ():cat_aibuilderpromts主題 v2 dataInvokeAIBuilderModelAction 組態。
  • 連線 (cat_Connections):彙總botcomponent.data.connectionreference + connectionProperties.modeprocesses.clientdata.connectionreferences 和 (API 名稱、模擬、執行時來源) 以衍生連線名稱和驗證模式 (製作者/調用者)。
  • 代理程式觸發器 (cat_AgentTriggers): 列 其中 botcomponent = 外部觸發器 (17) → componenttypenamedata.triggerConnectionType
  • 使用資訊:從授權 API 端點收集,以取得權利和耗用量報告。
  • 使用自訂知識來源 (cat_UsesCustomKnowledgesSources):主題 v2 datakind: AdaptiveDialogbeginDialog.kind: OnKnowledgeRequested開頭。
  • 使用深度推理模型 (cat_UsesDeepReasoningModels): bot.configuration.optInUseLatestModels = true。
  • 使用檔案輸入 (cat_UsesFileInput): bot.configuration.isFileAnalysisEnabled = true。
  • EnvironmentUrl ():cat_EnvironmentUrl執行個體 URL →管理連接器 List environments as admin
  • IsTranscriptAvailable (cat_IsTranscriptAvailable): 當代理程式的 conversationtranscript記錄存在時為 。