使用文档知识助手

知识助手

查询项目文档和任务信息,查看引用来源,并确认需要执行的修改。

配置模型与检索

管理员在网页管理界面配置兼容模型和嵌入供应商。聊天模型负责回答问题和提出修改建议,嵌入模型用于语义检索。模型可用性取决于你配置的供应商、凭据和网络。

知识助手位于产品的 /assistant。可以检索账号可访问的多个项目,也可以将会话限定在一个项目内。

提问

先说明项目范围、目标和希望得到的输出,例如:

结合方案文档和当前迭代,整理本次上线风险,列出相关工作项,并注明依据。

助手查询文档及实时业务信息。检索遵循当前账号、项目、文档和令牌权限;助手不会返回无权访问的项目内容。

Feronavi 知识助手Feronavi 知识助手

阅读答案与来源

回答支持流式输出、Markdown 和 Mermaid 图表。引用可以返回原始项目文档。使用重要结论前,打开来源检查适用范围与当前状态。

没有检索结果时,检查项目范围和文档权限。模型不可用时,检查供应商配置与网络。缺少向量检索服务时,可以回退到关键词检索;接口的 mode 字段会返回当前检索方式。

确认业务修改

查询与分析可以直接执行;业务修改先生成建议。核对目标、原值、新值和影响范围后,再确认执行或拒绝。

建议有有效期,并在执行时重新核对权限和目标版本。发生冲突或权限变化时,重新提问并检查新的建议。

管理会话

会话按账号保存在服务端,支持切换、重命名、软删除和恢复。刷新或重新登录后可恢复已保存内容。会话创建后的项目范围固定,需要切换范围时建立新会话。

取消生成会停止后续处理,但不会删除已经保存的问题。失去原资源权限后,相关回答也会根据当前访问权限隐藏。

对外接入

同一套检索能力可通过 MCP 的 rag.projects、rag.search、rag.chat 使用。REST 的 OpenAPI 3.1 描述位于实例的 /api/v1/openapi.json。

读取与检索可以用只读令牌;持久会话的发送、命名和删除等操作需要对应的写入权限。外部 Agent 连接方式见 MCP 接入。

输入关键词,搜索全部使用文档。