千问办公企业旗舰版开发者文档:获取专家套件详情。
认证方式见APP开发者文档 → 认证接入。
200 返回
服务端确定组织、用户和 Web 策略范围,并检查业务准入、资源有效性、Web 兼容性及 DISCOVER 权限。
详情每次重新检查可见性。资源不存在、不可见或不兼容时返回 404(
- 模块:技能中心
- 权限:按当前用户的资源范围校验,不要求管理员权限。
- 接口:GET
/api/openapi/app/v1/ai-assets/expert-kits/{origin}/{id}
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| origin | path | string | 是 | org 或 public;使用列表返回的来源。 |
| id | path | string | 是 | 资源 UUID;使用列表返回的 id。 |
响应
200 返回 application/json,直接返回下述对象。
EnterprisemarketAppAsset
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| auth_type | string | 否 | 连接器认证类型。 |
| auto_provided | boolean / null | 是 | 当前自动下发来源;状态不可用时可为 null,不能解释为手动安装。 |
| capabilities | EnterprisemarketAppAssetCapabilities | 是 | 当前可执行的操作标志。 |
| category | string | 是 | 资源分类。 |
| connection_status | string | 是 | 连接状态:true/false/unknown;unknown 不能解释为已连接。 |
| dependencies | EnterprisemarketAppAssetDependencies | 否 | 专家套件依赖数量,不含受限资源详情。 |
| description | string | 是 | 资源描述。 |
| description_cn | string | 是 | 中文描述。 |
| icon_url | string | 是 | 图标地址。 |
| id | string | 是 | 资源 ID;详情使用此值,不使用 market_item_id。 |
| manual_installed | string | 是 | Web 手动登记:true/false/unknown;不证明文件已经下载。 |
| market_item_id | string | 是 | 市场条目 ID。 |
| name_en | string | 否 | 专家套件的英文展示名称,对应管理后台的 display_name。未配置时省略。 |
| name | string | 是 | 专家套件调用名,对应企业管理后台专家套件的唯一标识 name。在首轮任务中拼接为 @[plugin:{name}:{显示名称}],显示名称取同一条目的 name_cn,为空时取 name_en,两者均为空时取 name。 |
| name_cn | string | 是 | 中文名称。 |
| origin | string | 是 | 资源来源:org 或 public;沿用列表返回值。 可选值:org, public。 |
| requires_auth | boolean | 否 | 连接器是否要求认证,不代表用户已授权。 |
| preparation | WebassetsPreparation | 否 | 最近一次包准备观察;不是本轮已加载的保证。 |
| state_etag | string | 否 | 当前状态版本,写入时作为 If-Match 原样传入。 |
| resource_type | string | 是 | 可选值:skill, expert_kit, connector。 |
| supported_surfaces | array<string> | 是 | 支持的产品端列表。 |
| surface_code | string | 是 | 固定为 qwenwork_web。 可选值:qwenwork_web。 |
| unavailable_reason | string | 是 | 空字符串表示无阻塞原因;可为 state_unavailable、resource_unavailable、state_recovery_required 或 dependency_feature_pending。具体原因以服务端当前返回为准。 |
| user_enabled | string | 是 | 当前有效开关:true/false/unknown;unknown 不等于关闭。 |
| version | string | 是 | 资源版本。 |
EnterprisemarketAppAssetCapabilities
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| can_authorize | boolean | 是 | 当前是否允许发起连接器授权,由资源类型、权限、配置和授权状态决定。 |
| can_install | boolean | 是 | 当前是否允许添加 Web 手动登记,以服务端能力标志为准。 |
| can_toggle | boolean | 是 | 当前是否允许修改 Web 启停偏好,以服务端能力标志为准。 |
| can_uninstall | boolean | 是 | 当前是否允许移除手动来源;自动管理资源的完整卸载受限。 |
| can_use | boolean | 是 | 当前资格和开关允许使用;不保证资源包已准备或本轮已加载。 |
EnterprisemarketAppAssetDependencies
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| command_count | integer | 是 | 命令数量。 |
| connector_count | integer | 是 | 连接器数量。 |
| skill_count | integer | 是 | 技能数量。 |
WebassetsPreparation
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| observed_at | string | 否 | 最近观察时间,RFC 3339;不是实时执行状态。 |
| state | string | 是 | 准备状态:pending、preparing、prepared、failed、stale 或 unknown。 可选值:pending, preparing, prepared, failed, stale, unknown。 |
| version | string | 否 | 观察到的资源包版本。 |
使用说明
服务端确定组织、用户和 Web 策略范围,并检查业务准入、资源有效性、Web 兼容性及 DISCOVER 权限。
详情每次重新检查可见性。资源不存在、不可见或不兼容时返回 404(market_item_not_found),不要通过切换 origin 或用户标识绕过。
技能及基础专家套件可按 capabilities 使用 Web 安装/启停接口;连接器的安装、启停和授权按当前 capabilities 及对应接口处理;授权成功不代表沙箱已可执行。状态不可用时保留目录结果并返回 unknown/state_unavailable,不假定未安装。目录响应不含下载地址、执行配置或凭据。