为qwen-audio-agent搭建知识库完全指南让你的语音Agent基于自己的文档回答【免费下载链接】qwen-audio-agentA realtime voice runtime that keeps Agents talking, working, and present. Real-time Voice Runtime for AI Agents项目地址: https://gitcode.com/gh_mirrors/qw/qwen-audio-agentqwen-audio-agent 是一个面向 AI Agent 的实时语音运行时让语音助理能够持续对话、持续工作、持续在线。它的知识库功能可以让你的语音 Agent 不再凭空回答而是基于你自己导入的文档来检索证据、组织答案——无论是产品手册、公司内部制度还是项目资料都能在语音对话中被直接问到。本文将带你用最少的步骤完成从启用知识库、导入文档到语音提问验证的完整流程并介绍如何接入 LightRAG 获得更强的语义检索能力。为什么语音 Agent 需要知识库没有知识库时语音前台Realtime Frontstage只能依靠模型的通用能力回答问题。而接入知识库后整个链路变成你用麦克风提问语音前台判断需要查证调用knowledge工具检索知识库返回命中的原文片段带来源引用语音前台基于这些片段组织回答并语音播报。这种设计的两个好处回答有据可查检索结果会被标注为不可信数据并由前台统一规范化避免编造文档内容知识库可替换系统只依赖一个轻量的KnowledgeProvider接口你可以用内置的本机资料库也可以接企业已有的 RAG 系统而无需改动语音前台。完整接口说明见 知识库 Provider。一键启用开启内置知识库内置资料库使用轻量本地关键词检索不需要向量数据库也不需要 Embedding 模型是新手最省心的起点。第 1 步修改 Gateway 使用的config.envQWEN_AUDIO_DOMAIN_LIBRARYon这个变量在 .env.example 中有对应注释说明开启后如果没有另外注入自定义的knowledgeProvider内置的本机资料库会自动成为知识库 Provider。第 2 步确认知识工具未被显式关闭如果你之前设置过QWEN_AUDIO_KNOWLEDGE_TOOL_ENABLEDfalse请恢复为true或删掉这一行。否则会出现资料能导入、但语音前台没有检索工具的情况。第 3 步重启 Gateway按照你的运行方式重启即可桌面端、TUI 或独立 Gateway 进程。重启后语音 Provider 需支持工具调用知识库工具才会注册生效。详细步骤可参考官方文档 知识库指南。导入文档支持哪些格式Gateway 启动后打开WebUI连接同一个 Gateway点击页面顶部的知识库 / Knowledge Library面板对应源码 KnowledgeLibraryPanel.jsx粘贴一个Gateway 主机上的绝对文件路径例如/Users/me/Documents/handbook.md点击Add to library加入资料库等待导入完成文档出现在列表中后就可以开始提问了。 小提示路径管理器复制来的带引号路径、file://形式的 URL 也支持但都指向 Gateway 所在主机的文件。它不是文件上传器——手机上的文件路径对电脑无效请先将文档放到 Gateway 主机上。不同格式的处理方式文件类型处理方式Markdown、TXT 等纯文本直接导入本机资料目录无需后台 AgentPDF、Word、PPT 等复杂文档由已配置的后台 Agent 在隔离会话中转换为 Markdown 后入库如果系统里没有可用的后台 Agent 或隔离执行能力纯文本文件仍可正常导入复杂文档则会明确提示当前没有可用转换器此时你可以先把文档手动转成 Markdown 或 TXT 再导入。几个实用限制内置资料库默认最多容纳40 篇文档达到上限时会提示你清理而不是悄悄丢弃旧文档删除只删除资料库中的副本和可检索内容不会动原始文件源文件更新后不会自动同步需要重新导入。语音提问验证知识库是否生效导入完成后直接用自然语言提问即可。建议的问法是把查资料库作为前缀例如搜一下资料库手册里关于发布流程是怎么说的内置的关键词检索会扫描文档的标题与正文块返回命中的原文片段再由语音前台组织成自然回答。如果检索效果不理想可以试试使用文档里出现过的原词提问关键词检索对同义替换不敏感把问题问得更具体而不是大而全的概括式提问。⚠️ 注意如果你使用的是云端语音模型检索到的原文片段会作为上下文发送给该模型参与回答。导入敏感文档前请确认模型服务符合你的数据合规要求。进阶玩法接入 LightRAG 获得语义与图谱检索内置资料库是关键词检索适合中小规模文档。如果你需要完整的语义检索 知识图谱仓库提供了一个完整的外部知识库接入示例examples/lightrag。它的工作方式组件职责qwen-audio-agent Gateway实时语音对话、知识工具、入库任务生命周期LightRAG Provider示例代码把 LightRAG API 映射为通用KnowledgeProvider接口你独立运行的 LightRAG Server文档解析、切分、Embedding、图谱与检索核心流程用uv tool install lightrag-hku[api]安装并启动 LightRAG Server → 在 examples/lightrag/.env.local 中填写LIGHTRAG_URL、LIGHTRAG_API_KEY等配置 → 运行示例 Gatewaynode --env-fileexamples/lightrag/.env.local examples/lightrag/gateway.mjs→ 打开 WebUI 的资料库面板导入文件等待索引完成即可语音查询。接入代码入口见 gateway.mjs它在创建 Gateway 应用时只替换了knowledgeProvider其余语音链路完全不变——这正是 Provider 抽象的价值换知识库不改语音前台。更多可替换方案LangChain、LlamaIndex、Haystack、企业 RAG 服务、MCP/HTTP见 Knowledge Provider 接口文档。常见问题 FAQ问知识库数据存在哪里内置资料库的数据存放在 Gateway 主机本地的共享数据目录中不依赖任何外部数据库。问桌面端小球Desktop Orb为什么没有知识库管理入口目前资料库管理入口只在 WebUI 中提供桌面端和会话面板暂未开放该按钮。请用 WebUI 管理文档。问知识工具为什么没生效按顺序检查①QWEN_AUDIO_DOMAIN_LIBRARYon是否已设置并重启②QWEN_AUDIO_KNOWLEDGE_TOOL_ENABLED是否被设为false③ 语音 Provider 是否支持工具调用。问想删掉某篇文档怎么办在 WebUI 资料库面板点击 Remove删除的是资料库副本原始文件不受影响。相关文件速查内容路径知识库使用指南中文docs/guides/knowledge.zh.mdKnowledge Provider 接口参考docs/reference/knowledge.zh.md内置知识库服务实现server/src/knowledge/LightRAG 接入示例examples/lightrag/WebUI 资料库面板web/src/KnowledgeLibraryPanel.jsx环境变量模板.env.example按照以上步骤你只需要一个QWEN_AUDIO_DOMAIN_LIBRARYon的配置项和几次点击就能让语音 Agent 真正读懂你的文档。当文档规模增长或需要语义级检索时再平滑升级到 LightRAG 等外部知识系统即可。【免费下载链接】qwen-audio-agentA realtime voice runtime that keeps Agents talking, working, and present. Real-time Voice Runtime for AI Agents项目地址: https://gitcode.com/gh_mirrors/qw/qwen-audio-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考