千问办公企业旗舰版开发者文档:查询 Web 资源启停状态。
认证方式见APP开发者文档 → 认证接入。
200 返回
支持三类资源,按 capabilities 决定动作;连接器默认关闭,完成必要授权后方可启用。
返回自动来源、手动登记、当前开关、使用资格及 state_etag。已失去权限但本人仍有状态的资源可返回最小清理记录;不存在本人状态且不可见时返回 404。此接口不授予资源可见或使用权限。
状态保存在服务端按组织/用户/Web 隔离的 PostgreSQL 状态行,与桌面端独立;客户端不直接读写 JSON,不使用 biz_hub_install。preparation 仅为最近观察,prepared 不保证本轮已加载,pending 不应显示为下载失败。套件 required 依赖必须全部就绪;optional 依赖不可用时仅省略相应能力。无法映射的内联依赖仍阻止执行。
- 模块:技能中心
- 权限:按当前用户的资源范围校验,不要求管理员权限。
- 接口:GET
/api/openapi/app/v1/ai-assets/preferences/{resource_type}/{origin}/{id}
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| resource_type | path | string | 是 | 支持 skill、expert_kit 和 connector。 可选值:skill, expert_kit, connector。 |
| origin | path | string | 是 | org 或 public,沿用目录返回的来源。 可选值:org, public。 |
| id | path | string | 是 | 资源 UUID,不是市场条目 ID。 |
响应
200 返回 application/json,直接返回下述对象。
WebassetsView
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| auto_provided | boolean | 是 | 当前策略自动下发来源;不等同于手动安装。 |
| available | boolean | 是 | 当前配置来源和使用资格有效;仍需结合用户开关、不可用原因和准备状态。 |
| manual_installed | boolean | 是 | 是否有 Web 手动安装登记,不证明资源文件已经准备。 |
| name | string | 否 | 有当前可见权限时提供的资源名称;无权清理记录可省略。 |
| name_cn | string | 否 | 资源中文名称,可省略。 |
| preparation | WebassetsPreparation | 否 | 最近一次包准备观察,不是本轮 Agent 已成功加载的保证。 |
| resource | WebassetsResource | 是 | 本人资源身份、安装登记及偏好;不包含资源包或凭据。 |
| state_etag | string | 是 | 当前组织/用户/Web 状态版本;写入时作为 If-Match 原样传入。 |
| unavailable_reason | string | 是 | 不可用原因,例如 resource_unavailable、dependency_feature_pending、state_recovery_required 或 state_unavailable;无原因时为空。 |
| user_enabled | boolean | 是 | 当前有效用户开关;不代表权限或资源包准备完成。 |
WebassetsPreparation
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| observed_at | string | 否 | 最近观察时间,RFC 3339;不是实时执行状态。 |
| state | string | 是 | 准备状态:pending、preparing、prepared、failed、stale 或 unknown。 可选值:pending, preparing, prepared, failed, stale, unknown。 |
| version | string | 否 | 观察到的资源包版本。 |
WebassetsResource
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| confirmed_generation | string | 否 | 恢复后该资源的已确认代际;客户端不得自行设置。 |
| enabled | boolean | 否 | 用户启停选择;false 同样覆盖自动下发资源,不能为 null。 |
| id | string | 是 | 资源 UUID,不是市场条目 ID。 |
| lifecycle_epoch | integer | 是 | 服务端资源生命周期代际,仅用于控制一致性。 |
| manual_install | WebassetsInstallation | 否 | 手动登记实例;自动资源不因下发而创建该字段。 |
| origin | string | 是 | org 或 public,沿用目录返回的来源。 可选值:org, public。 |
| resource_type | string | 是 | 支持 skill、expert_kit 和 connector。 可选值:skill, expert_kit, connector。 |
WebassetsInstallation
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| installation_id | string | 是 | 服务端生成的手动安装实例 UUID;完整卸载后重装生成新实例。 |
| registered_at | string | 是 | 手动登记时间,RFC 3339。 |
| source_channel | string | 是 | 登记来源渠道。 |
| source_market_item_id | string | 是 | 登记时绑定的市场条目 UUID,不会自动切换到新条目。 |