この記事は、Dataverse のエージェント詳細テーブルの権限のあるリファレンスです。これにより、Copilot Studio Kit の [エージェント インベントリ] ページが有効になります。 エージェントの詳細テーブル には、すべてのフィールド、Dataverse ソースまたは検出ルール、バージョン、ダウンストリーム コンシューマー向けの簡潔な説明が一覧表示されます。
聴衆
- 同期または検証ロジックを実装するプラットフォーム エンジニアとインテグレーター
- エージェント構成のトラブルシューティングを行うオペレーターとサポート チーム
- ダッシュボードとレポートのエージェントの詳細を使用するアナリストとレポート作成者
この記事の使用方法
- 正確な列名、データ型、およびソースにはスキーマ テーブルを使用します。
- 検出ロジックまたは検証テストを実装する場合は、派生規則を使用します。
- [バージョン ] 列は、フィールドの成熟度 (V1、V2) を示します。
用語
- 参照されるデータバース テーブルには、
bot、botcomponent、processes、およびconversationtranscriptが含まれます。 - "Topic v2" は、会話フローで使用されるプラットフォーム トピック スキーマを表します。
エージェントの詳細テーブル
次の表は、エージェント インベントリ ページの機能を提供する Agent Details Dataverse テーブルの詳細を示しています。
ヒント
読みやすくするには、[ テーブルの展開 ] を選択してテーブル全体を表示します。
| いいえ | 列名 | 列スキーマ名 | データの種類 | 情報源 | バージョン | Description |
|---|---|---|---|---|---|---|
| 1 | エージェント ID | cat_agentid | テキスト | Dataverse: テーブル bot → botid 列 |
V1 | エージェントのデータバース一意識別子 (botid)。 |
| 2 | 名前 | cat_name | テキスト | Dataverse: テーブル bot → name 列 |
V1 | エージェントの表示名。 |
| 3 | タイプ | cat_type | テキスト | カスタムとしてハードコーディングされた値 | V2 | エージェントの種類 (宣言型、カスタム型)。 |
| 4 | 環境名 | cat_environmentname | テキスト | Power Platform Admin コネクタ - List environments as admin 出力: friendlyNameを優先し、 displayName または properties.linkedEnvironmentMetadata.friendlyName |
V1 | エージェントがデプロイされている環境の表示名。 |
| 5 | 環境 ID | cat_environmentid | テキスト | Power Platform Admin コネクタ - List environments as admin 出力: name (インスタンス識別子) |
V1 | 環境の一意識別子 (インスタンス名)。 |
| 6 | 環境の種類 | cat_environmenttype | テキスト | Power Platform Admin コネクタ - List environments as admin 出力: properties.environmentSku |
V1 | 環境 SKU/種類 (運用、開発)。 |
| 7 | Description | cat_description | 複数行テキスト | Dataverse: テーブル botcomponent ( componenttypename = カスタム GPT (15) → description 列) |
V1 | エージェントの人間が判読できる説明。 |
| 八 | インストラクション | cat_Instructions | 複数行テキスト | Dataverse: Table botcomponent (Custom GPT) → YAML data column → 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: Table 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 ナレッジ、または生成オーケストレーションを使用している場合は true | V1 | エージェントがジェネレーティブ AI 機能を使用するかどうかを示します。 |
| 19 | オーケストレーションの種類 | cat_orchestrationtype | テキスト | Dataverse: テーブル bot → configuration JSON → GenerativeActionsEnabled (true →生成、それ以外の場合はクラシック) |
V1 | オーケストレーションの種類 (生成またはクラシック)。 |
| 20 | 自律エージェント | cat_AutonomousAgent | ブール値 | Dataverse: テーブル botcomponent → componenttypename = 外部トリガー (17) →プレゼンス = true |
V2 | True の 場合、エージェントに外部トリガー コンポーネント (自律) が含まれています。 |
| 21 (二十一) | 拡張検索結果を使用する | cat_usesenhancedsearchresults | ブール値 | Dataverse: テーブル bot → configuration JSON → isSemanticSearchEnabled (true → true) |
V1 | セマンティック検索または拡張検索が有効かどうかを示します。 |
| 22 | ツールを使用する | cat_usesactions | ブール値 | Dataverse: Table botcomponent (トピック v2) → data に含まれる TaskDialog → true |
V1 | True の 場合、エージェントは、ツール/アクション ノードを使用します。 |
| 23 | AI ナレッジを使用する | cat_usesaiknowledge | ブール値 | Dataverse: テーブル bot → configuration JSON → useModelKnowledge (true → true) |
V1 | エージェントが一般的な AI 知識の使用を許可されているかどうかを示します。 |
| 二十四 | ナレッジ ソースを使用する | cat_UsesKnowledgeSources | ブール値 | Dataverse: botcomponent = ボットの添付ファイルまたはナレッジ ソース→ componenttypename存在するテーブル data.KnowledgeSourceConfiguration→ true |
V1 | True の 場合は、ナレッジ ソースが構成されています。 |
| 二十五 | 従来の生成応答ソースを使用する | cat_UsesClassicGenerativeAnswersSources | ブール値 | Dataverse: Table botcomponent (トピック v2) → data 列のプロパティ searchAndSummarizeContent には、publicdatasource、sharePointSearchDataSource、customdatasource、azureopenaionyourdatasource → true |
V2 | クラシック生成応答ソースが構成されている場合は True。 |
| 26 | プロンプトを使用する | cat_usesaibuilderprompts | ブール値 | Dataverse: Table botcomponent (トピック v2) → data に含まれる InvokeAIBuilderModelAction → true |
V1 | True の 場合は、プロンプトが使用されます。 |
| 二十七 | MCP を使用する | cat_UsesMCP | ブール値 | Dataverse: Table botcomponent (トピック v2) → data に含まれる kind: InvokeExternalAgentTaskAction → true |
V2 | True の 場合モデル コンテキスト プロトコル (MCP) アクションが存在します。 |
| 28 | カスタマイズされた応答を使用する | cat_UsesCustomizedResponse | ブール値 | Dataverse: Table 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 ロジック (偽装 = {} または埋め込みランタイム ソース → maker;impersonation.source=invoker → invoker) |
V2 | 呼び出されたクラウド フローに、作成者または呼び出し者の認証コンテキストが必要かどうかを示します。 |
| 31 | End-User 認証の種類 | cat_enduserauthenticationtype | テキスト | Dataverse: テーブル bot → authenticationmode 列 |
V1 | エージェントのエンドユーザー認証モード。 |
| 32 | HTTP 要求を使用する | cat_useshttprequests | ブール値 | Dataverse: Table botcomponent (トピック v2) → data に含まれる HttpRequestAction → true |
V1 | True の 場合、エージェントが HTTP 要求アクションを発行します。 |
| 33 | スキルを使用する | cat_usesskills | ブール値 | Dataverse: Table botcomponent (トピック v2) → data に含まれる InvokeSkillAction → true |
V2 | True の 場合、エージェントがスキルを呼び出します。 |
| 34 | 知識源 | cat_knowledgesources | 複数行テキスト | Dataverse: botcomponent = Bot File Attachment -componenttypename> またはナレッジ ソースが→されているテーブル FileDataNamedata.KnowledgeSourceConfiguration |
V1 | 構成済みのナレッジ ソースの一覧 (未加工の構成)。 |
| 35 | クラシック データ ソース | cat_ClassicDataSources | 複数行テキスト | Dataverse: Table 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 | エージェントによって使用されるプロンプトの一覧。 |
| 三十八 | 接続 | 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) → datakind: AdaptiveDialogで始まり、beginDialog.kind: OnKnowledgeRequested → true |
V2 | True の 場合は、カスタム アダプティブ ナレッジ要求ダイアログが存在します。 |
| 41 | ディープ 推論モデルを使用する | cat_UsesDeepReasoningModels | ブール値 | Dataverse: Table bot → configuration.optInUseLatestModels (true → true) |
V2 | True の 場合、エージェントは、最新または詳細な推論モデルをオプトインします。 |
| 42 | ファイル入力を使用する | cat_UsesFileInput | ブール値 | Dataverse: Table bot → configuration.isFileAnalysisEnabled (true → true) |
V2 | True の 場合、ファイル分析/入力が有効です。 |
| 43 | EnvironmentUrl | cat_EnvironmentUrl | テキスト | Power Platform Admin コネクタ - List environments as admin 出力: インスタンス URL |
V2 | 環境インスタンスの URL。 |
| 44 | IsTranscriptAvailable | cat_IsTranscriptAvailable | テキスト | Dataverse: conversationtranscript テーブル — プレゼンスは可用性を示します |
V2 | エージェントの会話トランスクリプトが存在するかどうかを示します。 |
フィールドの派生規則と検出ルール
次の検出規則は、各派生フィールドまたはブール型フィールドに適用されます。 スキーマ列名はかっこで囲んで示します。
- エージェント ID (
cat_agentid): Dataversebot.botid。 - 名前 (
cat_name): Dataversebot.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):botcomponentcomponenttypename= カスタム 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): 発行されたタイムスタンプbot含まれている場合は true。 - 発行日 (
cat_publisheddate): タイムスタンプbot.published。 - 発行者 (
cat_publishedby):bot.publishedby。 - 既定のアプリケーション ID (
cat_defaultapplicationid): JSON →bot.synchronizationstatusapplicationId。 - Gen AI を使用する (
cat_usesgenai): エージェントがツール/アクション、プロンプト、ナレッジ ソース、MCP、カスタマイズされた応答、従来の生成ソース、AI ナレッジ、または生成オーケストレーションを有効にしている場合は true。 - オーケストレーションの種類 (
cat_orchestrationtype): 他bot.configuration.GenerativeActionsEnabled→generativeclassic。 - 自律エージェント (
cat_AutonomousAgent):botcomponent.componenttypename= 外部トリガー (17) が存在する場合は true。 - 拡張検索結果 (
cat_usesenhancedsearchresults):bot.configuration.isSemanticSearchEnabled= true を使用します。 - ツール (
cat_usesactions): トピック v2botcomponent.dataにはTaskDialogエントリが含まれています。 - AI ナレッジ (
cat_usesaiknowledge):bot.configuration.useModelKnowledge= true を使用します。 - ナレッジ ソース (
cat_UsesKnowledgeSources) を使用します。KnowledgeSourcesbotcomponentエントリ (data.KnowledgeSourceConfigurationまたは Bot File Attachment エントリ) が存在します。 - クラシック生成応答ソースを使用します (
cat_UsesClassicGenerativeAnswersSources): トピック v2data.searchAndSummarizeContentには、クラシック ソースの種類 (publicdatasource、sharePointSearchDataSource、customdatasource、azureopenaionyourdatasource) が含まれています。 - プロンプト (
cat_usesaibuilderprompts): トピック v2dataにInvokeAIBuilderModelActionが含まれています。 - MCP (
cat_UsesMCP): トピック v2dataにkind: InvokeExternalAgentTaskActionが含まれています。 - カスタマイズされた応答 (
cat_UsesCustomizedResponse) を使用します。トピック v2dataにはkind: AnswerQuestionWithAIが含まれています。 - Connector Maker 認証コンテキスト (
cat_UsesConnectorMakerAuthContext): 任意のbotcomponent.data.connectionProperties.mode=makerを使用します。 - Cloud Flow 認証コンテキスト (
cat_UsesCloudFlowAuthContext) を使用します。processes.clientdata.connectionreferencesおよびimpersonationルール (偽装 =runtimesourceまたは埋め込みランタイム ソース → maker;impersonation.source = invoker → invoker) を使用して{}から派生します。 - End-User 認証の種類 (
cat_enduserauthenticationtype):bot.authenticationmode。 - HTTP 要求 (
cat_useshttprequests) を使用します。トピック v2dataにはHttpRequestActionエントリが含まれています。 - Skills (
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.modeとprocesses.clientdata.connectionreferences(API 名、偽装、ランタイム ソース) から集計します。 - エージェント トリガー (
cat_AgentTriggers):botcomponent= 外部トリガー (17) →componenttypename行を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):conversationtranscript内のエージェントのレコードが存在する場合は true。