Skip to main content

查询专家套件自动安装配置

使用 Authorization: Bearer <API_KEY>。应用必须配置全部用户范围 subject_scope={"mode":"all"},受限范围返回 403。

使用 Authorization: Bearer <API_KEY>。应用必须配置全部用户范围 subject_scope={"mode":"all"},受限范围返回 403。各 Scope 独立授权。响应不应缓存。policy_type 支持 skill_publish、connector_publish、expert_suite_publish,与 UI 三类发布策略一致。GET 的 policy_ids 为逗号分隔 UUID,最多 200 个;未配置项返回 auto_install=false、revision=0。PUT 使用 expected_revision。启用时要求原策略为非空、有限资源允许列表;停用不依赖 IAM 可用性。策略内容仍通过对应的已有发布策略接口保存;调用方先保存策略,再调用本接口设置自动安装,没有服务端组合写入。

所需权限

所需权限资源Scope资源服务
专家套件读取(read)expert-suitesadmin.v1.expert-suites.readqwenwork-biz-service
GET /api/openapi/v1/policy-delivery-configs

公共请求头

适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。 Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。

请求参数

名称位置类型必填说明示例
policy_typequerystring是policy type; enum=["skill_publish", "connector_publish", "expert_suite_publish"] 取值:"connector_publish"、"expert_suite_publish"、"skill_publish"-
policy_idsquerystring是以逗号分隔的策略 ID,最多 200 个-

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
curl --request GET \
  --url '<BASE_URL>/api/openapi/v1/policy-delivery-configs?policy_type=skill_publish&policy_ids=<policy_ids>' \
  --header 'Authorization: Bearer <API_KEY>'

响应状态表

HTTP 状态码触发条件响应结构引用客户端处理建议
200请求成功见本文“响应结果”读取响应结果。
default未单独列出的认证、授权、校验或依赖错误见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构按状态与 code 处理;写操作重试前核实结果及幂等要求。

响应结果

Content-Type: application/json
名称类型必填说明示例
itemsarray<object> | null是结果列表-

items[]

字段类型必填说明
auto_installboolean是是否自动安装
modified_atstring · date-time否最近修改时间; format="date-time"
modified_bystring否最近修改人标识
policy_idstring是策略 ID
policy_typestring是策略类型; enum=["skill_publish", "connector_publish", "expert_suite_publish"] 取值:"connector_publish"、"expert_suite_publish"、"skill_publish"
revisioninteger · int64是当前版本号,用于并发控制; format="int64"

错误与重试

保留现有 UI 服务的错误码与校验。401/403 表示认证或授权失败;409 表示冲突,应重新读取后重试;413 表示请求过大;400/422 表示参数校验失败;503 表示依赖不可用。 以实际响应及机器契约为准。创建类幂等操作重试应使用相同 Idempotency-Key 与相同请求。 为兼容原调用,入口仍要求上方专家套件 read/manage Scope。 skill_publish 还须授予 admin.v1.skills.read(GET)或 admin.v1.skills.manage(PUT);connector_publish 还须对应的 admin.v1.connectors.read/manage。 不同资源、读写权限不相互隐含。