Skip to main content

查询 Web 资源启停状态

千问办公企业旗舰版开发者文档:查询 Web 资源启停状态。

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

请求参数

参数位置类型必填说明
resource_typepathstring是支持 skill、expert_kit 和 connector。 可选值:skill, expert_kit, connector。
originpathstring是org 或 public,沿用目录返回的来源。 可选值:org, public。
idpathstring是资源 UUID,不是市场条目 ID。

响应

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

WebassetsView

字段类型必填说明
auto_providedboolean是当前策略自动下发来源;不等同于手动安装。
availableboolean是当前配置来源和使用资格有效;仍需结合用户开关、不可用原因和准备状态。
manual_installedboolean是是否有 Web 手动安装登记,不证明资源文件已经准备。
namestring否有当前可见权限时提供的资源名称;无权清理记录可省略。
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 决定动作;连接器默认关闭,完成必要授权后方可启用。 返回自动来源、手动登记、当前开关、使用资格及 state_etag。已失去权限但本人仍有状态的资源可返回最小清理记录;不存在本人状态且不可见时返回 404。此接口不授予资源可见或使用权限。 状态保存在服务端按组织/用户/Web 隔离的 PostgreSQL 状态行,与桌面端独立;客户端不直接读写 JSON,不使用 biz_hub_install。preparation 仅为最近观察,prepared 不保证本轮已加载,pending 不应显示为下载失败。套件 required 依赖必须全部就绪;optional 依赖不可用时仅省略相应能力。无法映射的内联依赖仍阻止执行。