本指南介绍如何启用和配置 Discourse AI 插件的相关主题功能。
所需用户级别:管理员
相关主题通过根据用户正在阅读的主题推荐语义上相似的主题来帮助用户发现相关内容。这增强了内容探索并提高了用户参与度。
功能
- 语义文本相似度:超越关键词匹配,查找真正相关的内容
- 在“建议”和“相关”主题之间切换
- 对匿名和已登录用户均可用
启用相关主题
对于启用了 Discourse AI 插件的所有 Discourse 托管客户,相关主题默认开启。
先决条件
相关主题需要 Embeddings 才能运行。
如果您使用我们的托管服务,Embeddings 将使用开源模型提供。无需额外设置。
自托管实例需要通过第三方提供商提供自己的 Embeddings。
配置
- 转到管理 → 设置 → 插件
- 搜索“discourse-ai”并确保已启用
- 启用
ai_embeddings_enabled以激活 Embeddings - 启用
ai_embeddings_semantic_related_topics_enabled以激活相关主题功能
其他配置
根据您的设置,您可能需要调整以下设置:
- 对于非英语网站(Discourse 托管或自托管并使用自有模型):
将ai embeddings model设置为multilingual-e5-large - 对于 Cloudflare Workers AI:
将ai embeddings model设置为bge-large-en - 对于 OpenAI 或 Azure OpenAI:
将ai embeddings model设置为text-embedding-ada-002
技术常见问题解答
展开查看相关主题架构图
概述是,当创建/更新主题时,会发生以下情况:
sequenceDiagram
User->>Discourse: 创建主题
Discourse-->>Embedding Microservice: 生成 embeddings
Embedding Microservice-->>Discourse:
Discourse-->>PostgreSQL: 存储 Embeddings
在访问主题期间:
sequenceDiagram
User->>Discourse: 访问主题
Discourse-->>PostgreSQL: 查询最接近的主题
PostgreSQL-->>Discourse:
Discourse->>User: 展示相关主题
相关主题如何工作?
- 当用户访问一个主题时,Discourse 会根据其嵌入表示在数据库中查询语义上最相似的主题。然后将这些相关主题呈现给用户,鼓励他们进一步探索社区的内容。
主题/帖子数据如何处理?
- 对于 Discourse 托管的网站,数据在我们的安全虚拟专用数据中心内处理。对于自托管的网站,数据处理取决于您选择的第三方提供商。
Embeddings 数据存储在哪里?
- Embeddings 数据与主题、帖子和用户等其他论坛数据一起存储在您的 Discourse 数据库中。
使用了什么语义模型,它是如何训练的?
- Discourse 托管的网站默认使用 all-mpnet-base-v2 模型。该模型在小众和通用社区中都表现良好。自托管网站可能会根据其选择的提供商使用不同的模型。