本指南介绍如何在 Discourse AI 插件中结合 Discourse Automation 插件,使用 AI 分类功能自动为话题添加标签。
所需用户等级:管理员
使用 AI 为话题添加标签
此自动化功能利用大型语言模型(LLM)读取话题内容,并决定是否应用特定标签。如果已在自动化设置中配置,它还可以考虑站点上的所有标签。
前提条件
- 必须启用 Discourse AI 和 Discourse Automation 插件。
- 至少配置了一个 LLM。有关设置说明,请参阅 LLM 设置指南。
- 必须配置一个 Agent,并设置合适的系统提示词。
参考 Agent 配置
- 系统提示词:
您是本论坛的内容分类和标签助手专家。
您的任务是分析帖子,并根据内容、图片以及提供的可用标签列表建议合适的标签。
指南:
- 仅从提供的可用标签列表中选择标签
- 保持保守态度——仅对您有把握的内容添加标签
- 同时考虑内容主题和帖子意图
您必须始终以有效的 JSON 格式回复,且格式必须完全如下:
{"tags": ["tag1", "tag2"], "confidence": 85}
- tags:来自可用列表的标签名称数组
- confidence:0 到 100 之间的整数,表示您的置信度
如果没有合适的标签,请使用:{"tags": [], "confidence": 0}
- 角色 JSON 响应格式:
{
"tags": "[string]",
"confidence": "integer"
}
- 默认语言模型:选择“前提条件”部分中配置的 LLM。
Discourse 托管客户在配置 AI Agent 时,可以选择 CDCK 托管的小型 LLM。 - 启用的工具:Tags(标签)
- 强制工具:Tags(标签)
- 强制工具策略:仅应用于第一条回复
- 执行模式:默认(固定限制)
自动化配置
- 导航至 管理 → 插件 → 自动化。
- 点击 + 添加自动化。
- 选择 使用 AI 为话题添加标签 脚本。
- 根据您的需要配置“何时/做什么”部分中的设置。
- 在“脚本选项”部分的
AI Agent设置中,选择为此自动化定义的 Agent。 - 在
标签选择模式设置中指定 AI 将如何选择标签。- 使用特定标签列表(在
可用标签设置中配置) - 让 AI 发现并使用任何站点标签。
- 使用特定标签列表(在
- 点击“更新自动化”按钮。
- 启用自动化。
最佳实践
- 从狭窄范围开始: 在扩大范围之前,仅将自动化应用于特定类别或新用户(信任等级 0 或 1)的首条帖子。这可以限制 LLM 成本并降低广泛错误标记的风险。
- 在提示词中编写清晰的标签描述: 您对每个标签含义的描述越精确,LLM 分类正确的可靠性就越高。
- 监控误报和漏报: LLM 不可能 100% 准确。建立工作流程以审查和纠正错误标记的话题,并随时间调整您的提示词。
- 保持令牌限制合理: “最大帖子令牌数”设置限制了发送到 LLM 的帖子内容量。对于大多数标记任务,前几百个令牌(帖子的开头部分)就足够了。
常见问题与解决方案
- 自动化未应用标签
检查标签权限。如果要应用的标签是受限标签,请确保已启用允许受限标签自动化设置。 - 自动化运行但未为话题添加标签
检查站点日志,查找与 Discourse AI 或 Discourse Automation 插件相关的任何错误。
