Skip to main content

查询 Web 手动安装登记

千问办公企业旗舰版开发者文档:查询 Web 手动安装登记。

认证方式见APP开发者文档 → 认证接入。
  • 模块:技能中心
  • 权限:按当前用户的资源范围校验,不要求管理员权限。
  • 接口:GET/api/openapi/app/v1/ai-assets/installations

请求参数

参数位置类型必填说明
pagequeryinteger否页码,默认 1,范围 1–1000000。
page_sizequeryinteger否每页数量,默认 20,范围 1–100。
resource_typequerystring否支持 skill、expert_kit 和 connector。 可选值:skill, expert_kit, connector。

响应

200 返回 application/json,直接返回下述对象。

WebassetsListResponse

字段类型必填说明
itemsarray<WebassetsView>是当前页本人的手动安装登记,包含已失去权限或来源的最小不可用记录。
pageinteger是页码,默认 1,范围 1–1000000。
page_sizeinteger是每页数量,默认 20,范围 1–100。
state_etagstring是当前组织/用户/Web 状态版本;写入时作为 If-Match 原样传入。
totalinteger是筛选后的手动登记总数,不包含仅自动下发的资源。

WebassetsView

字段类型必填说明
auto_providedboolean是当前策略自动下发来源;不等同于手动安装。
availableboolean是当前配置来源和使用资格有效;仍需结合用户开关、不可用原因和准备状态。
manual_installedboolean是是否有 Web 手动安装登记,不证明资源文件已经准备。
namestring否对技能和专家套件,此处是安装来源的调用名,对应目录列表或详情的 name。仅当来源可用且用户有权查看时返回。
name_cnstring否资源中文名称,可省略。
preparationWebassetsPreparation否最近一次包准备观察,不是本轮 Agent 已成功加载的保证。
resourceWebassetsResource是本人资源身份、安装登记及偏好;不包含资源包或凭据。
state_etagstring是当前组织/用户/Web 状态版本;写入时作为 If-Match 原样传入。
unavailable_reasonstring是不可用原因,例如 resource_unavailable、dependency_feature_pending、state_recovery_required 或 state_unavailable;无原因时为空。
user_enabledboolean是当前有效用户开关;不代表权限或资源包准备完成。

WebassetsPreparation

字段类型必填说明
observed_atstring否最近观察时间,RFC 3339;不是实时执行状态。
statestring是准备状态:pending、preparing、prepared、failed、stale 或 unknown。 可选值:pending, preparing, prepared, failed, stale, unknown。
versionstring否观察到的资源包版本。

WebassetsResource

字段类型必填说明
confirmed_generationstring否恢复后该资源的已确认代际;客户端不得自行设置。
enabledboolean否用户启停选择;false 同样覆盖自动下发资源,不能为 null。
idstring是资源 UUID,不是市场条目 ID。
lifecycle_epochinteger是服务端资源生命周期代际,仅用于控制一致性。
manual_installWebassetsInstallation否手动登记实例;自动资源不因下发而创建该字段。
originstring是org 或 public,沿用目录返回的来源。 可选值:org, public。
resource_typestring是支持 skill、expert_kit 和 connector。 可选值:skill, expert_kit, connector。

WebassetsInstallation

字段类型必填说明
installation_idstring是服务端生成的手动安装实例 UUID;完整卸载后重装生成新实例。
registered_atstring是手动登记时间,RFC 3339。
source_channelstring是登记来源渠道。
source_market_item_idstring是登记时绑定的市场条目 UUID,不会自动切换到新条目。

使用说明

支持三类资源,按 capabilities 决定动作;连接器默认关闭,完成必要授权后方可启用。 仅返回本人的手动登记,按 resource_type 筛选后分页;自动下发来源只在目录和偏好响应中体现。登记保留但资源已删除或权限撤销时,返回最小不可用记录,不泄露无权资源详情。 状态保存在服务端按组织/用户/Web 隔离的 PostgreSQL 状态行,与桌面端独立;客户端不直接读写 JSON,不使用 biz_hub_install。preparation 仅为最近观察,prepared 不保证本轮已加载,pending 不应显示为下载失败。套件 required 依赖必须全部就绪;optional 依赖不可用时仅省略相应能力。无法映射的内联依赖仍阻止执行。