重要
/beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。
テナント内で使用可能な Copilot パッケージを表すエンティティ。パッケージ管理用の基本的なメタデータと構成情報が含まれています。
重要
パッケージ管理 API にアクセスするには、Microsoft Agent 365 ライセンスが必要です。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
agentIdentityId |
文字列 | エージェントの Microsoft Entra エージェント ID。 |
appId |
文字列 | このパッケージに関連付けられている Microsoft Entra AD アプリケーション登録 ID。 |
assetId |
文字列 | アセット ストアでこのパッケージを参照するために使用される識別子。 |
availableTo |
packageAllowStatus | このパッケージにアクセスできるテナント内のユーザーまたはグループを指定する列挙値 (allowedForAll、 allowedForSome、 allowedForNone)。 |
createdDateTime |
DateTimeOffset | エージェント パッケージが作成された日時。 |
deployedTo |
packageAcquireStatus | テナント内のパッケージの現在の展開範囲を示す列挙値 (acquiredForAll、 acquiredForSome、 acquiredForNone)。 |
displayName |
文字列 | ユーザーと管理者に表示される人間が判読できるパッケージの名前。 |
elementTypes |
String collection | このパッケージに含まれる要素の種類 ( bot、 declarativeAgent など) のコレクション。 |
governanceMetadata |
文字列 | エージェントのエージェント分類。 指定可能な値は、 PromptAgent、 HostedAgent、 WorkflowAgent、 ManagedAgent、 Unmanaged、 AIApp です。 |
id |
文字列 | テナント内の Copilot パッケージの一意の識別子。 |
isBlocked |
ブール型 | パッケージがテナント内での使用が管理的にブロックされているかどうかを示すブール値フラグ。 |
lastModifiedDateTime |
DateTimeOffset | パッケージ構成またはメタデータに対して行われた最後の変更のタイムスタンプ。 |
manifestId |
文字列 | パッケージ マニフェストで宣言されている一意の識別子。 作成後に更新することはできません。 |
manifestVersion |
文字列 | このパッケージの定義に使用されるマニフェスト スキーマのバージョン。 作成後に更新することはできません。 |
platform |
文字列 | このパッケージの対象となるホスト プラットフォーム ( teams、 outlook、 web など)。 eq を使用した$filterをサポートします。 |
publisher |
文字列 | このパッケージを発行した organization または entity の名前。 |
requestStatus |
copilotPackageRequestStatus | Null 許容型。 このパッケージに関連付けられている要求の状態。 リスト パッケージで eq を使用した$filterをサポートします。 |
requestType |
copilotPackageRequestType | Null 許容型。 このパッケージに関連付けられている要求の種類。 リスト パッケージで eq を使用した$filterをサポートします。 |
shortDescription |
文字列 | パッケージの機能と目的の概要を説明する簡単な説明。 |
supportedHosts |
String collection | このパッケージを使用できるホスト アプリケーションのコレクション ( teams、 outlook、 sharePoint など)。 |
type |
packageType | パッケージの種類の分類。ファースト パーティ、サード パーティ、共有、LOB のいずれであるかを示します。 |
version |
文字列 | パッケージのバージョン文字列 ( 1.2.3 など)。 作成後に更新することはできません。 |
zipFile |
Stream | Copilot パッケージ ファイル。 |
copilotPackageRequestStatus 列挙型
| 値 | 説明 |
|---|---|
pending |
要求は開いており、管理者が処理するのを待機しています。 |
approved |
管理者が要求を承認しました。 |
rejected |
管理者が要求を拒否しました。 |
unknownFutureValue |
進化可能なセンチネル値。 |
copilotPackageRequestType 列挙型
| 値 | 説明 |
|---|---|
publish |
ユーザーが新しいパッケージを organization カタログに公開するように要求しました。 |
activate |
ユーザーが、カタログに存在するパッケージをアクティブ化して使用するように要求しました。 |
access |
ユーザーが、organization 内で既にアクティブなパッケージへのアクセスを許可するように求めました。 |
update |
ユーザーが、既に公開されているパッケージを新しいバージョンに更新するように要求しました。 |
unknownFutureValue |
進化可能なセンチネル値。 |
packageAllowStatus 列挙型
| 値 | 説明 |
|---|---|
allowedForNone |
どのユーザーも使用できません。 |
allowedForSome |
一部のユーザー/グループが利用できます。 |
allowedForAll |
すべてのユーザーが利用できます。 |
unknownFutureValue |
進化可能なセンチネル値。 |
packageAcquireStatus 列挙型
| 値 | 説明 |
|---|---|
acquiredForNone |
ユーザーにデプロイされていません。 |
acquiredForSome |
一部のユーザー/グループに展開されました。 |
acquiredForAll |
すべてのユーザーに展開されます。 |
unknownFutureValue |
進化可能なセンチネル値。 |
packageType 列挙型
| 値 | 説明 |
|---|---|
microsoft |
Microsoft によって構築されました。 |
external |
パートナーによって構築されました。 |
shared |
Shared in your organization. |
custom |
Built by your organization. |
unknownFutureValue |
進化可能なセンチネル値。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.copilotPackage",
"agentIdentityId": "String",
"appId": "String",
"assetId": "String",
"availableTo": "String",
"createdDateTime": "DateTimeOffset",
"deployedTo": "String",
"displayName": "String",
"elementTypes": ["String"],
"governanceMetadata": "String",
"id": "String",
"isBlocked": "Boolean",
"lastModifiedDateTime": "DateTimeOffset",
"manifestId": "String",
"manifestVersion": "String",
"platform": "String",
"publisher": "String",
"requestStatus": "String",
"requestType": "String",
"shortDescription": "String",
"supportedHosts": ["String"],
"type": "String",
"version": "String",
"zipFile": "Stream"
}