Skip to main content

获取技能详情

千问办公企业旗舰版开发者文档:获取技能详情。

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

请求参数

参数位置类型必填说明
originpathstring是org 或 public;使用列表返回的来源。
idpathstring是资源 UUID;使用列表返回的 id。

响应

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

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否技能的英文名称,对应管理后台的 name_en。未配置时省略。
namestring是技能调用名,对应企业管理后台技能的唯一标识 name。在首轮任务中拼接为 @[skill:{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是技能数量。

WebassetsPreparation

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

使用说明

服务端确定组织、用户和 Web 策略范围,并检查业务准入、资源有效性、Web 兼容性及 DISCOVER 权限。 详情每次重新检查可见性。资源不存在、不可见或不兼容时返回 404(market_item_not_found),不要通过切换 origin 或用户标识绕过。 技能及基础专家套件可按 capabilities 使用 Web 安装/启停接口;连接器的安装、启停和授权按当前 capabilities 及对应接口处理;授权成功不代表沙箱已可执行。状态不可用时保留目录结果并返回 unknown/state_unavailable,不假定未安装。目录响应不含下载地址、执行配置或凭据。