跳到主要内容

在MaxKB中使用

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

背景​

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

48

主要特点

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

前提条件​

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

操作步骤​

获取访问令牌​

目前系统支持两类DeepSeek接口，用户可根据业务需求选择购买API，开通DeepSeek API的详细操作步骤如下所示。

开通体验版DeepSeek API服务​

用户首次开通DeepSeek大模型推理服务时，可选择该类型的API，开通步骤如下所示。

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

    注册2

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

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

    注册3

注意

如果用户勾选了“到期后自动开通基础版，按量计费”选项，则体验版API 30天到期后，基础版API开始生效。

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

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

    注册4

  3. 支付完成后，进入API Key详情页面，进入方式如下所示。进入页面后单击“新建API Key”按钮，系统弹窗API Key的信息，例如：调用地址、API Key等。单击“确定”按钮，即可完成API Key创建操作。

  • 用户返回第3/4步骤的页面，在[服务开通成功]提示窗口单击“立即创建”按钮，进入API Key详情页面。

  • 用户点击[产品中心/大模型推理服务/API Key]菜单项，进入API Key详细页面。

    注册4

重要
  • 体验版API按包年包月计费，一个账户可以创建1个API。
  • 企业账户每个体验版DeepSeek API Key每天至多支持调用1000次。

开通基础版DeepSeek API服务​

  1. 用户通过企业账户登录Alaya NeW官网，选择[产品/大模型推理服务]菜单项，进入大模型推理服务概览页面。

  2. 在上述页面单击“立即开通API服务”按钮，进入API购买概览页面，选择“DeepSeek API基础版”产品，在产品概览页面用户可查看大模型推理服务API的相关信息。

    注册3

信息

DCU（DataCanvas Unit）是算力服务的基本计量计费单位，代表用户通过Alaya NeW使用智算服务的工作负荷计量值。1 DCU = 3600 mDCU。

  1. 信息确认无误后，勾选“我已阅读并同意《用户协议》和《隐私政策》”选项，单击“立即开通”按钮，弹窗提示“服务开通成功”。

  2. 在提示弹窗单击“立即创建”按钮，进入API Key页面，单击“新建API Key”，进入API Key新建页面，填写标签值。

  3. 标签值新建完成后，单击“确定”按钮，系统弹窗“创建Key”，如下图所示，用户可获取调用地址、API Key，该凭证将会发送到用户注册时填写的手机号码上。用户在后续的应用中，可以使用已获取的API Key来安全地调用DeepSeek大模型服务。

注册4

重要

基础版API按量计费，一个账户最多可以创建10个API。

更新API Key​

  1. 用户通过企业账户登录Alaya NeW官网，选择[产品中心/大模型推理服务/API Key]菜单项，进入API Key列表页面。
  2. 找到要更新的API Key，单击操作列的“更新”按钮，在弹出的更新提示窗口单击“确定”按钮，即可获取新的API Key，此凭证将作为调用大模型服务的鉴权凭证。

注册3

提示

企业每个自然日仅可更新一次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