# 开通KooSearch文档问答服务 在使用KooSearch文档问答服务前需要开通服务。 ![](https://support.huaweicloud.com/usermanual-koosearch/public_sys-resources/note_3.0-zh-cn.png) 仅"西南-贵阳一"区域支持开通和使用KooSearch服务。KooSearch是受限使用阶段，如果有试用需求，请提[工单](https://console.huaweicloud.com/ticket/?locale=zh-cn#/ticketindex/serviceTickets)申请权限。 #### 进入创建KooSearch页面 1. 登录[云搜索服务管理控制台](https://console.huaweicloud.com/elasticsearch/)。 2. 在左侧导航栏选择"KooSearch\>KooSearch文档问答"，进入KooSearch文档问答页面。 3. 单击"服务开通"，进入创建KooSearch文档问答服务页面。 #### 基础配置 配置集群基础参数。 表1基础配置参数说明 | 参数 | 说明 | |:---|:---| | 当前区域 | 下拉框中选择KooSearch服务的工作区域。 不同区域的资源之间内网不互通，请选择靠近您业务的区域，可以降低网络时延，提高访问速度。 | | 服务规格 | 支持以下四种规格。 - 敏捷版：适用于企业大规模团队，开箱即用，独立部署，性能更优，更安全。PDF和扫描件需要OCR智能文档解析服务额外按需计费。 - 基础版：适用于企业大规模团队，开箱即用，独立部署，性能更优，更安全。支持百万级文档，已经包含了2并发的OCR智能文档解析服务。 - 专业版：适用于企业大规模团队，开箱即用，独立部署，性能更优，更安全。支持百万级文档，已经包含了OCR智能文档解析服务。 - 企业版：适用于企业大规模团队，开箱即用，独立部署，性能更优，更安全。支持百万级文档，已经包含了OCR智能文档解析服务，支持效果调优。 | | 计费模式 | 服务支持包年/包月和按需计费两种模式。 - 按需计费：按实际使用时长计费，计费周期为一小时，不足一小时按一小时计费。 - 包年/包月：根据服务购买时长，一次性支付集群费用。最短时长为1个月，最长时长为1年。 | #### 创建向量数据库 向量数据库负责业务数据的存储与查询。配置数据库参数，开通文档问答服务后，会根据数据库配置自动创建向量数据库。 表2向量集群参数说明 | 参数 | 说明 | |:---|:---| | 可用区 | 指在同一地域下，电力、网络隔离的物理区域，可用分区之内内网互通，不同可用分区之间物理隔离。选择集群工作区域下关联的可用区。 | | CPU架构 | 目前支持"X86计算"和"鲲鹏计算"两种类型。具体支持的类型由实际区域环境决定。 | | 数据节点规格 | 单击"选择节点规格"，在弹框中选择合适的规格。 节点规格分为本地盘和云硬盘两种类型。各个规格的详细说明请参见[实例类型](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0035470096.html)《弹性云服务器用户指南》的实例类型章节。 规格列表的"vCPUs \| 内存"呈现了规格的CPU核数和内存，"建议存储范围"呈现了该规格支持的存储容量。 不同区域支持的节点规格不同，请以实际环境为准。 警告： 本地盘存在异常退出风险，可能导致数据丢失且不可恢复，因此不适用于核心业务数据存储场景。建议关键业务数据优先选用云硬盘存储。 | | 数据节点存储类型 | 选择节点的存储类型，支持：高I/O、超高I/O。不同可用区和实例规格所支持的存储类型不同，具体支持的存储类型由实际区域环境决定。建议选择超高I/O。 | | 数据节点存储容量 | 选择节点的存储空间大小，可选范围为100GB\~6400GB。 节点存储容量只支持配置为20的倍数。 | | 数据节点数量 | 向量数据库中的节点个数。可选节点数为1\~32，建议节点数为3或3以上，以提升集群可用性。 | | 安全模式 | 选择是否开启集群安全模式。 - 开启后，则创建的是安全模式的集群，访问集群需要安全认证，会影响数据的索引和搜索性能。必须配置集群的"管理员账户名"和"管理员密码"。 - **管理员账户名**默认为admin。 - 设置并确认**管理员密码**。要记住设置的密码，后续访问集群需要输入密码。 - 不开启，则创建的是非安全模式的集群。非安全模式的集群无需安全认证即可访问，并且采用HTTP明文传输数据。建议确认访问环境的安全性，勿将访问接口暴露到公网环境上。 | #### 文本向量化和排序（Text-Embedding-Rank）（可选） 支持多款不同语言、输入长度、输出维度的文本向量模型，提供 Query-to-Doc 与 Query-to-Query 两大核心能力；搭配精排模型提供 Query 与文档的相关性排序服务，可在 RAG 及搜索场景中显著提升检索准确度。 - 勾选"文本向量化和排序"：开通KooSearch文档问答服务时会自动创建文本向量模型服务和精排模型服务。 - 不勾选"文本向量化和排序"：开通KooSearch文档问答服务就不会自动创建文本向量模型服务和精排模型服务，会影响KooSearch知识库的使用。如后期有需要，可以在模型管理页面自定义配置"搜索Embedding模型"、"搜索精排模型"和"缓存生成模型"，具体操作请参见[创建及管理KooSearch模型服务](https://support.huaweicloud.com/usermanual-koosearch/koosearch_06_8001.html)。 表3文本向量化和排序参数说明 | 参数 | 说明 | |:---|:---| | 模型服务 | 根据列表内容选择需要的模型服务。 | | 节点类型 | 节点类型根据您选择的模型服务自动呈现。 | | 可用区 | 如果"节点类型"是GPU加速型，则需要选择可用区。可用区指在同一地域下，电力、网络隔离的物理区域，可用分区之内内网互通，不同可用分区之间物理隔离。选择模型工作区域下关联的可用区。 | | 节点规格 | 单击"选择节点规格"，在弹框中选择合适的规格。 节点规格分为本地盘和云硬盘两种类型。各个规格的详细说明请参见[实例类型](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0035470096.html)《弹性云服务器用户指南》的实例类型章节。 规格列表的"vCPUs \| 内存"呈现了规格的CPU核数和内存，"建议存储范围"呈现了该规格支持的存储容量。 不同区域支持的节点规格不同，请以实际环境为准。 警告： 本地盘存在异常退出风险，可能导致数据丢失且不可恢复，因此不适用于核心业务数据存储场景。建议关键业务数据优先选用云硬盘存储。 | | 节点存储类型 | 如果"节点类型"是GPU加速型，则需要选择节点的存储类型，GPU加速型支持：高I/O、超高I/O。不同可用区和实例规格所支持的存储类型不同，具体支持的存储类型由实际区域环境决定。建议选择超高I/O。 | | 节点存储容量 | 如果"节点类型"是GPU加速型，则需要设置节点的存储空间大小，默认配置40GB不支持修改。 | | 节点数量 | 设置集群中的数据节点个数。 输入值必须在1到32之间。建议节点数为3或3以上，以提升集群可用性。 | #### 搜索规划（Search-Plan）配置（可选） 基于大模型技术实现 Query 改写，可将复杂原始 Query 拆解为多个子问题，并完成 Query 分类判定；该能力应用于 RAG 场景，能显著提升检索精确度与答案生成效率。 - 开关打开：开通KooSearch文档问答服务时会自动创建搜索规划的模型服务，该模型服务提供意图识别和query改写功能。 - 开关关闭：开通KooSearch文档问答服务就不会自动创建搜索规划的模型服务，会影响KooSearch知识库的使用。如后期有需要，可以在模型管理页面自定义配置"搜索规划模型"，具体操作请参见[创建及管理KooSearch模型服务](https://support.huaweicloud.com/usermanual-koosearch/koosearch_06_8001.html)。 表4搜索规划参数说明 | 参数 | 说明 | |:---|:---| | 模型服务 | 根据列表内容选择需要的模型服务。 | | 节点类型 | 节点类型根据您选择的模型服务自动呈现。 | | 可用区 | 如果"节点类型"是GPU加速型，则需要选择可用区。可用区指在同一地域下，电力、网络隔离的物理区域，可用分区之内内网互通，不同可用分区之间物理隔离。选择模型工作区域下关联的可用区。 | | 节点规格 | 单击"选择节点规格"，在弹框中选择合适的规格。 节点规格分为本地盘和云硬盘两种类型。各个规格的详细说明请参见[实例类型](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0035470096.html)《弹性云服务器用户指南》的实例类型章节。 规格列表的"vCPUs \| 内存"呈现了规格的CPU核数和内存，"建议存储范围"呈现了该规格支持的存储容量。 不同区域支持的节点规格不同，请以实际环境为准。 警告： 本地盘存在异常退出风险，可能导致数据丢失且不可恢复，因此不适用于核心业务数据存储场景。建议关键业务数据优先选用云硬盘存储。 | | 节点存储类型 | 如果"节点类型"是GPU加速型，则需要选择节点的存储类型，GPU加速型支持：高I/O、超高I/O。不同可用区和实例规格所支持的存储类型不同，具体支持的存储类型由实际区域环境决定。建议选择超高I/O。 | | 节点存储容量 | 如果"节点类型"是GPU加速型，则需要设置节点的存储空间大小，默认配置40GB不支持修改。 | | 节点数量 | 设置集群中的数据节点个数。 输入值必须在1到32之间。建议节点数为3或3以上，以提升集群可用性。 | #### OCR增强 如果您选择的是"敏捷版"，则版本中没有包含OCR功能，需要您选择是否开通此功能，如果开通此功能，OCR增强插件会创建委托访问文字识别服务，需额外计费，您还需要开通文字识别的智能文档解析和通用文字识别功能，支持按需或套餐包购买。单击[控制台](https://console.huaweicloud.com/ocr/#/ocr/overview)开通文字识别服务，单击[价格计算器](https://www.huaweicloud.com/pricing/calculator.html#/ocr)查看计费规则。 ![](https://support.huaweicloud.com/usermanual-koosearch/public_sys-resources/caution_3.0-zh-cn.png) 按需计费时，如果开通OCR服务，每一页pdf都会调用一次OCR服务，都会计费一次。如果pdf中有图片，图片还会调用一次OCR。 表5IAM委托 | 参数 | 说明 | |:---|:---| | IAM委托 | 选择IAM委托，授权当前账号访问和使用OCR服务的权限。 - 当首次配置委托时，可以单击"自动创建委托"新建委托"css_ocr_agency"直接使用。 - 当已有自动创建的委托时，可以选择委托直接使用。 警告： 委托名称必须仅包含字符a-z、A-Z、0-9、下划线（_）和短横线（-），否则会备份失败。 | #### 网络配置 配置集群的虚拟私有云VPC、子网和安全组。 表6网络配置 | 参数 | 说明 | |:---|:---| | 虚拟私有云 | 指定集群使用的虚拟专用网络，可以对不同业务进行网络隔离。 选择合适的VPC，如果没有合适的VPC，可以单击"创建虚拟私有云"，新建VPC（必须具备创建VPC的权限）。具体操作请参见[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)《虚拟私有云用户指南》中的"创建虚拟私有云和子网"章节。 | | 子网 | 指定集群使用的子网，通过子网提供与其他网络隔离的、可以独享的网络资源，以提高网络安全。 选择当前虚拟私有云下的子网。如果没有合适的子网，可以单击"创建子网"，新建子网。具体操作请参见[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)《虚拟私有云用户指南》中的"创建虚拟私有云和子网"章节。 | | 安全组 | 指定集群使用的安全组，安全组起着虚拟防火墙的作用，为集群提供安全的网络访问控制策略。 选择合适的安全组，单击"查看安全组"可以跳转到安全组列表，了解安全组详情。 所选安全组的入方向规则中，"协议端口"必须包含9200的端口范围，否则外部业务访问可能会异常。 如果没有合适的安全组，可以单击"创建安全组"，跳转到网络控制台创建安全组（必须具备创建VPC的权限）。具体操作请参见[创建安全组](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013748715.html)。 | #### 集群管理 配置集群名称、企业项目信息。 表7参数说明 | 参数 | 说明 | |:---|:---| | 集群名称 | 自定义集群名称。 集群名称在4位到16位之间，必须以字母开头，可以包含字母、数字、中划线或者下划线，不能包含其他的特殊字符。 | | 添加描述 | 为集群添加描述，方便用户识别。 单击"添加描述"，输入集群的描述信息，支持0\~128位。 | | 企业项目 | 给集群绑定一个企业项目。 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理，默认项目为"default"。 如果开通了"企业项目"，请从下拉列表中选择所在的企业项目。单击查看项目管理，可以跳转到企业项目管理列表，查看企业项目详情。更多关于企业项目的信息，请参见[进入企业中心](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0108763975.html)《企业管理用户指南》中的"企业中心"章节。 | #### 购买量 配置集群包周期的购买时长和续费规则。仅"计费模式"选择"包年/包月"时才显示该参数。 表8参数说明 | 参数 | 说明 | |:---|:---| | 购买时长 | 设置集群的购买时长，最短为1个月，最长为3年。如果购买时长超过9个月，建议包年购买，价格更优惠。 | | 自动续费 | 选择是否自动续费。默认不启用，如需启用，则勾选"自动续费"选项。 自动续费指在"包年/包月"资源到期后，可以自动进行续费。 - 按月购买的资源：每次续费1个月，次数不限。 - 按年购买的资源：每次续费1年，次数不限。 关于自动续费的更多说明，请参见[自动续费规则说明](https://support.huaweicloud.com/usermanual-billing/renewals_topic_20000002.html)。 | #### 提交创建任务 1. 在"配置概要"中，查看服务配置详情。 未设置的必选字段会通过红色字体进行提示，需在参数配置区域进行设置。 2. 单击"立即创建"，开始创建服务。 服务创建时间取决于节点数量，通常可在60分钟内完成，如果服务节点数量较多，时间可能相应延长。 3. 返回服务列表，查看新建的服务。 当服务创建成功后，"集群状态"会变为"可用"。 #### 相关文档 - 如果您需要查看服务的基本信息，例如集群状态、内网访问地址、节点信息等，请参见[查看KooSearch文档问答服务详情](https://support.huaweicloud.com/usermanual-koosearch/koosearch_06_0010.html)。 - 如果您需要查看服务的使用流程，请参见[KooSearch文档问答服务使用流程](https://support.huaweicloud.com/usermanual-koosearch/koosearch_06_0002.html)。 - 如果您需要配置服务的集群路由，请参见[配置KooSearch文档问答服务集群路由](https://support.huaweicloud.com/usermanual-koosearch/koosearch_06_0011.html)。 - 如果您需要查看服务日志，请参见[查看KooSearch文档问答服务日志](https://support.huaweicloud.com/usermanual-koosearch/koosearch_06_0014.html)。