Skip to main content

查询内置连接器列表

千问办公企业旗舰版开发者文档:查询内置连接器列表。

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

请求参数

参数位置类型必填说明
keywordquerystring否key、双语名称或描述的字面子串,忽略大小写和首尾空格,最多 200 字符。

响应

字段类型必填说明
itemsarray<object>是可见的内置连接器列表,无可见资源时为空数组;每项字段如下。
200 返回 { "items": [...] },最多三项;无权限时 items 是空数组。内置为独立有限集合,无 page 或 page_size,不计入市场分页。每个 item 的字段如下。
字段类型必填说明
idstring(uuid)是固定内置资源 UUID,可在连接器策略组中配置。
builtin_keystring是仅 dws(钉钉)、lark(飞书)或 wecom(企业微信)。
source_typestring是固定为 builtin,不是市场来源 org/public。
name / name_cnstring是英文名称、中文名称。
description / description_cnstring是英文描述、中文描述。
surface_codestring是固定为 qwenwork_web。
supported_surfacesarray(string)是固定目录声明的适配端,三项均为 qwenwork_pc、qwenwork_web;不是当前运行就绪或授权状态。
support_statusstring是management_available 表示管理能力已接入;状态服务未配置或不可用时保留 not_implemented。两者均不证明沙箱已可执行。
capabilitiesobject是管理能力,见下表;写入时仍由服务端重新校验。
stateobject否当前用户管理状态,见下表;读取失败或未装配状态服务时可能省略。

capabilities

字段类型必填说明
can_installboolean是当前是否允许添加。
can_toggleboolean是当前是否允许切换启用状态。
can_uninstallboolean是当前是否允许卸载手动安装的资源;自动提供的资源不能按手动安装卸载。
can_authorizeboolean是当前是否允许发起授权或配置操作。
can_useboolean是此目录投影当前固定为 false,不能据此推断运行时已可用。

state

字段类型必填说明
availableboolean是管理状态是否成功读取;不表示沙箱执行可用。
installedboolean是是否已手动安装或由系统自动提供。
enabledboolean是用户当前是否启用。
configuredboolean是当前实现为 connected 且 auth_mode=configuration;不是仅判断配置是否已保存。
connectedboolean是当前权限允许,且上游返回唯一健康连接、绑定指纹匹配当前配置时为 true;不代表沙箱已成功调用。
pendingboolean是是否存在待完成操作或授权尝试。
auth_modestring是oauth:钉钉、飞书;configuration:企业微信。
state_etagstring是用户资源状态版本,供安装、卸载及启停操作的 If-Match 使用。
auth_revisionstring是授权状态版本,供授权、配置、断开等操作的 If-Match 使用;状态不可用时可能为空。
unavailable_reasonstring否不可用原因;如 permission_unavailable、permission_denied、state_recovery_required、state_unavailable、operation_in_progress、authorization_unavailable。非穷举,未知值不能当作可用。
can_installboolean是当前是否允许添加。
can_toggleboolean是当前是否允许切换启用状态。
can_uninstallboolean是当前是否允许卸载手动安装的资源;自动提供的资源不能按手动安装卸载。
can_authorizeboolean是当前是否允许发起授权或配置操作。

权限与行为

按 connector_publish / DISCOVER / qwenwork_web 计算权限,沿用默认策略组、白名单及黑名单规则;不以旧 PC 策略兜底,不以 OAuth 登录成功代替资源权限。 Web 目录仅含钉钉、飞书、企业微信;浏览器、Microsoft 365、LINE、macOS 应用和计算机控制均不展示,详情返回 404。内置没有普通市场条目,不要求市场开关或市场条目 ID。响应不含凭据、命令、第三方 token 或 Bot Secret。可选 state 返回用户管理状态;读接口不产生安装或授权副作用。返回 Cache-Control: no-store。

错误

状态码说明
400参数无效。
401 / 403会话、可信身份或业务准入失败。
404详情 key 不存在、被排除或当前策略无权查看。
503IAM 不可用或返回未知 selector;拒绝展示,不回退固定全量目录。

用户管理状态

可选 state 包含 available、installed、enabled、connected、configured、pending、auth_mode、state_etag、auth_revision、unavailable_reason 及四项 can_* 管理能力。auth_mode 为 oauth(钉钉、飞书)或 configuration(企微)。configured 按上表的连接健康状态及配置授权模式计算,不证明沙箱已完成调用。状态失败不扩大权限,前端须禁用写操作并重新查询。 添加/卸载使用固定 key 的 /builtin-connectors/{key}/installations;启停、OAuth、取消与断开复用 /preferences/connector/org/{id} 和 /connectors/org/{id}/...。添加/启停使用 state_etag,授权/配置/断开使用 auth_revision。新装默认关闭,授权不自动启用,断开同时停用,完整卸载重装默认关闭。