# CoMi V2.0知识搜索和智能问答配置手册

北京致远互联软件股份有限公司

2025年11月

# 前言

本手册提供CoMi V2.0知识搜索和智能问答配置手册：如需使用CoMi智能检索协同、文档、公文等数据，需要全文检索服务并且参考本手册进行相关配置。

知识搜索和智能问答别名：协同智能知识问答。

# 环境准备

在进行CoMi知识搜索和智能问答配置前，需要确保CoMi V2.0基础服务和全文检索服务已经部署，具体要求如下：

# CoMi V2.0服务提前部署

CoMi V2.0系列服务支持多种部署方式，项目上可根据用户情况选择合适的部署模式，需要确保CoMi V2.0部署配置调通后再进行本手册操作：

方案	部署方式	部署手册
方案1	向导式部署	部署链接 (opens new window)
方案2	Docker容器部署	部署链接 (opens new window)

# 全文检索服务提前部署

协同知识问答除了依赖CoMi之外，还依赖全文检索服务，需要提前部署，并且历史版本需要打补丁：

产品版本	是否支持协同知识问答	备注
协同V10.0SP1全文检索	支持	无需打补丁，全文检索V10.0SP1部署链接 (opens new window)
协同V10.0及更早版本全文检索	部分版本支持	全文检索和协同均需要打补丁，历史版本全文检索接入comi知识问答手册 (opens new window)

注意：

协同V10.0SP1版本支持CoMi知识搜索和智能问答配置手册功能，无需打额外补丁，只需参考本手册进行配置即可
协同历史版本并非全部支持CoMi知识搜索和智能问答，需要参考【协同版本边界 (opens new window)】版本支持列表判断，并且需要全文检索和协同侧打补丁
历史版本补丁：首先参考对应版本手册部署全文检索（如已部署则只需打补丁），再参考【历史版本全文检索接入comi知识问答手册 (opens new window)】打对应补丁

# 全文检索与CoMi连通性要求

协同、全文检索、CoMi的连通关系如下：

场景一、如果是将协同知识通过全文检索推送到COMi，由CoMi写入向量知识库场景，涉及如下业务数据流转：

[协同OA] → [全文检索] → [CoMi AI-Manager服务]

场景一要求全文检索知道CoMi的AI-Manager服务地址，并且确保CoMi能通过网络访问到AI-Manager服务。AI-Manager的服务地址不用在全文检索中定义，全文检索直接读取协同配置：只需要协同服务器 base/conf/plugin.properties 下配置了 ai.managerUrl 和 ai.comi.apikey 参数即可。这两个参数是CoMi部署最基础参数，如果按照CoMi部署手册进行操作，则参数值已经生效。

建议以上准备就绪后，在全文检索服务器通过 telnet {ai-manager地址} {ai-manager端口} 命令测试是否能访问AI-Manager服务，先确保能访问再做后续配置操作！

ai.managerUrl = http://{ai-manager地址}:{ai-manager端口}/ai-manager
ai.comi.apikey = {apikey}

场景二、CoMi支持知识库的全文检索或混合检索，这两种场景都会调用全文检索获取相关数据，涉及如下业务数据流转：

[CoMi AI-Manager服务] → [Nginx] → [协同OA] → [全文检索]

场景二也无需在全文检索做任何配置，只要CoMi按照手册部署就能通过协同OA间接检索到数据。

# 插件准备

本功能依赖 “CoMi知识搜索和智能问答”加密狗插件，通过商务渠道申请，更新协同加密授权并重启协同OA生效。

判断插件授权是否存在：

所有环境可通过加密狗注册更新工具updateDog，查看licence是否存在“CoMi知识搜索和智能问答”插件
非信创环境可通过系统管理员-系统监控-Properties Dump 页面搜索“Comi_KS_IQA” 或 “CoMi知识搜索和智能问答”关键字

# 知识搜索和智能问答配置步骤

1、协同登录系统管理员后台 → 访问“CoMi知识源配置”菜单

如“CoMi知识源配置”菜单不显示，可能原因是：没有相关加密授权或协同没有打CoMi适配补丁包或当前协同版本不支持，参考本手册环境准备排查

2、检查 comi.server.url 和 comi.server.api.key 参数是否为空，如果为空则需要先参考CoMi部署手册在协同侧部署配置相关信息（重启生效）。

实时数据同步： 表示选定哪些模块数据实时推送给CoMi知识库，确定实时数据后，新发起的相关数据都会实时进入CoMi知识库中。

如配置不为空，则可以进行“实时数据同步”配置，不同版本对同步数据类型支持程度不同，详见CoMi对应版本的用户操作手册：

3、历史数据同步： 产品同样支持历史数据同步，相关配置说明如下：

请选择同步数据时间范围，表示从全文检索上同步什么时间范围的数据给comi。
是否开启已同步数据去重，表示如果以前发送给comi的数据，本次历史同步中，要重新发送给comi。
请选择同步任务执行时段，表示历史数据同步任务执行时间范围，如果不在本时间段，任务会停止，到下一个任务时间段继续进行，如果本次同步完成了，下个任务时间段不会再次进行，只执行一次。建议非工作时间段来做，减少全文检索服务压力。