Article directory
常见问题

把问题描述到能排查:一份可复制的反馈模板

用最少必要的信息交代账号、时间、入口、重现步骤、预期与实际结果,保护隐私并减少来回追问。

This article is currently available in Chinese.

“AIRumo 不行了”无法区分登录、聊天、文件还是 Agent 执行问题;一段很长的聊天截图也未必包含失败环节。有效反馈不要求你判断技术原因,而是让支持人员能回答:哪个账号,在什么时间,从哪个入口做了什么,原本应该出现什么,实际出现了什么。

先记录,再决定是否重试

看到错误时,先记下完整提示和发生时间。若界面仍有未发送文字,先复制到自己安全的位置;不要一上来就清空聊天、删除 Agent 或注销账号。可以刷新或重开一次验证偶发现象,但已经影响数据、权限或任务结果时,不要反复提交相同动作。

打开“设置”→“关于 AIRumo”查看可见版本信息;说明使用 Web 还是桌面端,以及操作系统或浏览器名称。跨端差异要分别写清。例如“桌面端能下载,浏览器端失败”比“电脑打不开”精确得多。账号标识优先使用 AIRumo ID,不需要提交密码或验证码。

直接复制这份模板

PROMPT
问题标题:在什么入口做什么时,出现什么结果
账号:我的 AIRumo ID(发给有权处理的支持人员)
使用方式:Web/桌面端,版本,操作系统或浏览器
发生时间:YYYY-MM-DD HH:mm,注明时区
影响范围:仅我/部分成员/已确认的哪些客户端
操作步骤:
1. 从哪个页面进入
2. 输入或选择了什么(使用脱敏示例)
3. 点击哪个按钮后发生问题
期望结果:应出现什么可观察的变化
实际结果:具体表现及完整错误文字
重复情况:每次发生/偶发;重新打开后结果如何
关联线索:会话、文件名、任务或运行编号等非敏感标识
已经尝试:写清做过的检查及结果
附件:必要的局部截图,隐去无关聊天与个人信息

一份能帮助排查的例子

标题:“群文件下载失败,但发送端能够打开”。使用方式:“乙的 Web 端,浏览器版本已记录;甲使用桌面端”。步骤:“乙进入阅读活动群,打开群文件,点击‘周末阅读活动-交接-v1.txt’下载”。期望:“保存文本文件并能读到活动名额”。实际:“弹出文件不可用提示”。

再补上“乙当天新加入;甲前一晚发送;乙仍在群;重新从原消息打开结果相同;其它当日文件可以下载”,支持人员就能优先核对历史范围与目标文件状态。如果只是写“文件功能坏了”,则连是否已发出文件消息都需要重新追问。

不同问题需要补什么

问题类型最有用的补充信息通常不需要
登录或设备登录方式、错误原文、是否同类型客户端冲突密码、验证码、完整会话凭据
消息与群私聊还是群、本人角色、消息大致时间、操作是否属于自己消息整段群聊导出、所有成员名单
文件原消息与收藏各自结果、上传时间、本人是否仍在来源群完整签名下载链接、无关私密附件
Agent 与编排任务Agent 名称、任务或运行标识、最后可见状态、脱敏输入与预期API Key、模型密钥、本地配置文件全文

截图怎么截才有用

保留发生问题的页面区域、按钮名称和错误文字,必要时分两张说明操作前后。遮挡无关姓名、头像、手机号和私密正文;裁掉与问题无关的其它窗口。截图中若意外包含密钥或验证码,应先停止传播并处理泄露风险,不要继续转发到更大的群。

在客户端打开“设置”→“关于 AIRumo”,在“问题反馈”处点击“去反馈”。将简短标题填入“主题”,将模板中的步骤、预期和实际结果填入“问题描述”,再点击“提交反馈”。主题最多 120 字,描述最多 2000 字;提交后以“反馈已提交”提示为完成标志。这个表单不提供截图上传,也不会自动附带设备、密码或日志,请自己补充必要版本与时间信息。

需要发送截图时,使用你所在组织指定的支持渠道,仅提供必要的局部画面。如果问题涉及产品后台,写清具体菜单;如果涉及帮助文章,附文章标题和哪一段说不清。反馈后补充“已恢复/仍失败”和复测时间,避免支持人员继续跟进已经变化的现象。

需要先自查时可阅读:登录问题 · 文件不可用 · Agent 离线 · 回答不符合预期。

Still need help?Contact us ↗