目前“接入腾讯知识库”有 3 条主流路径,分别面向「零代码运营者」「低代码开发者」和「专业后端团队」。您只需按自己的场景对号入座,10-30 分钟就能跑通。下面把最新(2025-04 以后)实测可用的完整步骤、入口地址和注意事项一次给您梳理清楚。


一、零代码方案:把「腾讯 ima 知识库」挂到公众号菜单
(适合:个人/企业公众号运营,想 0 开发拥有 AI 问答客服)

  1. 准备

    1. 电脑端安装 ima copilot(ima.qq.com)→ 微信扫码登录

    2. 左侧「个人知识库」→ 批量上传 PDF/Word/图片或右键新建文件夹,把资料拖进去即完成向量化

    3. 右上角「分享」→ 复制小程序路径(形如:pages/index/index?k=xxx

  2. 挂接到公众号

    1. 登录微信公众平台 → 自定义菜单 → 新增子菜单

    2. 动作选「跳转小程序」→ 搜索「ima 知识库」→ 把刚才复制的路径粘到「小程序路径」

    3. 保存并发布。粉丝点菜单即可直接向您的知识库提问

  3. 小技巧

    • 资料更新后点「重新索引」,前端无需重新发布

    • 同一知识库可绑定多个公众号/小程序,支持权限分级(只读/可写)


二、低代码方案:腾讯「元器」+ 混元大模型,3 步生成可 API 调用的智能体
(适合:需要网页/小程序/微信群嵌入,且想定期自动同步公众号文章)

  1. 创建知识库
    浏览器打开 yuanqi.tencent.com → 登录 → 左侧「知识库」→ 新建
    支持 3 种数据源:

    • 「公众号文章」- 扫码授权后自动拉取历史图文

    • 「本地文件」- 批量上传 PDF/Word/Markdown

    • 「在线表格」- 粘贴腾讯文档链接即可

  2. 创建智能体
    左侧「智能体」→ 新建 → 选模型(混元/DeepSeek)→ 在「上下文」里勾选「添加知识库」→ 选中刚才的知识库 → 保存
    右侧「预览」里直接提问测试,回答均来自您上传的资料

  3. 发布 & 接入

    • 发布渠道同时勾选「H5 链接」「小程序」「API」即可拿到:
      – H5 链接:嵌入公众号文章、企业微信客服、飞书机器人
      – API:复制 Token+URL,用 3 行代码在 Web/小程序/Node.js 里调用

    • 支持定时重新抓取公众号更新,知识库自动增量同步


三、专业方案:本地部署「WeKnora」RAG 引擎,暴露标准检索 API
(适合:内网/私有云、对数据敏感、需要深度定制召回策略)

  1. 一键本地启动
    git clone https://github.com/Tencent/WeKnora
    docker-compose up -d
    默认会启 3 个服务:文件解析、向量索引、API 网关

  2. 上传 & 解析
    Web 端口 8080 → 新建知识空间 → 批量拖入 PDF/Word/图片
    自动 OCR+表格提取 → 生成向量 & 知识图谱双重索引

  3. 接入业务系统

    • 标准 REST/JSON API:
      POST /v1/retrieve
      {“query”:”腾讯云的轻量服务器有哪些镜像?”,”topk”:5}

    • 返回带段落坐标、文件名、score,方便高亮溯源

    • 支持关键词、向量、图谱混合召回,可插拔改写


四、常见疑问速答

Q1. 敏感文件放云端是否安全?
ima/元器均支持「私有库」模式,索引数据存在腾讯云,默认加密;如合规要求更高,可选方案三本地部署。

Q2. 能否把「腾讯文档」当知识库,自动同步?
可以。用「集简云」无代码平台:触发器选「腾讯文档-内容更新」→ 执行动作选「元器/ima-增量索引」即可,全程拖拽配置。

Q3. 已有客服小程序,只想增加知识库问答,要改前端吗?
不需要。元器提供「嵌入式 SDK」:

  • Web/H5 引入 <script src="https://cdn.yuanqi.tencent.com/sdk/1.x/ai-agent.js">

  • 小程序安装 npm 包 @tencent/yuanqi-agent,3 行代码完成接入。


一句话总结

  • 想最快上线 → 用 ima 知识库 + 公众号菜单,10 分钟搞定

  • 需要持续同步公众号文章 → 用「腾讯元器」生成智能体,一键发布 H5/小程序/API

  • 数据必须本地、策略深度定制 → 拉 WeKnora 镜像,私有部署后当内部 RAG 中台用

照着上面 3 条路径任选其一,就能完成「腾讯知识库」的接入与对外服务。祝搭建顺利!

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐