本文将以智算平台上大模型服务中的 DeepSeek-V3 为例,向用户介绍如何在 Obsidian 中使用 Copilot 插件调用相应模型,为自己本地知识库搭建 AI 助手。

背景信息

Obsidian 是一款基于 Markdown 的本地知识管理工具,通过双向链接与知识图谱高效构建个人知识库,支持插件扩展且注重隐私与离线使用。

Copilot 一款开源的 LLM 界面插件,设计简洁,使用方便。支持自带 API 密钥或本地模型;支持自定义提示,可快速与整个笔记库对话,获取答案和见解。旨在打造一个真正理解用户个人知识库的终极 AI 助手,同时注重隐私保护。

DeepSeek-V3 模型是一款拥有 6710 亿参数的混合专家(MoE)语言模型,采用多头潜在注意力(MLA)和 DeepSeekMoE 架构,结合无辅助损失的负载平衡策略,优化推理和训练效率。

前提条件

用户已提前下载并安装 Obsidian 客户端

操作步骤

获取 API 密钥和域名

  1. 登录控制台

  2. 在顶部导航栏,选择产品与服务 > 大模型服务 > 大模型服务平台

    model enter
  3. 进入大模型服务管理页面,在左侧导航栏中选择 API 密钥管理,用户可直接获取 API 域名API 路径,点击相应按钮即可创建和获取 API 密钥。

    说明
    • 当前平台上的预置模型的 API 域名为 https://openapi.coreshub.cn/v1,用户可直接使用无需修改。

    • 若平台内无可用的 API 密钥,用户可参考前文内容创建和获取新的 API 密钥。

    • 若平台内已有可用的 API 密钥,用户可直接将鼠标悬停在指定密钥上,点击 API 密钥右侧的复制按钮,即可获取完整的 API 密钥。

    model api get

安装 Obsidian Copilot

  1. 启动 Obsidian 客户端,点击知识仓库区域的设置按钮。

    model obsidian 1
  2. 在弹出的新窗口中,选择第三方插件,点击社区插件市场浏览按钮。

    注意

    首次安装第三方插件,可能会有数据和隐私安全提示风险,用户直接点击关闭安全模式即可。

    model obsidian 2
  3. 在搜索框中输入 Copilot,选中后并点击安装。安装成功后,并点击启用

    model obsidian 3

配置 Obsidian Copilot

  1. 延续上述操作。

  2. 返回设置页面,Copilot 已显示在第三方插件列表中,点击该插件进入其设置页面。

    model obsidian 4
  3. 选择 Model 页签,在 Chat Models 模块,点击 Add Custom Model,设置 LLM 模型。

    model obsidian 5
  4. 在弹出的 Add Custom Chat Model 窗口中,配置各项参数,点击 Verify,若界面右上角提示 Model verification successful!,则点击 Add Model 即可。

    model obsidian 6
    • Model Name:模型名称,LLM 模型本实践中使用 DeepSeek-V3。若需使用平台内其他大语言模型,用户仅需在智算平台的在线推理服务页面,复制得到相应模型名称即可。

    • Display Name:界面中显示的名称,用户自定义,可直接填写服务商的名字,如基石智算

    • Provider:模型服务商,智算平台兼容 OpenAI 格式,故此处选择 OpenAI Format

    • Base URl:智算平台上的预置模型的 API 域名为 https://openapi.coreshub.cn/v1,用户可直接使用无需修改。

    • API Key:用户在获取 API 密钥和域名操作中复制得到的完整 API 密钥,需根据实际情况进行修改。

    • Model Capabilities:模型能力,根据实际情况进行勾选即可。

    • 其他参数,用户可根据实际情况进行修改或保持默认。

  5. 下拉 Copilot 设置页面,在 Embedding Models 模块,点击 Add Custom Model,设置 Embedding 模型。

    model obsidian 7
  6. 在弹出的提示窗口中,参考第 4 步操作,填写相应参数,注意此处 Model Namebce-embedding-base_v1,其他参数保持一致即可。

在使用 Copilot 中使用相应模型

  1. 延续上述操作。

  2. 打开本地知识库,点击左侧 Copilot 标识,启动相应插件。

    model obsidian 8
  3. 在对话框中,选择前文配置的模型,输入相应问题,即可使用基于智算平台上的模型和本地知识库进行检索和问答。

    model obsidian 9