跳到主要内容

在MaxKB中使用

本文以大模型服务中的DeepSeek-R1满血版为例，向用户介绍如何在MaxKB中添加并使用平台提供的模型服务。

背景​

MaxKB，即Max Knowledge Base，是一款基于大语言模型和RAG的开源知识库问答系统，广泛应用于智能客服、企业内部知识库、学术研究与教育等场景。

48

主要特点

  • 开箱即用：支持直接上传文档/自动爬取在线文档，支持文本自动拆分、向量化和RAG（检索增强生成），有效减少大模型幻觉，智能问答交互体验好。
  • 快速接入：内置强大的工作流引擎和函数库，支持编排AI工作过程，满足复杂业务场景下的需求。
  • 灵活编排：支持零编码快速嵌入到网站、办公系统（企业微信/钉钉/飞书）和第三方业务系统，让已有系统快速拥有智能问答能力，提高用户满意度。
  • 模型中立：支持对接各种大语言模型，包括本地私有大模型（DeepSeek/Llama/Qwen等）、国内公共大模型（通义千问/智谱AI/Kimi等）和国外公共大模型（OpenAI/Claude/Gemini等）。

前提条件​

  • 用户已经获取Alaya New企业账户和密码，如果需要帮助或尚未注册，可参考账户注册完成注册。
  • 用户已下载并安装MaxKB。

操作步骤​

获取访问令牌​

  1. 用户通过企业账户登录Alaya NeW官网，如下图所示。

    注册2

  2. 选择[产品/大模型推理服务]菜单项，进入大模型推理服务概览页面。

  3. 在上述页面单击“立即开通API服务”按钮，进入API购买概览页面，在概览页面用户可查看DeepSeek大模型服务API的相关信息。

    注册3

  4. 信息确认无误后，勾选“我已阅读并同意《用户协议》和《隐私政策》”选项，单击“立即支付”按钮，系统会打开新标签页。

  5. 在新的标签页用户可根据页面指引，如下图所示，完成订单支付。支付成功后，系统会跳转至订单管理页面，用户可查看对应的订单详情。

    注册4

  6. 用户可通过如下方式创建API Key。创建完成后页面如下图所示。

  • 用户点击[返回首页/产品/大模型推理服务]菜单项，进入访问令牌创建页面，单击“立即创建”按钮，即可创建专属API Key。

  • 返回第3步的页面，页面会弹出[服务开通成功]提示窗口，在该窗口单击“创建”按钮，即可创建专属API Key。

    注册4

该凭证将会发送到用户注册时提供的手机号码上。用户在后续的应用中，可以使用已获取的API Key来安全地调用DeepSeek大模型服务。

重要

企业账户每个API Key每天至多支持调用1000次。

更新API Key​

  1. 用户通过企业账户登录Alaya NeW官网，选择[产品/大模型推理服务]菜单项，进入大模型推理服务页面。
  2. 单击“更新”API Key按钮，系统会弹出更新提示，如果用户确认更新，单击“确定”按钮，即可获取新的API Key，此凭证将作为新的调用大模型服务的鉴权凭证。
提示
  • 如果用户丢失已生成的API Key，可参考获取访问令牌的“更新API Key”章节步骤获取新的鉴权凭证。
  • 企业每个自然日仅可更新一次API Key，更新后，原有的API Key将失效。

配置模型服务​

  1. 访问MaxKB系统地址，输入账号密码后登录。

  2. 在顶部导航栏，选择[系统设置/模型设置]，并点击“添加模型”。

    49

  3. 在弹出的新窗口中，配置各项参数，单击“保存”按钮。

提示

如需要继续添加其他模型，则继续参考如上方式添加模型按钮即可。

  • 模型提供方：此处选择OpenAI即可。
  • 模型名称：用户可自定义。
  • 权限：选择私有或公有，本示例此处选择私有。
  • 模型类型：此处选择大语言模型。
  • 基础模型：本实践为DeepSeek-R1。
  • API URL：此处直接填写https://deepseek.alayanew.com/v1 即可。
  • 用户在获取访问令牌操作中复制得到的完整API密钥，需根据实际情况进行修改。

创建知识库​

  1. 在顶部导航栏，选择[知识库页签]，点击[创建知识库]。

  2. 在弹出的创建知识库窗口中，配置各项参数，点击“创建”。

    50

  • 知识库名称：用户可自定义。
  • 知识库描述：针对当前知识库的描述信息，用户可自定义。
  • 向量模型：选择平台已有的模型即可。
  • 知识库类型：支持选择通用型文档或Web站点，本示例选择Web站点。
    • 若选择通用型，则根据页面提示上传本地文档即可。
    • 若选择Web站点，则需配置Web根地址。

  1. 系统将自动开启爬取文档功能，耐心等待所有状态完成即可。

    51

构建应用​

  1. 在顶部导航栏，选择[应用页签]，点击[创建应用]。

  2. 在弹出的界面中，配置各项参数。如需进行测试，可直接在右侧调试预览窗口，输入相关问题。若无需测试，直接点击右上角的“保存并发布”即可。

    52

  • 应用名称：用户自定义。
  • 应用描述：针对当前应用的描述信息，用户自定义。
  • AI模型：选择已添加的模型，本实践为DeepSeek-R1，用户也可根据实际需要选择其他LLM大语言模型。
  • 系统角色：根据自己需求填写或留空。
  • 关联知识库：点击“添加”，选择上一步创建的知识库进行关联即可。
  • 开场白：用户可自定义。

  1. 返回系统首页，选择[应用]页签，选择上一步创建的应用，即可进行对话。

    53