Skip to main content

查询专家套件列表

千问办公企业旗舰版开发者文档:查询专家套件列表。

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

请求参数

参数位置类型必填说明
keywordquerystring否名称/描述子串搜索,最多 200 字符;保留市场编排顺序。
pagequeryinteger否页码,默认 1,范围 1–1000000。
page_sizequeryinteger否每页数量,默认 20,范围 1–100。

响应

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

EnterprisemarketAppAssetListResponse

字段类型必填说明
itemsarray<EnterprisemarketAppAsset>是当前页可见资源。
pageCatalogsourcePage是分页信息。

EnterprisemarketAppAsset

字段类型必填说明
auth_typestring否连接器认证类型。
auto_providedboolean / null是当前自动下发来源;状态不可用时可为 null,不能解释为手动安装。
capabilitiesEnterprisemarketAppAssetCapabilities是当前可执行的操作标志。
categorystring是资源分类。
connection_statusstring是连接状态:true/false/unknown;unknown 不能解释为已连接。
dependenciesEnterprisemarketAppAssetDependencies否专家套件依赖数量,不含受限资源详情。
descriptionstring是资源描述。
description_cnstring是中文描述。
icon_urlstring是图标地址。
idstring是资源 ID;详情使用此值,不使用 market_item_id。
manual_installedstring是Web 手动登记:true/false/unknown;不证明文件已经下载。
market_item_idstring是市场条目 ID。
name_enstring否专家套件的英文展示名称,对应管理后台的 display_name。未配置时省略。
namestring是专家套件调用名,对应企业管理后台专家套件的唯一标识 name。在首轮任务中拼接为 @[plugin:{name}:{显示名称}],显示名称取同一条目的 name_cn,为空时取 name_en,两者均为空时取 name。
name_cnstring是中文名称。
originstring是资源来源:org 或 public;沿用列表返回值。 可选值:org, public。
requires_authboolean否连接器是否要求认证,不代表用户已授权。
preparationWebassetsPreparation否最近一次包准备观察;不是本轮已加载的保证。
state_etagstring否当前状态版本,写入时作为 If-Match 原样传入。
resource_typestring是可选值:skill, expert_kit, connector。
supported_surfacesarray<string>是支持的产品端列表。
surface_codestring是固定为 qwenwork_web。 可选值:qwenwork_web。
unavailable_reasonstring是空字符串表示无阻塞原因;可为 state_unavailable、resource_unavailable、state_recovery_required 或 dependency_feature_pending。具体原因以服务端当前返回为准。
user_enabledstring是当前有效开关:true/false/unknown;unknown 不等于关闭。
versionstring是资源版本。

EnterprisemarketAppAssetCapabilities

字段类型必填说明
can_authorizeboolean是当前是否允许发起连接器授权,由资源类型、权限、配置和授权状态决定。
can_installboolean是当前是否允许添加 Web 手动登记,以服务端能力标志为准。
can_toggleboolean是当前是否允许修改 Web 启停偏好,以服务端能力标志为准。
can_uninstallboolean是当前是否允许移除手动来源;自动管理资源的完整卸载受限。
can_useboolean是当前资格和开关允许使用;不保证资源包已准备或本轮已加载。

EnterprisemarketAppAssetDependencies

字段类型必填说明
command_countinteger是命令数量。
connector_countinteger是连接器数量。
skill_countinteger是技能数量。

CatalogsourcePage

字段类型必填说明
current_pageinteger是当前页码。
last_pageinteger是最后一页页码。
next_pageinteger是下一页页码。
page_sizeinteger是每页数量。
prev_pageinteger是上一页页码。
total_sizeinteger是可见资源总数。

WebassetsPreparation

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

使用说明

服务端确定组织、用户和 Web 策略范围,并检查业务准入、资源有效性、Web 兼容性及 DISCOVER 权限。 列表只返回当前成员可发现的资源,空列表不代表调用失败。分页参数非法或关键词过长返回 400(market_validation_failed)。 技能及基础专家套件可按 capabilities 使用 Web 安装/启停接口;连接器的安装、启停和授权按当前 capabilities 及对应接口处理;授权成功不代表沙箱已可执行。状态不可用时保留目录结果并返回 unknown/state_unavailable,不假定未安装。目录响应不含下载地址、执行配置或凭据。