打开助手设置
用有设置管理权限的账号进入瓜奇 → AI 知识助手 → 助手设置，先在左上角选择要配置的前端网站。
独立前端如果开启“沿用主前端设置”，会使用主前端的助手配置。需要单独设置当前网站时，先关闭这个开关。使用权限也跟随这项继承选择；知识范围和服务公示有各自的继承开关。
要让助手实际回答，还需完成瓜奇初始化，配置搜索服务、向量模型和生成文字的 AI 通道，并准备好正文知识资料。名称和欢迎语只改变展示内容，不会增加助手掌握的资料。
填写访客看到的文字
- 开启“启用 AI 知识助手”，该开关默认关闭。
- 按网站实际使用的语言填写下表中的文案。
- 保存后重新打开设置，确认修改保留。
| 设置 | 填写方法与效果 |
|---|---|
| 按钮名称 | 用于页头和统一菜单中的 AI 入口文字，可按语言设置。留空使用 Ask。 |
| 助手名称 | 用于助手面板中的名称。留空使用默认名称。 |
| 欢迎语 | 访客开始新对话时看到的引导文字。建议说明本站能帮助解决哪些具体问题。 |
| 推荐问题 | 每行一个，最多显示前 4 个非空问题。留空使用默认问题；访客点击后会直接提交该问题。 |
| 未找到资料时的提示 | 用于资料不足时引导访客补充信息或联系客服。留空使用默认提示。 |
推荐问题应选择已有公开资料能回答的问题。例如写入“SEO 在哪里设置”前，先确保对应教程已发布、已收录，并允许当前前端的助手引用。
调整回答方式和人工入口
| 设置 | 作用与限制 |
|---|---|
| 回答风格 | 可选简洁专业、亲切自然、耐心讲解，默认简洁专业。 |
| 回答长度 | 可选简短、适中、详细，默认适中。它影响表达长度，不能补齐知识库缺失的事实。 |
| 补充说明 | 填写网站背景、称呼和服务范围，最多 4000 字。用于指导模型，不会直接发送给浏览器展示。 |
| 回答规则 | 填写不回答的内容、投诉处理方式等要求，最多 2000 字；留空使用默认规则。规则不能解除资料访问限制，也不保证模型每次完全遵守。 |
| 人工客服链接 | 填写完整、有效的 HTTP 或 HTTPS 地址。留空不显示；无效地址不会作为有效客服链接使用。 |
设置谁可以提问
切换到“使用权限”，分别配置游客和用户组。当前版本不再只有一个统一的“每分钟提问次数”。
- 游客：默认允许提问，每分钟默认 5 次，每天默认 20 次；同一 IP 的游客共享次数。
- 用户组：分别开启“允许使用”，设置每分钟和每个账号每天的次数。字段默认值分别为 10 和 100；同时属于多个允许使用的组时，取最高次数，不相加。
- 此前端每天总提问次数：默认 1000，合计所有用户和游客，达到上限后当天停止回答。
- 可填范围：每分钟次数为 1 至 30；每日次数为 1 至 1000000。需要禁止使用时关闭相应开关，不用填写 0。
登录用户按账号计数，切换设备或语言不会重置。每日额度保存在数据库中，各前端分别计算，按网站时区每日重置，重启服务不会清零。额度扣除后，中途取消或回答失败不会退回次数。
分钟限流在各个 Node 服务进程内计算，同一前端中的同一账号或游客 IP，在该进程内一次只能处理一个问题。部署多个进程时，分钟限制不是全站共享总额度。
升级后应由管理员完成一次初始化，创建每日计数所需的数据表。保存权限后新建的用户组默认不能使用，需要回到这里手动开启。
在前端验证
- 打开目标前端的助手，开始新对话，核对按钮名称、助手名称、欢迎语和推荐问题。
- 点击一条推荐问题，确认能发出提问，并检查回答引用的资料是否正确。
- 提出一个没有资料的问题，检查提示和人工客服入口。
- 分别用游客和目标用户组账号测试；再切换网站实际支持的语言，检查各语言文案。
如果入口文案正确但无法回答，继续检查服务连接、正文知识资料、知识范围和使用额度。反复修改欢迎语或把回答长度改成“详细”，不能解决这些问题。