编辑绑定域字段（千问凭证/智能体/状态），null 字段不修改；更换智能体时重新校验归属当前租户。品牌域请使用品牌配置接口。
POST
/api/qwen-onboarding/update编辑入驻配置
请求参数
请求体（JSON）5 个字段
idintegerrequired
入驻配置主键ID
qwenClientIdstringnullable
千问颁发的client_id，null表示不修改
qwenClientSecretstringnullable
千问颁发的client_secret，null表示不修改
agentIdintegernullable
点金侧智能体ID，null表示不修改；修改时须归属当前租户
statusstringnullable
状态，null表示不修改，取值 ACTIVE/DISABLED
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataobjectnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
POST
/api/qwen-onboarding/delete删除入驻配置
按主键软删除当前租户的入驻配置，删除后千问侧将无法继续调用。
请求参数
请求体（JSON）1 个字段
idintegerrequired
入驻配置主键ID
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataobjectnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
POST
/api/qwen-onboarding/brand/update更新品牌配置
更新入驻配置的品牌名、授权提示正文与协议列表，可同时上传品牌logo（png/jpg且不超过2MB，不传表示保留原图）。
请求参数
Query 参数4 个字段
qwenAppIdstringrequired
千问应用app_id，必填
brandNamestringrequired
品牌名，H5 展示 {品牌名}为您服务
authNoticestringrequired
授权提示正文，H5 按行渲染
agreementsstringrequired
协议JSON数组（机构官方外链）：[{"name":"《xx服务协议》","url":"https://机构官网/协议页"}]
Form Data1 个字段
logostringnullable
品牌logo文件，png/jpg且不超过2MB，不传表示保留原图
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataobjectnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
POST
/api/qwen-onboarding/bind绑定千问应用
绑定千问应用与当前租户的点金智能体，颁发 issued 凭证（仅本次明文回显，请妥善保存），并返回注册到千问侧所需的 Agent Card URL 与 A2A 端点URL。相同千问appId不可重复绑定。
请求参数
请求体（JSON）4 个字段
qwenAppIdstringrequired
千问侧应用app_id，全局唯一
qwenClientIdstringrequired
千问颁发的client_id
qwenClientSecretstringrequired
千问颁发的client_secret
agentIdintegerrequired
点金侧智能体ID，须归属当前租户
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataQwenOnboardingBindVOnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
GET
/api/qwen-onboarding/list查询入驻配置列表
查询当前租户的千问入驻配置列表，可按智能体ID过滤；密钥字段一律脱敏为 ****+末4位，不回显明文。
请求参数
Query 参数1 个字段
agentIdintegernullable
点金侧智能体ID，选填，用于过滤
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataarraynullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
GET
/api/qwen-onboarding/agent-card/preview预览Agent Card
预览指定千问应用的 Agent Card JSON（与对外服务端点同款实时构建逻辑），返回 agentCardUrl 与 card 两个字段。
请求参数
Query 参数1 个字段
qwenAppIdstringrequired
千问应用app_id，必填
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataobjectnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理