本文是 Dataverse 中專員詳細資料表的權威參考,可為 Copilot Studio Kit 中的專員清查頁面提供支援。 客服專員詳細資料表 會列出每個欄位、Dataverse 來源或偵測規則、版本,以及下游取用者的簡明描述。
觀眾
- 實作同步或驗證邏輯的平台工程師和整合商
- 操作員和支援團隊對代理程式設定進行疑難排解
- 分析師和報告作者使用儀表板和報告的客服專員詳細資料
如何使用本文
- 使用結構描述表格取得確切的欄名稱、資料類型和來源。
- 在實作偵測邏輯或驗證測試時,請使用衍生規則。
- 版本直 欄指出欄位成熟度 (V1、V2)。
術語
- 參考的 Dataverse 資料表包括
bot、 、botcomponentprocesses和conversationtranscript。 - 「主題 v2」表示交談流程中使用的平台主題結構描述。
客服專員詳細資料表
下表提供有關專員詳細資料 Dataverse 資料表的詳細資訊,該資料表為 專員清查 頁面提供支援。
小提示
為了提高可讀性,請選取 [展開表格] 以檢視整個表格。
| 否 | 欄位名稱 | 資料行結構描述名稱 | 數據類型 | 來源 | 版本 | Description |
|---|---|---|---|---|---|---|
| 1 | 客服專員 ID | cat_agentid | 文字 | Dataverse:資料表 bot → botid 欄 |
V1 | 代理程式的 Dataverse 唯一識別碼 (botid)。 |
| 2 | 名稱 | cat_name | 文字 | Dataverse:資料表 bot → name 欄 |
V1 | 客服專員的顯示名稱。 |
| 3 | 類型 | cat_type | 文字 | 硬式編碼值為自訂 | V2 | 代理程式類型 (宣告式、自訂)。 |
| 4 | 環境名稱 | cat_environmentname | 文字 | Power Platform 管理員連接器 —List environments as admin 輸出:prefer friendlyName、 fallback to displayName 或 properties.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:資料表 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 | 如果專員有發佈日期,則為 True。 |
| 15 | 發佈日期 | cat_publisheddate | DateTime | Dataverse:資料表 bot → published (發佈日期) 欄 |
V1 | 發佈代理程式的時間戳記。 |
| 16 | 發行人 | cat_publishedby | 文字 | Dataverse:資料表 bot → publishedby 欄 |
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:表 botcomponent → componenttypename = 外部觸發程序 (17) → 目前狀態 = true |
V2 | 如果代理程式包含外部觸發元件 (自主) ,則為 True。 |
| 21 | 使用增強的搜尋結果 | cat_usesenhancedsearchresults | 布林值 | Dataverse:JSON → bot →configuration資料表 isSemanticSearchEnabled (true → true) |
V1 | 指出是否啟用語意/增強搜尋。 |
| 22 | 使用工具 | cat_usesactions | 布林值 | Dataverse:資料表 botcomponent (主題 v2) → data 包含 TaskDialog → true |
V1 | 如果代理程式使用工具/動作節點,則為 True。 |
| 23 | 運用 AI 知識 | cat_usesaiknowledge | 布林值 | Dataverse:JSON → bot →configuration資料表 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.data → connectionProperties.mode = maker → true |
V2 | 如果任何連接器設定為在製作者驗證模式中執行,則為 True。 |
| 30 | 使用雲端流程驗證內容 | cat_UsesCloudFlowAuthContext | 布林值 | Dataverse:資料表 processes →clientdata.connectionreferences + impersonation/runtimesource 邏輯 (模擬 = {} 或內嵌的執行階段來源 → 製作者;impersonation.source=調用者→呼叫者) |
V2 | 指出叫用的雲端流程是否需要製作者或呼叫者驗證內容。 |
| 31 | End-User 驗證類型 | cat_enduserauthenticationtype | 文字 | Dataverse:資料表 bot → authenticationmode 欄 |
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:表格 botcomponent → componenttypename = 外部觸發程序 (17) → data.triggerConnectionType |
V2 | 代理程式使用的觸發連接器清單。 |
| 40 | 使用自訂知識來源 | cat_UsesCustomKnowledgesSources | 布林值 | Dataverse:資料表 botcomponent (主題 v2) → data 開頭 kind: AdaptiveDialog 為 且 beginDialog.kind: OnKnowledgeRequested → true |
V2 | 如果存在自訂調適性知識請求對話方塊,則為 True。 |
| 41 | 使用深度推理模型 | cat_UsesDeepReasoningModels | 布林值 | Dataverse:資料表 bot → configuration.optInUseLatestModels (true → true) |
V2 | 如果代理選擇使用最新/更深入的推理模型,則為 true。 |
| 42 | 使用檔案輸入 | cat_UsesFileInput | 布林值 | Dataverse:資料表 bot → configuration.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_agentidDataversebot.botid。 - 名稱 ():
cat_nameDataversebot.name。 - 類型 ():
cat_type硬式編碼值Custom(V2)。 - 環境名稱 (
cat_environmentname):Power Platform 管理員連接器List environments as admin— 偏好friendlyName、後援至displayName或properties.linkedEnvironmentMetadata.friendlyName。 - 環境識別碼 (
cat_environmentid):管理員聯結器name(執行個體識別碼)。 - 環境類型 (
cat_environmenttype):admin connectorproperties.environmentSku。 - 描述 (
cat_description):botcomponent其中componenttypename= 自訂 GPT (15) →description。 - 說明(
cat_Instructions):botcomponent(自訂GPT)→YAMLdata.instructions。 - 客服專員建立日期 (
cat_agentcreateddate):bot.createdon。 - 代理修改日期 (
cat_agentmodifieddate):bot.modifiedon. - 代理程式建立者 (
cat_agentcreatedby):bot.createdby。 - 代理程式修改者 (
cat_agentmodifiedby):bot.modifiedby。 - 受控狀態 (
cat_managedstate):bot.ismanaged(受控與非受控)。 - 已發佈 ():
cat_published當包含已發佈的時間戳記時為bottrue。 - 發佈日期 ():
cat_publisheddatebot.published時間戳記。 - 出版商 (
cat_publishedby):bot.publishedby. - 預設應用程式 ID (
cat_defaultapplicationid):bot.synchronizationstatusJSON →applicationId。 - 使用生成式 AI (
cat_usesgenai):如果客服專員使用任何工具/動作、提示、知識來源、MCP、自訂回應、傳統生成來源、AI 知識,或已啟用生成式協調流程,則為 true。 - 協調流程類型 (
cat_orchestrationtype):bot.configuration.GenerativeActionsEnabled→generativeelseclassic。 - 自主代理程式 (
cat_AutonomousAgent):當 = 外部觸發程式 (17) 存在時botcomponent.componenttypename為 true。 - 使用增強型搜尋結果 (
cat_usesenhancedsearchresults):bot.configuration.isSemanticSearchEnabled= true。 - 使用工具 (
cat_usesactions):主題 v2botcomponent.data包含TaskDialog項目。 - 使用 AI 知識 (
cat_usesaiknowledge):bot.configuration.useModelKnowledge= true。 - 使用知識來源 (
cat_UsesKnowledgeSources):存在 KnowledgeSourcesbotcomponent項目 (data.KnowledgeSourceConfiguration或機器人檔案附件項目)。 - 使用傳統生成式答案來源 ():
cat_UsesClassicGenerativeAnswersSources主題 v2data.searchAndSummarizeContent包含傳統來源類型 (publicdatasource、sharePointSearchDataSource、customdatasource、azureopenaionyourdatasource)。 - 使用提示 (
cat_usesaibuilderprompts):主題 v2data包含InvokeAIBuilderModelAction。 - 使用 MCP (
cat_UsesMCP):主題 v2data包含kind: InvokeExternalAgentTaskAction. - 使用自訂回應 (
cat_UsesCustomizedResponse):主題 v2data包含kind: AnswerQuestionWithAI. - 使用連接器製作者驗證內容 (
cat_UsesConnectorMakerAuthContext):anybotcomponent.data.connectionProperties.mode=maker。 - 使用雲端流程驗證內容 (
cat_UsesCloudFlowAuthContext):衍生自processes.clientdata.connectionreferencesusingimpersonation和runtimesourcerules (impersonation = {} 或內嵌 runtimesource → maker;impersonation.source = invoker → invoker)。 - End-User 驗證類型 (
cat_enduserauthenticationtype):bot.authenticationmode。 - 使用 HTTP 要求 (
cat_useshttprequests):主題 v2data包含HttpRequestAction項目。 - 使用技能 (
cat_usesskills):主題 v2data包含InvokeSkillAction條目。 - 知識來源(
cat_knowledgesources):原始data.KnowledgeSourceConfiguration來源botcomponent(多行JSON/YAML)。 - 傳統資料來源 (
cat_ClassicDataSources):彙總的主題 v2data.searchAndSummarizeContent傳統項目。 - Http 要求動作 (
cat_httprequestactions):主題 v2data→HttpRequestAction組態。 - 提示 ():
cat_aibuilderpromts主題 v2data→InvokeAIBuilderModelAction組態。 - 連線 (
cat_Connections):彙總botcomponent.data.connectionreference+connectionProperties.modeprocesses.clientdata.connectionreferences和 (API 名稱、模擬、執行時來源) 以衍生連線名稱和驗證模式 (製作者/調用者)。 - 代理程式觸發器 (
cat_AgentTriggers): 列 其中botcomponent= 外部觸發器 (17) →componenttypenamedata.triggerConnectionType。 - 使用資訊:從授權 API 端點收集,以取得權利和耗用量報告。
- 使用自訂知識來源 (
cat_UsesCustomKnowledgesSources):主題 v2data以kind: AdaptiveDialog和beginDialog.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記錄存在時為 。