copilotPackage 资源类型

重要

该 /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"
}