重要
/beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。
copilotPackage から継承し、Copilot パッケージに関する包括的な詳細情報を提供する拡張エンティティ。
重要
パッケージ管理 API にアクセスするには、Microsoft Agent 365 ライセンスが必要です。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List |
copilotPackageDetail コレクション |
利用可能な Copilot パッケージを取得します。 |
| Get | copilotPackageDetail |
copilotPackageDetail オブジェクトのプロパティとリレーションシップを読み取ります。 |
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List |
copilotPackageDetail コレクション |
利用可能な Copilot パッケージを取得します。 |
| Get | copilotPackageDetail |
copilotPackageDetail オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | copilotPackageDetail |
copilotPackageDetail オブジェクトを更新します。 |
| Block | なし | Copilot パッケージをブロックして使用を防止します。 |
| 再割り当て | なし | Copilot パッケージの所有権を別のユーザーに再割り当てします。 |
| ブロックを解除 | なし | Copilot パッケージのブロックを解除して使用を許可します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
activeUsers |
Int32 | 過去 30 日間のアクティブ ユーザーの数。 |
acquireUsersAndGroups |
packageAccessEntity コレクション | テナント内で使用するためにこのパッケージを取得またはインストールしたユーザーとグループのコレクション。 |
agentIdentityId |
文字列 | エージェントの Microsoft Entra エージェント ID。 copilotPackage から継承されます。 |
allowedUsersAndGroups |
packageAccessEntity コレクション | テナント内でこのパッケージへのアクセスと使用が現在許可されているユーザーとグループのコレクション。 |
appId |
文字列 | このパッケージに関連付けられている Azure AD アプリケーション登録 ID。 copilotPackage から継承されます。 |
assetId |
文字列 | アセット ストアでこのパッケージを参照するために使用される識別子。 copilotPackage から継承されます。 |
availableTo |
packageAllowStatus | このパッケージにアクセスできるテナント内のユーザーまたはグループを指定する列挙値。 copilotPackage から継承されます。 |
categories |
String collection | 機能またはドメイン (Development、Productivity など) によってパッケージを分類するカテゴリ タグのコレクション。 |
createdDateTime |
DateTimeOffset | エージェント パッケージが作成された日時。 copilotPackage から継承されます。 |
deployedTo |
packageAcquireStatus | パッケージの現在の展開スコープを示す列挙値。 copilotPackage から継承されます。 |
displayName |
文字列 | ユーザーと管理者に表示される人間が判読できるパッケージの名前。 copilotPackage から継承されます。 |
elementDetails |
packageElementDetail コレクション | パッケージに含まれる各要素に関する詳細情報 (種類や構成など) のコレクション。 |
elementTypes |
String collection | このパッケージに含まれている要素型のコレクション。 copilotPackage から継承されます。 |
exceptionRate |
倍精度浮動小数点数 | 過去 30 日間にエージェントが検出した例外の数。 |
governanceMetadata |
文字列 | エージェントのエージェント分類。 指定可能な値は、 PromptAgent、 HostedAgent、 WorkflowAgent、 ManagedAgent、 Unmanaged、 AIApp です。 copilotPackage から継承されます。 |
id |
文字列 | テナント内の Copilot パッケージの一意の識別子。 copilotPackage から継承されます。 |
isBlocked |
ブール型 | パッケージが管理上ブロックされているかどうかを示すブール値フラグ。 copilotPackage から継承されます。 |
lastModifiedDateTime |
DateTimeOffset | パッケージに対して行われた最後の変更のタイムスタンプ。 copilotPackage から継承されます。 |
lastUsedDateTime |
DateTimeOffset | エージェントが最後に使用された日時。 |
longDescription |
文字列 | パッケージの機能、特徴、使用状況に関する詳細情報を提供する包括的な説明。 |
manifestId |
文字列 | パッケージ マニフェストで宣言されている一意の識別子。 作成後に更新することはできません。 copilotPackage から継承されます。 |
manifestVersion |
文字列 | このパッケージの定義に使用されるマニフェスト スキーマのバージョン。 更新できません。 copilotPackage から継承されます。 |
platform |
文字列 | このパッケージの対象となるホスト プラットフォーム (Teams、Outlook、Web など)。 copilotPackage から継承されます。 |
publisher |
文字列 | このパッケージを発行した organization または entity の名前。 copilotPackage から継承されます。 |
requestStatus |
copilotPackageRequestStatus | Null 許容型。 このパッケージに関連付けられている要求の状態。 リスト パッケージで eq を使用した$filterをサポートします。 copilotPackage から継承されます。 |
requestType |
copilotPackageRequestType | Null 許容型。 このパッケージに関連付けられている要求の種類。 リスト パッケージで eq を使用した$filterをサポートします。 copilotPackage から継承されます。 |
sensitivity |
文字列 | パッケージのデータ処理要件またはコンプライアンス制限を示す秘密度分類レベル。 |
sharedWithUsersAndGroups |
packageAccessEntity コレクション | エージェントが共有されているユーザーとグループのコレクション。 |
shortDescription |
文字列 | パッケージの機能の概要を説明する簡単な説明。 copilotPackage から継承されます。 |
supportedHosts |
String collection | このパッケージを使用できるホスト アプリケーションのコレクション。 copilotPackage から継承されます。 |
totalRunTimeInHours |
倍精度浮動小数点数 | 過去 30 日間のエージェントの合計実行時間 (時間単位)。 |
totalSessions |
Int32 | 過去 30 日間のエージェントのセッション数。 |
type |
packageType | パッケージのタイプ分類。 copilotPackage から継承されます。 |
version |
文字列 | パッケージのバージョン文字列 (例: 1.2.3)。 作成後に更新することはできません。 copilotPackage から継承されます。 |
zipFile |
Stream | Copilot パッケージ ファイル。 copilotPackage から継承されます。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.copilotPackageDetail",
"activeUsers": "Int32",
"acquireUsersAndGroups": [
{
"@odata.type": "microsoft.graph.packageAccessEntity"
}
],
"agentIdentityId": "String",
"allowedUsersAndGroups": [
{
"@odata.type": "microsoft.graph.packageAccessEntity"
}
],
"appId": "String",
"assetId": "String",
"availableTo": "String",
"categories": ["String"],
"createdDateTime": "DateTimeOffset",
"deployedTo": "String",
"displayName": "String",
"elementDetails": [
{
"@odata.type": "microsoft.graph.packageElementDetail"
}
],
"elementTypes": ["String"],
"exceptionRate": "Double",
"governanceMetadata": "String",
"id": "String",
"isBlocked": "Boolean",
"lastModifiedDateTime": "DateTimeOffset",
"lastUsedDateTime": "DateTimeOffset",
"longDescription": "String",
"manifestId": "String",
"manifestVersion": "String",
"platform": "String",
"publisher": "String",
"requestStatus": "String",
"requestType": "String",
"sensitivity": "String",
"sharedWithUsersAndGroups": [
{
"@odata.type": "microsoft.graph.packageAccessEntity"
}
],
"shortDescription": "String",
"supportedHosts": ["String"],
"totalRunTimeInHours": "Double",
"totalSessions": "Int32",
"type": "String",
"version": "String",
"zipFile": "Stream"
}