千问办公企业旗舰版开发者文档:使用指南。
问题反馈使用指南
认证方式见APP开发者文档 → 认证接入。
问题反馈复用 Client Platform 的反馈记录、截图、诊断附件和管理端处理能力。管理端产品行为见旗舰版管理后台帮助文档 → 日志审计 → 用户问题反馈。
接口与归属
| 能力 | 方法 | APP 入口 |
|---|---|---|
| 上传截图 | PUT | /api/openapi/app/v1/feedback/images |
| 提交反馈(可附诊断包) | PUT | /api/openapi/app/v1/feedback |
| 查询本人反馈历史 | GET | /api/openapi/app/v1/feedback/history |
调用顺序
- 为一次反馈生成 request_id。会话关联可选;从当前会话或当前用户有权访问的会话取得有效 ID。未关联时省略 sessionId,不传空字符串,也不调用 Session 日志采集。
- 有截图时先上传图片,保留 imageUrls。截图仍来自当前页面,选择其他会话不会改变截图来源;上传图片不会创建反馈记录。
- 准备可选的浏览器日志 ZIP。无需请求或解包沙箱日志;后端采集可能使用已授权的 OSS 归档,部分失败会记录在最终清单中。
- 通过 APP 提交入口使用同一 request_id 提交 description、版本信息、可选 file 和 img_urls;多个截图地址以逗号连接。使用 ide_type=QwenWork、实际 Web 版本,plugin_version 可为 not-applicable。关联会话时将
{ "session_id": "有效会话 UUID" }序列化为 extra 文本字段。 - 检查 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.json | Session 沙箱日志已采集 |
session_id、collect_sandbox_logs 不是 CPS 的采集开关。仅上传含 feedback.json、manifest.json 的客户端 ZIP,并写入 sandbox_logs.status=requested 或 included=false,只能说明请求方意图,不能证明日志已采集。具体字段及示例见“提交问题反馈(可附诊断包)”。
本人历史仅包含当前用户最近 30 天、ide_type 为 QwenWork 或 QoderWork 的记录,按创建时间倒序;不返回附件正文或运营中心处理状态。反馈提交成功只表示记录已保存,不表示已上报运营中心或问题已解决。
与客户端一致的管理端处理
Web 与桌面反馈进入同一管理端反馈列表,使用同一套查询、详情、附件下载、阅读状态及官方上报流程。按官网指南验收时需检查:
- 管理员可按用户、描述及状态查询,查看反馈编号、提交时间、截图和实际提供的诊断附件;没有诊断附件时不能声称已采集完整日志。
- 提交企业内部反馈不等于授权对外发送附件。手动及批量上报沿用现有明确授权和逐条结果处理,保留上报中、已上报、失败及官方问题编号的语义。
- 自动上报沿用现有开关及授权,仅影响开启后新增的反馈,不自动补报历史记录;历史反馈可按既有手动或批量流程处理。
- 本人历史查询与管理员审计列表的权限及返回范围不同,统一产品能力不扩大个人查询权限。