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