Skip to main content

使用指南

千问办公企业旗舰版开发者文档:使用指南。

问题反馈使用指南

认证方式见APP开发者文档 → 认证接入。 问题反馈复用 Client Platform 的反馈记录、截图、诊断附件和管理端处理能力。管理端产品行为见旗舰版管理后台帮助文档 → 日志审计 → 用户问题反馈。

接口与归属

能力方法APP 入口
上传截图PUT/api/openapi/app/v1/feedback/images
提交反馈(可附诊断包)PUT/api/openapi/app/v1/feedback
查询本人反馈历史GET/api/openapi/app/v1/feedback/history
反馈及附件归属由服务端确定,不能通过 user_id 或 org_id 指定他人。提交入口固定 source=web。关联有效 extra.session_id 的 Web 反馈由后端直接采集沙箱与服务日志。既有 Session 独立采集接口保留兼容,只返回日志包,不创建反馈记录。

调用顺序

  1. 为一次反馈生成 request_id。会话关联可选;从当前会话或当前用户有权访问的会话取得有效 ID。未关联时省略 sessionId,不传空字符串,也不调用 Session 日志采集。
  2. 有截图时先上传图片,保留 imageUrls。截图仍来自当前页面,选择其他会话不会改变截图来源;上传图片不会创建反馈记录。
  3. 准备可选的浏览器日志 ZIP。无需请求或解包沙箱日志;后端采集可能使用已授权的 OSS 归档,部分失败会记录在最终清单中。
  4. 通过 APP 提交入口使用同一 request_id 提交 description、版本信息、可选 file 和 img_urls;多个截图地址以逗号连接。使用 ide_type=QwenWork、实际 Web 版本,plugin_version 可为 not-applicable。关联会话时将 { "session_id": "有效会话 UUID" } 序列化为 extra 文本字段。
  5. 检查 success。服务日志采集情况另看 result.applicationLogsStatus(complete/partial,可能省略),不与 Session 返回的 status 混用;缺少该字段时不能判断服务日志完整。成功后通过本人反馈历史查询;结果未知或上传失败时复用同一次提交的 ID 和内容,修改反馈内容或所选会话后生成新 ID。

会话关联与附件

诊断包可选,支持仅文字或文字加截图反馈。extra 是 JSON 扩展文本,可写入 page_url、user_agent、可选 session_id、captured_at 和 web_version。page_url 不包含查询参数、片段或 URL 凭据。会话归属由日志采集接口重新校验,extra 中的会话关联不能替代权限检查。 关联有效 extra.session_id、且未指定 oss_key 的 Web 提交会进入沙箱与服务诊断采集合包流程。即使请求不含 file,也可能生成带 sandbox-manifest.json 与 service-diagnostics/manifest.json 的 ZIP 并返回非空 result.url;服务日志不可用时保留原因清单。未触发补充流程且没有附件时,result.url 才为空。服务诊断使用可信身份与会话归属校验,不能通过 extra 指定他人的日志或任意查询。

三种结果分别核对

结果证据不能据此推断
反馈已保存提交 success=true,requestId 匹配,历史可查询沙箱或服务日志已完整采集、已上报官方
沙箱日志已采集检查最终 ZIP 的 sandbox-manifest.json、根 manifest 的 sandbox_logs 和 logs/ 文件服务端各模块日志完整
服务日志已补充source=web 与有效 extra.session_id,无 oss_key;检查 applicationLogsStatus 及 service-diagnostics/manifest.jsonSession 沙箱日志已采集
顶层表单 session_id、collect_sandbox_logs 不是 CPS 的采集开关。仅上传含 feedback.json、manifest.json 的客户端 ZIP,并写入 sandbox_logs.status=requested 或 included=false,只能说明请求方意图,不能证明日志已采集。具体字段及示例见“提交问题反馈(可附诊断包)”。 本人历史仅包含当前用户最近 30 天、ide_type 为 QwenWork 或 QoderWork 的记录,按创建时间倒序;不返回附件正文或运营中心处理状态。反馈提交成功只表示记录已保存,不表示已上报运营中心或问题已解决。

与客户端一致的管理端处理

Web 与桌面反馈进入同一管理端反馈列表,使用同一套查询、详情、附件下载、阅读状态及官方上报流程。按官网指南验收时需检查:
  • 管理员可按用户、描述及状态查询,查看反馈编号、提交时间、截图和实际提供的诊断附件;没有诊断附件时不能声称已采集完整日志。
  • 提交企业内部反馈不等于授权对外发送附件。手动及批量上报沿用现有明确授权和逐条结果处理,保留上报中、已上报、失败及官方问题编号的语义。
  • 自动上报沿用现有开关及授权,仅影响开启后新增的反馈,不自动补报历史记录;历史反馈可按既有手动或批量流程处理。
  • 本人历史查询与管理员审计列表的权限及返回范围不同,统一产品能力不扩大个人查询权限。
以上为共同验收要求;文档修订本身不代表这些场景已完成线上验收。