更新时间:2025-08-21 GMT+08:00

开通KooSearch文档问答服务

KooSearch支持使用文档上传并进行知识问答。在使用KooSearch文档问答前需要开通服务。

仅“香港”和“新加坡”区域支持开通和使用KooSearch服务。KooSearch是公测阶段,如果有试用需求,请提工单申请权限。

进入KooSearch控制台

  1. 登录云搜索服务管理控制台
  2. 在左侧导航栏选择“KooSearch>KooSearch文档问答”,进入KooSearch文档问答页面。
  3. 选择已创建好的文档问答服务,单击操作列的“问答”,前往KooSearch控制台。

开通KooSearch服务

  1. 进入KooSearch页面后,单击“服务开通”,进入服务开通页面。
  2. 填写KooSearch服务的服务配置。
    • 基础配置
      表1 基础配置参数说明

      参数

      说明

      计费模式

      服务支持包年/包月和按需计费两种模式。

      • 按需计费:按实际使用时长计费,计费周期为一小时,不足一小时按一小时计费。
      • 包年/包月:根据服务购买时长,一次性支付集群费用。最短时长为1个月,最长时长为1年。

      订购周期

      选择包年/包月计费模式后,需要选择购买时长。

      您可以根据需求,选择是否需要自动续费。

      产品规格

      支持敏捷版、基础版、专业版、企业版。

      当前区域

      下拉框中选择KooSearch服务的工作区域。

      不同区域的资源之间内网不互通,请选择靠近您业务的区域,可以降低网络时延,提高访问速度。

      服务名称

      自定义服务名称。

    • 创建向量集群

      负责业务数据的存储与查询。当前仅支持创建云搜索服务中Elasticsearch 7.10.2版本的集群。配置集群参数,开通文档问答服务后,会根据集群配置自动创建集群。

      表2 向量集群参数说明

      参数

      说明

      节点数量

      向量集群中的节点个数。可选节点数为1~32,建议节点数为3或3以上,以提升集群可用性。

      CPU架构

      目前支持“X86计算”“鲲鹏计算”两种类型。具体支持的类型由实际区域环境决定。

      可用区

      选择集群工作区域下关联的可用区。

      节点规格

      选择集群的节点规格。规格的详细说明可参考弹性云服务器的实例类型与规格

      节点存储

      选择节点的存储类型,支持普通I/O、高I/O、超高I/O。

      节点存储容量

      选择节点的存储空间大小,其取值范围与节点规格关联,不同的规格允许的取值范围不同。

      节点存储容量只支持配置为20的倍数。

      磁盘加密

      选择节点的数据盘是否进行KMS加密存储。

      启用磁盘加密可以加强集群节点中存储的数据安全性。默认为不启用。

      启用磁盘加密后,需要配置“密钥名称”,即在下拉框中选择启用状态的KMS密钥,如果没有可用的密钥,可以单击“创建密钥”跳转至数据加密控制台,创建或修改密钥。详细操作指导请参见创建密钥

      说明:
      • 仅云盘支持磁盘加密,本地盘不支持。
      • 仅支持使用“密钥算法”为AES或SM4、“密钥用途”“ENCRYPT_DECRYPT”的自定义密钥,“密钥名称”下拉框中不可见的KMS密钥表示集群不支持。
      • 磁盘加密不会改变集群的管理和运维操作流程,但数据加解密环节会增加系统处理开销,可能会对操作性能产生一定影响。
      • 集群创建成功后不支持重新开启或关闭磁盘加密。
      • 集群创建成功后不支持修改密钥。
      • 当集群使用的KMS密钥处于非启用状态时,集群扩容、升级、节点规格变更、指定节点替换及可用区切换的操作将失败,需通过新建集群并完成数据迁移实现业务变更。

      安全模式

      选择是否开启集群安全模式。

      • 默认开启,则创建的是安全模式的集群。安全模式的集群会对集群进行通讯加密和安全认证。因此必须配置集群的“管理员账户名”“管理员密码”
        • 管理员账户名默认为admin。
        • 设置并确认管理员密码。要记住设置的密码,后续访问集群需要输入密码。
      • 不开启,则创建的是非安全模式的集群。非安全模式的集群无需安全认证即可访问,并且采用HTTP明文传输数据。建议确认访问环境的安全性,勿将访问接口暴露到公网环境上。
    • 搜索模型配置(可选)
      • 开关打开:开通KooSearch文档问答服务时会自动创建文本向量模型服务和精排模型服务。
      • 开关关闭:开通KooSearch文档问答服务就不会自动创建文本向量模型服务和精排模型服务,会影响KooSearch知识库的使用。如有需要,可以在模型管理页面自定义配置“搜索Embedding模型”“搜索精排模型”“缓存生成模型”,具体操作请参见创建和管理KooSearch模型服务(可选)
      表3 搜索模型参数说明

      参数

      说明

      文本向量和精排推理实例

      选择文本向量和精排推理实例个数。

      模型分类

      选择搜索模型的模型分类。

      实例规格

      选择搜索模型的实例规格,当前支持“昇腾算力”“GP加速型”

      可用区

      “实例规格”选择“GP加速型”时,选择搜索模型工作区域下关联的可用区。

      节点规格

      选择搜索模型的节点规格。规格的详细说明可参考弹性云服务器的实例类型与规格

      节点存储

      “实例规格”选择“GP加速型”时,需要选择节点的存储类型,支持普通I/O、高I/O、超高I/O。不同可用区和实例规格所支持的存储类型不同,具体支持的存储类型由实际区域环境决定。

      节点存储容量

      “实例规格”选择“GP加速型”时,需要设置节点的存储空间大小,其取值范围与节点规格关联,不同的规格允许的取值范围不同。

    • 搜索规划配置(可选)
      • 开关打开:开通KooSearch文档问答服务时会自动创建搜索规划的模型服务,该模型服务提供意图识别和query改写功能。
      • 开关关闭:开通KooSearch文档问答服务就不会自动创建搜索规划的模型服务,会影响KooSearch知识库的使用。如有需要,可以在模型管理页面自定义配置“搜索规划模型”,具体操作请参见创建和管理KooSearch模型服务(可选)
      表4 搜索规划参数说明

      参数

      说明

      搜索规划推理实例

      选择搜索规划推理实例个数。

      模型分类

      选择搜索规划的模型分类。

      实例规格

      选择搜索规划的实例规格,当前支持“昇腾算力”“GP加速型”

      可用区

      “实例规格”选择“GP加速型”时,需要选择搜索规划推理实例工作区域下关联的可用区。

      节点规格

      选择搜索规划的节点规格。规格的详细说明可参考弹性云服务器的实例类型与规格

      节点存储

      “实例规格”选择“GP加速型”时,需要选择节点的存储类型,支持普通I/O、高I/O、超高I/O。不同可用区和实例规格所支持的存储类型不同,具体支持的存储类型由实际区域环境决定。

      节点存储容量

      “实例规格”选择“GP加速型”时,需要设置节点的存储空间大小,其取值范围与节点规格关联,不同的规格允许的取值范围不同。

    • 大模型配置(可选)
      • 开关打开:开通KooSearch文档问答服务时会自动创建预置的LLM大模型服务。
      • 开关关闭:开通KooSearch文档问答服务就不会自动创建预置的LLM大模型服务,会影响KooSearch问答功能的使用。如有需要,可以在模型管理页面自定义配置“NLP模型-*”,具体操作请参见创建和管理KooSearch模型服务(可选)
      表5 大模型配置参数说明

      参数

      说明

      模型版本

      当前提供koosearch-rag,基于开源大模型SFT优化后,构建的检索增强大模型,提升检索增强生成场景下的准确率。

      生成模型推理实例

      选择生成模型推理实例个数。

      模型分类

      选择生成模型推理实例的模型分类。

      实例规格

      选择生成模型推理实例规格,当前支持“昇腾算力”“GP加速型”

      可用区

      “实例规格”选择“GP加速型”时,选择生成模型推理实例工作区域下关联的可用区。

      节点规格

      选择大模型的节点规格。规格的详细说明可参考弹性云服务器的实例类型与规格

      节点存储

      “实例规格”选择“GP加速型”时,需要选择节点的存储类型,支持普通I/O、高I/O、超高I/O。不同可用区和实例规格所支持的存储类型不同,具体支持的存储类型由实际区域环境决定。

      节点存储容量

      “实例规格”选择“GP加速型”时,需要设置节点的存储空间大小,其取值范围与节点规格关联,不同的规格允许的取值范围不同。

    • 所属企业项目

      如果您开通了“企业项目”,在创建集群时,可以给服务绑定一个企业项目。您可以在右侧下拉框中选择当前用户下已创建的企业项目,也可以通过单击“查看项目管理”按钮,前往“企业项目管理”管理控制台,新建企业项目和查看已有的企业项目。

  3. 单击“下一步”,设置服务的网络配置。
    表6 参数说明

    参数

    说明

    虚拟私有云

    VPC即虚拟私有云,是通过逻辑方式进行网络隔离,提供安全、隔离的网络环境。

    选择创建集群需要的VPC,单击“查看虚拟私有云”进入VPC服务查看已创建的VPC名称和ID。如果没有VPC,需要创建一个新的VPC。

    说明:

    此处您选择的VPC必须包含网段(CIDR),否则集群将无法创建成功。新建的VPC默认包含网段(CIDR)。

    子网

    通过子网提供与其他网络隔离的、可以独享的网络资源,以提高网络安全。

    选择创建集群需要的子网,可进入VPC服务查看VPC下已创建的子网名称和ID。

    安全组

    指定集群使用的安全组,安全组起着虚拟防火墙的作用,为集群提供安全的网络访问控制策略。

    选择合适的安全组,单击“查看安全组”可以跳转到安全组列表,了解安全组详情。

    所选安全组的入方向规则中,“协议端口”必须包含30275和30277的端口范围,否则外部业务访问可能会异常。

  4. 单击“下一步”,确认配置信息。
  5. 单击“确认开通”

    系统跳转至“KooSearch文档问答”页面,您开通的服务将展现在服务列表中,且服务状态为“创建中”,创建成功后服务状态会变为可用

    如果服务开通失败,请根据界面提示,重新开通服务。