重要
该 /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。
表示租户中可用的 Copilot 包的实体,包含包管理的基本元数据和配置信息。
重要
访问程序包管理 API 需要 Microsoft Agent 365 许可证。
属性
| 属性 | 类型 | 说明 |
|---|---|---|
agentIdentityId |
String | 与 Copilot 包关联的 Microsoft Entra 代理标识的标识符。 只读。 |
appId |
String | 此包关联的 Microsoft Entra AD 应用程序注册 ID。 |
assetId |
String | 用于在资产存储中引用此包的标识符。 |
availableTo |
packageAllowStatus | 枚举值,指定租户中的哪些用户或组可以访问此包 (allowedForAll, allowedForSome, allowedForNone) 。 |
createdDateTime |
DateTimeOffset | 创建代理包的日期和时间。 |
deployedTo |
packageAcquireStatus | 枚举值,指示租户 (acquiredForAll, , acquiredForSomeacquiredForNone) 中包的当前部署范围。 |
displayName |
String | 向用户和管理员显示的包的可读名称。 |
elementTypes |
字符串集合 | 此包中包含的元素类型的集合 (例如 bot) declarativeAgent 。 对于工具,可能的值包括 AgentConnectorsAgentSkills和 。
$filter支持列表包。 |
governanceMetadata |
String | 代理的代理分类。 可能的值为:PromptAgent、AIAppHostedAgentWorkflowAgentManagedAgentUnmanaged和 。 |
id |
String | 租户中 Copilot 包的唯一标识符。 |
isBlocked |
布尔值 | 布尔标志,指示是否以管理方式阻止在租户中使用包。 |
lastModifiedDateTime |
DateTimeOffset | 对包配置或元数据进行上次修改的时间戳。 |
manifestId |
String | 包清单中声明的唯一标识符。 创建后不可更新。 |
manifestVersion |
String | 用于定义此包的清单架构的版本。 创建后不可更新。 |
owners |
packageAccessEntity 集合 | 拥有包的负责用户和组的集合。 创建后不可更新。 |
platform |
String | 此包面向 (的主机平台,例如 teams、、 outlookweb) 。 支持带 eq 的$filter。 |
publisher |
String | 发布此包的组织或实体的名称。 |
requestStatus |
copilotPackageRequestStatus | 可为 Null。 与此包关联的请求的状态。 支持 $filtereq列表包。 |
requestType |
copilotPackageRequestType | 可为 Null。 与此包关联的请求类型。 支持 $filtereq列表包。 |
shortDescription |
String | 简要说明,概述包的功能和用途。 |
supportedHosts |
字符串集合 | 可 (使用此包的主机应用程序的集合,例如 teams、、 outlooksharePoint) 。 |
type |
packageType | 包的类型分类,指示它是第一方、第三方、共享还是 LOB。 |
version |
String | 程序包 (的版本字符串,例如, 1.2.3) 。 创建后不可更新。 |
zipFile |
Stream | Copilot 包文件。 |
copilotPackageRequestStatus 枚举
| 值 | 说明 |
|---|---|
pending |
请求处于打开状态,等待管理员对其执行操作。 |
approved |
管理员批准了该请求。 |
rejected |
管理员拒绝了该请求。 |
unknownFutureValue |
可进化的哨兵值。 |
copilotPackageRequestType 枚举
| 值 | 说明 |
|---|---|
publish |
用户请求将新包发布到组织目录。 |
activate |
用户要求激活目录中存在的包以供使用。 |
access |
用户请求授予对组织中已处于活动状态的包的访问权限。 |
update |
用户要求将已发布的包更新到较新版本。 |
unknownFutureValue |
可进化的哨兵值。 |
packageAllowStatus 枚举
| 值 | 说明 |
|---|---|
allowedForNone |
对任何用户都不可用。 |
allowedForSome |
适用于某些用户/组。 |
allowedForAll |
适用于所有用户。 |
unknownFutureValue |
可进化的哨兵值。 |
packageAcquireStatus 枚举
| 值 | 说明 |
|---|---|
acquiredForNone |
未部署到任何用户。 |
acquiredForSome |
部署到某些用户/组。 |
acquiredForAll |
部署到所有用户。 |
unknownFutureValue |
可进化的哨兵值。 |
packageType 枚举
| 值 | 说明 |
|---|---|
microsoft |
由 Microsoft 生成。 |
external |
由合作伙伴构建。 |
shared |
在组织中共享。 |
custom |
由组织生成。 |
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",
"owners": [
{
"@odata.type": "microsoft.graph.packageAccessEntity"
}
],
"platform": "String",
"publisher": "String",
"requestStatus": "String",
"requestType": "String",
"shortDescription": "String",
"supportedHosts": ["String"],
"type": "String",
"version": "String",
"zipFile": "Stream"
}