Rhex论坛系统AI助手配置教程

本教程将指导您如何配置论坛的AI助手，使其能够自动回复@提及，并辅助用户发帖。

AI助手配置教程

本教程将带您逐步配置论坛的AI助手功能，主要包括：基础AI配置（模型、回复开关）、发帖辅助配置（自动选节点、打标签）以及提示词定制。

第一步：进入AI助手配置页面

登录论坛后台管理。
在左侧侧边栏中，找到 “系统与扩展” 分组。
点击该分组下的 “应用中心”。
在应用中心列表里，找到并点击 “AI 助手” 应用，进入其配置页面。

第二步：配置核心AI模型与回复规则

这是AI助手正常运行的基础，您需要配置一个AI模型接口。

运行概览
- 此处展示了当前AI助手的状态，包括使用的代理账号（如 AI助手 (@robot)）、任务执行情况等，方便您监控。
AI 配置 - 基础开关
- 启用 AI 回复：总开关。开启后，AI才会响应@提及。建议保持开启。
- 帖子提及回复：开启后，当用户在帖子正文中 @AI账号 时，AI会自动生成一个评论进行回复。
- 评论提及回复：开启后，当用户在楼中楼评论中 @AI账号 时，AI会以楼中楼形式回复。
AI 配置 - 模型与账号设置
- AI 代理账号：选择或填写用于发布AI回复的论坛账号（例如，预先创建好的 robot 账号）。
- 模型接口 Base URL：填写您所使用的AI模型服务的API地址。
  - 示例：https://api.deepseek.com/v1 (DeepSeek) 或 https://api.openai.com/v1 (OpenAI)。
- 模型名称：指定要调用的具体模型。
  - 示例：deepseek-v4-flash, gpt-4o-mini。
- 温度：控制AI回复的创造性。值越低（如0.4），回复越保守、稳定、事实性更强；值越高（如0.7），回复越有创意和发散性。论坛助手建议设置在0.4到0.7之间。
- 最大输出 Token：限制AI单次回复的最大长度（字数），防止回复过长。
- 请求超时（毫秒）：设置AI接口请求的最大等待时间。
- API Key：填写您从AI服务商获取的API密钥。如果留空，系统将保留已保存的密钥。
- 清空已保存密钥：此开关用于清空已存储的API密钥。

第三步：配置发帖辅助功能

此功能可以帮助用户在发布新帖子时，由AI自动推荐合适的版块和标签。

发帖辅助开关
- 节点自动选择：开启后，用户在发帖页面可以选择交给AI，让其根据标题和正文自动匹配版块。
- 标签自动提取：开启后，AI会分析帖子内容，自动生成或推荐相关标签。
默认回退节点 slug：如果AI无法准确判断应该发布到哪个版块，可以设置一个默认版块（填写版块的英文标识，如 general-discussion）。留空则不启用此回退功能。

第四步：定制AI提示词 (Prompt)

提示词是塑造AI回复风格的关键。您可以通过修改以下四个方面的提示词，让AI更符合论坛的调性。

系统提示词：定义AI助手的全局角色、语气和基本原则。
- 默认示例：你是域名论坛里的 AI 助手账号...请直接输出可发布的评论正文...语气自然、克制、友好...
帖子提及提示词：当AI被用户在帖子正文中@时，使用此提示词指导回复。可以在此强调优先回应楼主诉求。
- 默认示例重点：当有人在帖子正文里 @你时，请结合整帖语义进行评论回复，优先回应楼主的主要诉求。
评论提及提示词：当AI被用户在评论中@时，使用此提示词。可以要求AI结合上下文（主楼和评论链）进行回复。
发帖辅助提示词：用于指导AI如何选择版块和标签。您可以在提示词中定义输出格式（如JSON），以便系统解析。

第五步：测试与保存

测试 AI：在完成所有配置后，建议点击 “测试 AI” 按钮，验证API密钥、模型接口和基本回复功能是否正常工作。
保存配置：所有设置调整完毕后，务必点击页面底部的 “保存配置” 按钮，使更改生效。

第六步：查看任务日志

配置页面底部提供了 “任务日志” 区域，您可以通过标签页切换查看：

发帖辅助任务：记录了每次AI为发帖推荐版块/标签的请求详情、结果和建议理由。
最近任务：记录了所有AI回复任务的执行情况，包括状态（成功/失败）、触发用户、回复内容摘要等。这对于排查问题非常有用。

最佳实践建议

逐步启用：建议先完成核心AI配置并测试通过后，再开启“帖子提及回复”和“评论提及回复”功能，避免意外情况。
精心设计提示词：提示词是AI的灵魂。可以多参考默认示例，并针对您社区的特定主题（如本教程中的“域名分析”）进行优化。
控制“温度”：对于追求准确性和事实性的问答，使用较低的“温度”（如0.3-0.5）；对于创意性头脑风暴或轻松聊天，可以适当调高“温度”（如0.7-0.9）。
监控日志：定期查看任务日志，关注“失败”的任务，检查错误信息，及时调整配置（如提示词、超时时间等）。

通过以上步骤，您就可以成功为您的论坛接入一个智能、可定制的AI助手了。