# CoMi V3.0部署工具安装维护手册

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

2026年10月

# 前言

本手册就CoMi V3.0版本部署工具安装提供详细说明,如对本手册中相关内容存在疑问,请与致远互联的客户服务人员联系。

CoMi智能部署工具(以下简称“部署工具”)支持将 CoMi基础服务部署至 Linux 或信创系统服务器。该工具采用B/S架构,您只需在一台部署服务器(或堡垒机)上运行本工具,即可通过浏览器访问其Web界面,以向导式流程完成所有目标服务器的部署、配置与后续维护。部署后CoMi所有基础服务启停、网络互通检查、CoMi日志提取均可通过Web界面可视化操作。建议生产环境使用CoMi智能部署工具的形式进行部署维护!

部署视频: 原始手册未提供可验证的视频链接;首次部署以本手册和厂商当前正式文档为准。

1791547286367.png

# 修订记录

修订内容 修订时间
CoMi 3.0初始稿 2026-10-1
CoMi 3.0第一次修订 2026-10-8

# 部署工具适配说明

# 部署工具能力

场景 支持情况
CoMi V3.0基础服务全新安装 支持,详见本手册
CoMi V2.0/V2.0.1/V2.0.2/V2.1.0/V2.1.1升级到CoMi V3.0 支持,详见部署工具升级手册

注: 更早期CoMi V1.1版本不建议带数据升级,如没有特殊数据需要保留,建议直接卸载CoMi V1.1,采用全新安装部署,如有必须带数据升级刚性需求,请发起技术服务支持申请单由研发协助评估。

# 部署维护范围

本手册提供CoMi基础服务(基础服务特指CoMi运行所需的最小服务集合)部署维护说明,CoMi所需基础服务如下:

服务 部署工具支持 备注
AI-Manager 支持 基础服务,必须部署,需要一个关系型数据库存储数据
AI-Engine 支持 基础服务,必须部署
AI-Security 支持 非必须服务,按需部署
ElasticSearch 支持 基础服务,必须部署,CoMi向量数据库,不可复用协同的全文检索SearchService
CoMi Server 支持 基础服务,必须部署,CoMi UI和APP服务,需要一个关系型数据库存储数据
AI-DocumentParse 支持 基础服务,必须部署,CoMi文件解析服务,必须部署在AI-Manager服务器上
CoMi沙箱 (ai-engine-sandbox) 支持 基础服务,必须部署,CoMi沙箱服务,必须部署在AI-Engine服务器上
关系型数据库 不支持 基础服务,必须准备,可复用协同数据库服务资源(新建几个空库给CoMi)
Nginx代理 不支持 基础服务,必须部署,需自行部署,详见本手册Nginx章节
大模型 不支持 基础服务,CoMi必须依赖大模型,需由客户提供,详见本手册“工具部署后其它重要配置”中的模型配置章节
协同OA服务 不支持 基础服务,依赖协同OA,通常已提前部署

# 操作系统支持

CoMi V3.0系列服务支持如下操作系统:

分类 支持情况
权限要求 建议以管理员(root)权限操作 (root所需权限说明 (opens new window))
支持操作系统(不支持Windows) CentOS 7、CentOS 8
RedHat 7、RedHat 8 、RedHat9
openEuler 24.03-LTS
Anolis 8.10
Ubuntu 22.04 LTS
麒麟V10
统信UOS V20
其它Linux类系统理论支持,请直接部署测试
服务器CPU架构 X86、ARM

注: 部署工具不支持Windows系统!

# 商务插件准备

使用CoMi,需要从致远商务侧申请更新协同加密狗授权文件(*.seeyonkey),申请到对应授权才能在协同中配置使用CoMi,详细插件要求见《CoMi环境准备指导手册 (opens new window)》-商务插件和功能对照章节。

# 适配协同版本

不同CoMi版本支持的V5、V8协同版本各不相同,详见下表说明:

版本 支持V5版本 支持V8版本
CoMi V3.0 详见【CoMi和协同对应关系表 (opens new window)】 V8所有版本均不支持

# 依赖环境准备

# 操作系统环境准备(必须)

在进行安装部署前,先按照如下配置优化Linux、信创系统参数(所有CoMi服务、包含智能部署工具所在服务器都要执行):

麒麟V10系统需要先删除podman,否则后续安装Docker(CoMi沙箱需要)会失败:

yum remove podman -y

预装部署所需的命令:

# 基于CentOS8+/RHEL8+/Fedora22+/欧拉openEuler/龙蜥Anolis等系统使用dnf安装
sudo dnf install tar curl net-tools unzip vim telnet rsync nc -y

# 基于CentOS7/RHEL7及更早体系的系统使用yum命令安装
yum install tar curl net-tools unzip vim telnet rsync nc -y

# 基于Debian的系统(如Ubuntu)使用apt预装组件
sudo apt install tar net-tools unzip vim telnet rsync netcat-openbsd -y

修改Linux最大进程数最大文件打开数: 通过 vi /etc/security/limits.conf 命令编辑此文件,添加以下内容(已配置可忽略):

# RedHat系列、CentOS、欧拉、麒麟等大部分系统使用的配置====start
# open files  (-n)
* soft nofile 65535
* hard nofile 65535
# max user processes  (-u)
* soft nproc 65535
* hard nproc 65535
# RedHat系列、CentOS、欧拉、麒麟等大部分系统使用的配置====end


# 如Debian和Ubuntu系统使用root用户,还需添加如下配置====start
# open files  (-n)
root soft nofile 65535
root hard nofile 65535
# max user processes  (-u)
root soft nproc 65535
root hard nproc 65535
# 如Debian和Ubuntu系统使用root用户,还需添加如上配置====end

以上配置完成,再配合下一步关闭selinux后重启操作系统才能生效,重启后执行 ulimit -a 命令检查open files和max user processes是否都变成65535

部署前先关闭selinux:

如果没有selinux可以跳过该步骤

# 执行如下命令永久关闭
sudo sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config
# 重启操作系统生效
sudo reboot

# 临时禁用(免重启),临时验证关闭效果可用此法,如果确认关闭有效,务必永久关闭
sudo setenforce 0

# 协同Nginx准备(必须)

在进行CoMi部署前,需要先提前部署配置Nginx,确保Nginx能代理协同OA服务,通过http(或https)访问Nginx服务能自动跳转到协同OA。如项目已经使用Nginx代理协同OA,可跳过本章节。

全新安装Nginx和配置强烈推荐参考如下方式(如参考如下手册配置,后续工具部署过程中可以自动写入comi相关配置):

请务必提前完成NG部署配置、并保证协同服务处于启动状态,后续CoMi部署需要检测NG连接状态。

# CoMi数据库准备(必须)

在进行CoMi部署前,需要先提前准备一个关系型数据库服务,CoMi依赖数据库服务存储基本配置和使用记录等信息。

CoMi支持的数据库版本要求如下(不在版本范围的数据库可能不可用):

  • mysql5.7、mysql8.0、mysql8.4 (都用utf8-mb4字符集,配置要求跟协同OA一致)
  • 达梦8.4(配置要求跟协同OA一致)
  • 人大金仓(电科金仓)V8R6、V9R1(Oracle兼容模式)(配置要求跟协同OA一致)
  • PostgreSQL 13.3(配置要求跟协同OA一致)
  • SqlServer 2019(配置要求跟协同OA一致)
  • Oracle 19c(其它Oracle版本不支持)(配置要求跟协同OA一致)

数据库参数配置兼容要求与V5产品线协同OA一致,故可以复用协同OA数据库服务(新建单独的comi数据库表空间)。

实测补充(2026-10-02):141 环境使用 docker postgres:17.11(高于标注的 13.3),部署工具「测试连接」通过、一键配置校验通过,供 POC 参考;生产环境建议仍按 13.3 版本要求准备。

如不涉及信创合规性,也推荐快速部署MySQL/PostgreSQL,实现comi单独数据库维护:

数据库服务准备之后,至少需要新建两个空库分别给ai-manager、comi-server服务使用,命名自定义:比如ai_manager库给AI-Manager服务使用,comi_server给CoMiServer服务使用,CoMi部署工具运行过程中会连接数据库,并自动初始化数据:

1770012574258.png

创建数据库SQL语句示例:

-- mysql建库语句
create database ai_manager default character set utf8mb4;

-- SQLServer数据库:
CREATE DATABASE ai_manager;

-- Oracle数据库:
-- 执行时发现错误可以先执行如下sql
ALTER SESSION SET "_ORACLE_SCRIPT" = TRUE;
-- 创建用户 ai_manager并设置密码
create user AI_MANAGER identified by 访问密码;
-- 赋权
grant connect,resource to AI_MANAGER;
-- 赋权
GRANT UNLIMITED TABLESPACE TO AI_MANAGER;

-- PostgreSQL数据库 和 海量数据库(PostgreSQL兼容模式):
CREATE DATABASE ai_manager TABLESPACE 表空间名称 ENCODING 'UTF8';

-- 达梦数据库:创建 Schema 并关联用户
CREATE SCHEMA ai_manager AUTHORIZATION 数据库用户;

-- 人大金仓数据库:
CREATE DATABASE ai_manager TABLESPACE 表空间名称 ENCODING 'UTF8';
-- 注意:人大金仓建库后需要先查询看下是否支持空字符串插入,sql语句如下:
-- 若结果显示为on,需要修改kingbase.conf中的ora_input_emptystr_isnull=off
select name,setting from  sys_settings where name = 'ora_input_emptystr_isnull';

# 大模型提前准备(必须)

必须提前准备:LLM和Embedding模型,在部署过程中需要配置模型信息!

关于CoMi依赖的大模型和推荐,参考《CoMi环境准备指导手册 (opens new window)》。

# 安装包准备(必须)

CoMi部署工具从商务公布的安装程序地址下载(文档中心-文档库-营销中心-营销体系销售管理知识库-产品下载地址-提交给区域产品下载地址xxx.xls),产品线对应CoMi V3.0。

注意:CoMi部署工具部署包 和 CoMi基础服务部署包 是不同文件夹存放,项目上需要根据自身环境情况下载文件夹的部署包。

CoMi部署工具部署包:找到部署工具文件夹,下载与服务器相合适的架构安装包(arm架构信创系统下载linux-arm_64.zip):

1791445224452.png

如下图红框是CoMi基础服务部署包,红框中的每个文件夹中的程序都需要下载,选择合适的架构安装包:

非红框中的包是扩展服务,不是必须部署,比如DataPulse仅智能问数场景需要,comi-table/minio/cute仅CoMi智能文档表格场景需要,建议先部署CoMi基础服务,待稳定后再参考单独手册部署智能问数、智能表格等服务。

1791445340405.png

部分服务按照CPU架构和操作系统拆分成多个包,如果X86架构操作系统无匹配的安装包则默认取centos7尝试,如果ARM架构操作系统无匹配的安装包则默认取kylinv10(麒麟V10)尝试:

1791446654069.png

# 部署工具安装和访问

# 部署工具运行架构图

整个部署组成元素分为 :用户PC操作终端机器,安装部署工具服务机器,部署CoMi目标机器 三部分。

操作流程:用户在PC终端上,浏览器访问部署工具服务Web可视化页面→可视化选择对应的部署目标机器→上传安装包→配置服务参数→安装部署到对应的目标机器上。

部署工具网络要求:

  • 确保部署工具能SSH到CoMi和NG服务器
  • 确保至少一台PC终端能HTTP访问到部署工具服务

部署工具需要部署在能SSH到CoMi和NG的服务器上,以下整理几个典型场景的规划:

  • 如客户单台服务器资源足够大,计划将CoMi所有服务都部署在同一台服务器,则可以将部署工具也上传部署在这个服务器 或 其它同局域网服务器
  • 如客户服务器较多,CoMi基础服务、BI、Nginx等计划分离部署,则可以将部署工具上传部署在任意一台上面 或 其它同局域网的服务器。

1762431109776.png

# 部署工具安装和运行

1、根据服务器架构选择合适的安装包,将部署工具安装包上传到提前规划好的服务器:

  • x86服务器下载:Deployer-Tools-v3.0.0-linux-x86_64.zip

  • arm服务器下载:Deployer-Tools-v3.0.0-linux-arm_64.zip

2、解压部署工具到目标目录:

# 创建工具存放目录
mkdir -p /data/comi-deployer-tools
# 将上传的zip包解压到工具存放目录(示例为X86工具包)
unzip Deployer-Tools-v3.0.0-linux-x86_64.zip -d /data/comi-deployer-tools/
# 检查解压后的目录文件是否存在(示例为X86工具包)
cd /data/comi-deployer-tools/Deployer-Tools-v3.0.0-linux-x86_64/
# 检查包下的文件是否存在startup.sh等,存在则说明解压成功
ls

3、部署工具端口调整(非必须):工具默认端口9526,可修改startup.sh文件按需调整端口。

vi startup.sh

1762484895500.png

4、启动部署工具:运行startup.sh脚本启动,启动会输出运行端口及日志文件位置,可实时查看日志文件信息。

# 启动工具
bash startup.sh
# 启动后等待30秒,netstat检查工具端口是否存活,存活则表示正常
netstat -ntlp | grep 9526
# 根据日志文件输出信息,实时查看日志运行情况(示例为X86工具包)
tail -f /data/comi-deployer-tools/Deployer-Tools-v3.0.0-linux-x86_64/logs/output.log

1791446377042.png

5、PC客户端通过浏览器访问 http://部署工具IP:端口(默认9526) ,如显示出CoMi智能部署工作台则表示启动成功。

如无法访问,则考虑部署工具服务器防火墙是否未放开端口(如默认9526)访问权限。部署工具首次登录需要设置密码(密码至少8位,且包含字母、数字、特殊字符中至少两种),请妥善保存密码,方便后期维护!如密码遗失,见后续日常维护-重置登录密码章节。

1765871997095.png

6、CoMi智能部署工作台运行成功后,按照后续章节进行CoMi服务的部署。以后服务的配置、启停均通过这个地址进行维护。

1762484920429.png

# 部署工具安装CoMi步骤

# 一、新建环境项目

1、点击 新建环境项目,根据当前环境作用自定义一个清晰明了的环境项目名称:

1762484980655.png

2、在主机管理与链接卡片中,点击 添加新主机 ,必须添加CoMi服务器、建议添加Nginx服务器信息,如果计划将智能问数BI或CoMi Server与CoMi分离部署,则还需要将分离部署服务器添加进主机列表。

在弹出的 主机维护 窗口中,需要准确填写主机信息:

  • 主机别名: 自定义,填写清晰明确的名称方便识别
  • IP地址:目标服务器局域网IP地址
  • SSH 端口、用户名、认证方式按服务器实际配置填写;密码认证时从本机受保护配置读取凭据,并确认部署工具服务器可通过 SSH 连接目标服务器。
  • 启用sudo:如客户未提供root权限,仅提供普通用户进行部署,需要勾选“启用sudo”选项

配置完成后,点击 测试并添加 ,工具将自动验证SSH连接,成功后主机会被添加至列表 。

如测试提示“连接测试失败,请检查用户名、密码等信息是否正常”,重点检查如下信息:

  • 检查目标服务器的SSH IP端口是否能访问,可通过telnet命令测试,示例如 telnet 192.168.188.170 22 如不通,尝试检查IP端口正确性和目标服务器防火墙等安全策略
  • 检查目标服务器SSH账号密码是否正确,可通过其它SSH连接工具等方法验证

1762484993832.png

1778132052059.png

如客户未提供root权限,仅提供普通用户进行部署,需要勾选“启用sudo”选项:

1777454393813.png

# 二、上传解析CoMi部署包

完成上一步主机管理后,开始进行CoMi部署包准备与规划。

指定部署包: 按照“安装包准备”章节下载与系统相匹配的CoMi系列服务部署包,然后上传到部署工具服务器,由部署工具自动解析CoMi部署包。

产品提供了两种部署包上传解析方式:[本地上传部署包自动解析] 和 [输入服务器部署包路径自动解析] ,无论哪种方式都建议将包提前压缩准备好:

本地电脑新建一个文件夹(例如 comi-v3.0.0-packages),将所有下载好的CoMi系列部署包 .zip文件直接放入此文件夹内(不要解压)。然后,将这个 comi-v3.0.0-packages 文件夹整体压缩成一个 .zip 文件(例如 comi-v3.0.0-packages.zip)。

基于CoMi V3.0.0版本最低要求所需基础服务包X86架构,最终您准备好的文件夹结构应如下所示:

- comi-v3.0.0-packages.zip(本期共7个CoMi基础服务包,见下方说明)
  |- AI-DocumentParse_centos8-x86_64.zip(必须安装)
  |- AI-Engine_centos8-x86_64.zip(必须安装)
  |- AI-Manager-linux-x86_64.zip(必须安装)
  |- ai-engine-sandbox-x86.zip(必须安装,沙箱服务,V2.x时期名为comi-deno-x86.zip)
  |- AI-Security_centos8-x86_64.zip(此服务非必须安装)
  |- Comi-Server-linux-x86_64.zip(必须安装)
  |- elasticsearch-7-linux-x86_64.zip (必须安装,自V2.1.0开始elasticsearch替代qdrant)

1791447131777.png

方式一:输入服务器部署包路径(推荐):

此方法是提前将压缩zip上传至服务器并解压到某个文件夹下(文件夹命名无要求),然后通过录入文件夹地址由程序自动解析安装包。

cd /data
mkdir comi-v3.0.0-packages
# 服务器找到zip压缩文件,解压到指定文件夹下
unzip comi-v3.0.0-packages.zip -d comi-v3.0.0-packages
# 部署工具前端录入/data/comi-v3.0.0-packages解析
cd /data/comi-v3.0.0-packages

1791448073927.png

解析后,确保有如下列表的基础服务,如有则可以进行后续部署配置操作:

1791448648340.png

方式二:本地上传部署包:

点击上传区域,选择您已准备好的、包含所有服务安装包的部署压缩包(例如 comi-v3.0.0-packages.zip),工具将自动上传,上传后点击解析。

1791448318770.png

如上传反复提示MALFORMED字样,可能是本地包不完整或网络拦截限制导致包不完整,建议改用第一种提前上传完整包解析的方案!

1791448397214.png

# 三、配置CoMi核心服务

# CoMi核心服务配置流程

按需配置需要部署的服务:

1、对于每个已勾选的服务,依次设定服务的目标主机,点击其操作列的 [配置] 按钮,会弹出一个该服务专属的配置窗口

2、在弹出的配置窗口中,根据界面提示和本手册 [CoMi核心服务详细配置说明] 的指引,填写所有必填参数

3、完成一个服务的配置后,点击 [确定] 保存配置,该服务状态会变为 [待校验]

4、在 [外部依赖与集成配置] 版块配置好Nginx服务器主机和Nginx的配置文件目录

5、当所有需要部署的服务的参数都填写完毕后,点击服务列表左下角的 [一键配置校验] 按钮(实测注意(2026-10-02):需先勾选服务列表的复选框(可用 Select all 全选),该按钮才会激活)

6、工具将对所有配置进行校验。校验成功后,所有已勾选服务的“状态”列将变为绿色的 [已校验],此时您才可以进入下一个部署阶段

1778132155577.png

完成所有服务的参数配置后,点击页面左下角的 [一键配置校验] 按钮 。

工具将对所有配置进行校验。校验成功后,所有已勾选服务的“状态”列将变为绿色的 [已校验] 。

注意:如果校验失败,状态将变为“校验失败”,会弹出提示具体错误原因,请根据提示修正后重新校验 。

1764239280500.png

一键配置校验通过后点击下一步: 下一步按钮在底部右下角。

1770020303790.png

# CoMi基础服务详细配置说明

# ElasticSearch向量库配置

CoMi V3.0使用ElasticSearch作为向量数据存储,故ElasticSearch必须部署:

  • 部署模式: 参考本章节配置完成后由工具自动安装。如客户有合适的ES向量库可“跳过安装使用现有实例”(要求三方ES至少包含analysis-ik、analysis-pinyin、analysis-stconvert、elastiknn这几个plugins)
  • 目标主机: 特指ElasticSearch远程部署到哪台服务器
  • HTTP运行端口: 默认9200,此端口在AI-Manager配置需要使用
  • Transport运行端口: 默认9300
  • 集群名称、节点名称: 如无特殊要求建议保持默认
  • 运行用户: ElasticSearch默认内置elastic作为管理用户,如无特殊要求建议保持默认
  • 部署路径、数据存储路径、日志存储路径: 可保持默认,需要确保路径磁盘空间充足,后续数据存储都在相关目录下
  • 堆内存大小: 根据实际情况设置,单位g,直接输入数字即可如2或4,设置后ES会占用对应大小的内存,POC可设置1或2,生产大并发需根据情况调大。
  • 启用X-Pack安全认证: 建议启用,如禁用则无需用户名密码就能连接ES,安全要求较高的环境不允许此行为
  • Elastic用户名: 建议保持默认,启用X-Pack安全认证后,认证连接的用户名,在AI-Manager配置需要使用
  • Elastic 密码: 在工作台中设置,建议至少 12 位(建议特殊字符仅用 _、-、.这几个,部分特殊字符易造成后续执行部署命令时异常);启用 X-Pack 后,在 AI-Manager 中配置同一密码。

1791449065383.png

# AI-Engine智能引擎配置

AI-Engine 是执行Agent智能体语义理解和逻辑调度的核心Python服务。如无特殊要求,全部配置可保持默认。

  • 目标主机: 指定服务部署的目标服务器。必填,升级时不可修改。

  • 运行端口: 服务监听端口,默认 8000。必填,升级时不可修改。

  • 是否开启沙箱: 默认开启,对应ai-engine-sandbox沙箱服务,CoMi要求必须开启沙箱以提升安全性。

  • 部署路径: 服务安装目录,默认 /data/Seeyon/Comi/ai-engine ,建议保持默认。必填,升级时不可修改。

  • 日志路径: 存放运行日志的目录。根据部署路径自动生成,默认为 ${ai-engine.basic.deployment_path}/logs。只读。

  • 临时数据路径: 存放临时数据或文件的目录。根据部署路径自动生成,默认为 ${ai-engine.basic.deployment_path}/data。只读。

  • API Key: 首次部署由部署工具自动生成并配置到 AI-Manager;部署后仅从受保护的工作台报告获取,并在 OA 集成配置中本地使用。手册、命令行和截图不记录 Key。

1791449390241.png

# CoMi代码执行沙箱

代码执行沙箱可以使CoMi安全运行,默认必须安装,与AI-Engine配套使用,需要跟AI-Engine安装在同一台服务器!

  • 目标主机:选择文档解析服务的部署服务器,需要与AI-Engine部署在一起。
  • 运行端口:默认为 8877 如无特殊要求,保持默认
  • 部署路径:默认为 /data/Seeyon/Comi/sandbox,建议保持默认。

1770019023161.png

# AI-Security安全服务配置

AI-Security 是负责敏感词检测等安全策略的组件,CoMi安全助理智能体依赖此服务,为可选部署项。

配置说明:

  • 目标主机:设置AI-Security部署的服务器。
  • 运行端口:默认为 9000 无特殊要求建议保持默认。
  • 部署路径:默认为 /data/Seeyon/Comi/ai-security ,建议保持默认。
  • 日志路径:默认为 logs,即部署路径下的 logs 文件夹。通常保持默认配置即可,如遇端口冲突或路径问题再行调整 。

1762498937249.png

# AI-Manager管理后台服务配置

AI-Manager 是 CoMi 平台的核心管理后台,配置项较多,重点关注标*必填项。

AI-Manager基础信息:

  • 目标主机: 指定 AI-Manager 服务的部署目标服务器。
  • 运行端口: 默认 8181,用于对外提供管理接口服务。
  • 部署路径: 默认路径为 /data/Seeyon/Comi/ai-manager ,建议保持默认,用于存放程序包、日志及配置文件。
  • 产品线: 根据实际协同 OA 版本选择 A6、A8/A8N、G6/G6N 或 A9(云原生产品线),该项决定初始化 SQL 脚本及预置智能体模板的加载路径。
  • 同时向量化批次数量: 设置批量调用Embedding模型数量,大部分场景保持默认50,如使用阿里百炼text-embedding限流平台,需要改成10。

1791449586390.png

AI-Manager数据库配置

AI-Manager 依赖独立数据库,需新建一个空库,并确保数据库服务处于可用状态,详细要求见 【CoMi数据库准备】 章节。

重装场景:如打算重装,需要清空原来AI-Manager数据库中的全部表信息,避免重装时检测到表存在而安装失败。

  • 数据库类型: 下拉框选择你的数据库,注意数据库有版本要求,详细要求见 【CoMi数据库准备】 章节。
  • JDBC URL: 工具会自动生成JDBC URL模板。请 手动修改 模板中的变量为实际信息。
  • 数据库用户名/密码: 在工作台中填写具有建表权限的数据库账号;凭据仅从本机受保护配置提供,不写入文档或命令行。
  • 表空间: oracle数据库以用户来区分连接的表空间,因此oracle数据库下comi-server和ai-manager不能使用同一个实例的同一个用户
  • 测试连接: 务必点击 点击按钮进行测试 。只有测试成功后,才能继续下一步。
# 达梦连接url(示例)
jdbc:dm://10.3.4.206:5236/AIMANAGER
一般达梦账号与URL上面的名称一致,如上面URL示例,达梦账号应该是AIMANAGER

# 人大金仓连接url(示例):
jdbc:kingbase8://10.3.4.192:54321/AIMANAGER?clientEncoding=UTF-8

# Mysql连接url(示例)
jdbc:mysql://192.168.188.169:3306/ai_manager

# Oracle连接url(示例)
jdbc:oracle:thin:@127.0.0.1:1521:ai_manager

# SQLServer连接url(示例)
jdbc:sqlserver://127.0.0.1:1433;DatabaseName=ai_manager;maxStatements=0;SelectMethod=cursor;encrypt=false;trustServerCertificate=true

# Postgresql 和 海量(PostgreSQL兼容模式)连接url(示例)
jdbc:postgresql://127.0.0.1:5432/ai_manager

1791450118255.png

1791450161139.png

AI-Manager集成配置

  • 协同 OA 的反向代理地址: 必填项,填写 Nginx 反向代理协同 OA 的完整内网访问地址(通过NG能访问协同的http地址),示例如 http://192.168.188.168:80,该地址用于回调与授权验证。
  • AI-Engine 服务地址、AI-Security 服务地址: 集中部署保持默认值,不可修改
  • 向量库主机与 gRPC 端口: 会自动关联向量库信息,不可修改
  • OA OCR 服务地址与 V8 OCR 服务地址: 为选填项,分别用于文本识别扩展,未部署OCR可保持默认值。OA OCR服务地址对应V5产品线(A6、A8、A8-N、G6、G6-N),并且OCR服务需要单独部署,具体详见OCR部署手册。
  • 政务转发地址白名单: 默认保持空,仅有功能问题时,在研发指导下做调整
  • 多维表格索引同步 API Key: 部署CoMi基础服务时无需填写,仅部署CoMi Table时需要,参数配置详见CoMi Table手册
  • 多维表格索引同步间隔(分钟): 保持默认值即可
  • 阿里云OSS访问地址/访问区域信息/默认存储桶名称/访问密钥ID/访问密钥: 默认保持空,仅涉及使用第三方文本内容处理工具(如法大大的合同审核)时在研发指导下做配置。
  • 协同问答三方互信ID、协同问答三方互信密钥: 如需要使用协同知识问答则必须配置,建议部署时顺带做好配置,避免后期返工。协同三方互信配置涉及多步操作,详见下方 【协同问答三方互信】 小节 。
  • 定时任务三方互信ID、定时任务三方互信密钥: 必须配置,影响CoMi所有定时任务执行。定时任务三方互信配置涉及多步操作,详见下方 【定时任务三方互信】 小节 。

1791453808690.png

AI-Manager配置协同问答三方互信第一步: 登录协同系统管理员-三方互信设置-新建一个三方互信:

  • 名称自定义,建议取一个与产品有关的名称,如 Comi协同问答互信
  • ID和密钥自动生成,将生成的ID和密钥拷贝到AI-Manager的协同问答三方互信ID和互信密钥里
  • 回调地址必填,必须是 http://ai-manager服务IP:8181/ai-manager/knowledge/center/third/part/callback
  • 必须设置绑定IP,绑定IP对应:AI-Manager服务器IP

1791455668699.png

AI-Manager配置协同问答三方互信第二步: 到协同OA数据库中注册三方互信认证。

三方互信菜单下找到授权菜单,并确保“三方互信接口”下的两个接口处于勾选状态(未勾选则勾选保存),程序会自动向数据库写入SQL。

✓ POST /attachment/channel/batchDownload
✓ GET /attachment/channel/file/{fileId}

1794738448140.png

AI-Manager配置定时任务三方互信第一步: 登录协同系统管理员-三方互信设置-新建一个三方互信:

  • 名称自定义,建议取一个与产品有关的名称,如 Comi定时任务互信
  • ID和密钥自动生成,将生成的ID和密钥拷贝到AI-Manager的定时任务三方互信ID和互信密钥里
  • 回调地址必填,必须是 http://ai-manager服务IP:8181/ai-manager/v5Trust/callback
  • 必须设置绑定IP,绑定IP对应:AI-Manager服务器IP

1791455864587.png

AI-Manager配置定时任务三方互信第二步: 到协同OA数据库中注册三方互信认证。

三方互信菜单下找到授权菜单,并确保“三方互信接口”下的如下几个接口处于勾选状态(未勾选则勾选保存),程序会自动向数据库写入SQL。

1794740469894.png

AI-Manager 文件路径 和 ES配置:

  • 文件存储路径: 默认/data/Seeyon/Comi/ai-manager/file,无特殊要求可不做修改
  • ES地址: 对应 ElasticSearch向量库配置 ,配置成 http://elasticSearch服务IP:9200 其中9200默认是ES的http运行端口
  • ES 认证用户名/密码: 对应前面 Elasticsearch 配置 中的 用户名和密码,通常在Elasticsearch设置保存后会自动回填到AI-Manager,如未回填请手工配置。

1791456645458.png

# ai-document-parse文档解析服务

配置说明:

  • 目标主机:选择文档解析服务的部署服务器,需要与AI-Manager部署在一起。
  • 运行端口:默认为 9880。
  • 部署路径:默认为 /data/Seeyon/Comi/ai-document-parse,建议保持默认。
  • 迁移数据: 全新安装场景保持默认关闭,仅CoMi2.0.x升级场景需要开启,将Qdrant向量数据迁移到ElasticSearch向量库
  • Qdrant URL地址: 全新安装场景不用填写,仅CoMi2.0.x老版本客户升级到CoMi新版本才需要配置
  • 日志路径:默认为 logs,即部署路径下的 logs 文件夹。通常保持默认配置即可,如遇端口冲突或路径问题再行调整 。

1791532851143.png

# CoMi Server服务配置

CoMi 移动端服务,为App和 PC门户提供数据接口服务。如果需使用 CoMi 独立的移动端 APP,则必须部署此服务。

CoMi Server基础信息:

  • 目标主机:指定 CoMi Server 服务部署的目标服务器。必填,升级时不可修改。
  • 运行端口:服务监听端口,默认 8081。必填,升级时不可修改。
  • 部署路径:服务安装目录,默认 /data/Seeyon/Comi/comi-server ,建议保持默认。必填,升级时不可修改。
  • 产品线: 必填,A6/A8/G6/A8N/G6N选择 V5 ,云原生新一代A9C选择 V8 。

1791533008167.png

CoMi Server数据库配置

CoMi Server 依赖独立数据库,需新建一个空库,并确保数据库服务处于可用状态,详细要求见 【CoMi数据库准备】 章节。

重装场景:如打算重装,需要清空原来CoMi Server数据库中的全部表信息,避免重装时检测到表存在而安装失败。

  • 数据库类型: 下拉框选择你的数据库,注意数据库有版本要求,详细要求见 【CoMi数据库准备】 章节。
  • JDBC URL: 工具会自动生成JDBC URL模板。请 手动修改 模板中的变量为实际信息(见下方示例)。
  • 数据库用户名/密码: 在工作台中填写具有建表权限的数据库账号;凭据仅从本机受保护配置提供,不写入文档或命令行。
  • 表空间: oracle数据库以用户来区分连接的表空间,因此oracle数据库下comi-server和ai-manager不能使用同一个实例的同一个用户
  • 测试连接: 务必点击 点击按钮进行测试 。只有测试成功后,才能继续下一步。
# 达梦连接url(示例)
jdbc:dm://10.3.4.206:5236/COMISERVER
一般达梦账号与URL上面的名称一致,如上面URL示例,达梦账号应该是COMISERVER

# 人大金仓连接url(示例):
jdbc:kingbase8://10.3.4.192:54321/COMISERVER?clientEncoding=UTF-8

# Mysql连接url(示例)
jdbc:mysql://192.168.188.169:3306/comi_server

# Oracle连接url(示例)
jdbc:oracle:thin:@127.0.0.1:1521:comi_server

# SQLServer连接url(示例)
jdbc:sqlserver://127.0.0.1:1433;DatabaseName=comi_server;maxStatements=0;SelectMethod=cursor;encrypt=false;trustServerCertificate=true

# Postgresql 和 海量(PostgreSQL兼容模式)连接url(示例)
jdbc:postgresql://127.0.0.1:5432/comi_server

1791534034489.png

CoMi Server集成配置

  • 协同OA反向代理地址:必填项,填写 Nginx 反向代理协同 OA 的完整内网访问地址(通过NG能访问协同的http地址),示例如 http://192.168.188.168:80。
  • 录音卡服务地址:默认不填写,仅部署配置录音卡时需要操作,具体详见录音卡部署维护手册。

1791534158372.png

CoMi Server安全与认证-三方互信

CoMi Server安全与认证章节的三方互信,需要到协同OA找到对应信息并配置,操作步骤如下:

1、协同OA 系统管理员→信息集成配置→三方互信访问授权→找到名为“Comi一键登录”的三方互信信息,此信息随OA产品内置,不要个人新增。(如不存在,需发支持单联系研发提供补齐)。

2、修改”Comi一键登录“这条三方互信信息,主要是将里面的127.0.0.1的配置修改成CoMi Server真实的IP和端口:

  • 回调地址由原始值http://127.0.1/comi/relation/callBack 修改为 http://CoMiServer服务器IP:8081/comi/relation/callBack (其中8081是CoMiServer默认运行端口,如修改了端口需自行调整)
  • 绑定IP由原始值 127.0.1 修改为 CoMiServer服务器IP (配置示例见下方截图)

3、将”Comi一键登录“里面的ID完整复制到CoMi Server三方互信ID上,将密钥完整复制到CoMi Server三方互信密钥上

以上几步参考如下截图示例:

1791536228870.png

4、检查”Comi一键登录“是否生效:勾选”Comi一键登录“后点击授权按钮,确保系统已默认勾选三方互信接口,未勾选则执行勾选并保存:

1791540190689.png

5、到协同OA数据库执行SQL查询 SELECT * from ctp_rest_access WHERE REST_ID = 'Comi一键登录的ID'; 检查是否有数据,如有数据则说明正常:

1791540539095.png

CoMi Server在线预览配置(自动共享):

启用预览: CoMi基础服务不需要此服务,建议默认关闭,仅使用CoMi智能表格功能时需要开启,详见CoMi Table手册

预览服务地址: 不可修改,由配置自动生成

预览服务密钥: 不可修改,由配置自动生成

1791543461442.png

# 外部依赖与集成配置 (Nginx)

本配置仅适用于V5的Nginx配置!如项目是V8新一代云原生请关闭“自动注入配置”。

在此卡片中,您需要为所有服务配置统一的反向代理入口。

配置说明:

  • 自动注入配置: 默认开启,开启后工具会根据配置信息自动寻找NG配置,并写入CoMi相关配置。如果找寻不匹配,工具不会做任何操作。
  • Nginx服务器主机: 从“Nginx服务器主机”的下拉框中,选择一台已添加的主机作为Nginx服务器。
  • Nginx主配置文件路径: 填写该服务器上维护协同OA的Nginx配置文件路径或conf目录的路径均兼容。
  • 协同服务监听端口: 填写Nginx代理的端口,以便工具根据监听端口检查配置,提升自动注入准确率。

注:由工具自动写入Nginx配置功能自CoMi V2.0.2开始支持,当前CoMi最新版本也适用。

1770020850475.png

# 四、环境预检查

完成环境创建与规划后点击“下一步”按钮,进入环境预检查页面,工具将自动对所有目标服务器进行一次全面的环境“体检”,以提前发现潜在的部署风险。

注意:下一步按钮在页面底部右下角!

1770020303790.png

环境预检查功能说明:

  • 自动检查:检查过程自动开始,界面上会以清单形式实时显示每个检查项的结果。
  • 失败处理:若有检查项失败,请根据界面下方提供的解决方案建议进行修复,然后点击 [重新检查] 按钮,直至所有项都通过。
  • 强制通过:必须所有检查项的状态都变为“通过”(“警告”项可忽略),底部的“下一步”按钮才会被激活。

1762522563171.png

如遇“未通过”选项,需要分析原因并解决,如“核心依赖命令检查”不通过,需要参考“操作系统环境配置调整”章节在CoMi所在服务器执行相关依赖组件命令安装。

1762522627284.png

如遇到“Nginx连通性检查失败”的问题,则重点检查:

  • 协同OA处于启动状态:安装过程中需要确保协同服务处于运行状态
  • Nginx是否正确代理OA:通过浏览器访问HTTP的Nginx,需要确保能看到协同的登录页
  • 上一步在AI-Manager中配置的Nginx HTTP地址是否正确

1762501757430.png

如“CPU核数检查”或“空闲内存检查”存在警告,需要及时做评估调整:POC环境资源有限可忽略警告;生产环境必须按照推荐准备合适的配置,如忽略警告,后续系统性能风险由项目组承担。

1762502974451.png

修改上一页的配置信息,点击“上一步”,上一步按钮在页面底部的左下角。

环境预检查通过后,点击“下一步”,下一步按钮在页面底部右下角。

1762503280172.png

# 五、自动化执行部署

预检查通过后,即可进入全自动化的部署执行阶段。

1、点击 [开始部署环境] 按钮,工具将自动进行服务的部署:

1762503460303.png

2、监控进度:部署过程无需人工干预。您可以通过界面左侧的 “部署进度时间线” 了解当前所处的阶段,并通过右侧的 “实时日志” 监控详细的执行情况 。

1762503658085.png

由于不同系统兼容性问题,输出可能出现乱码,此问题可忽略:

1762503705817.png

3、完成 [阶段四:服务启动与验证] ,能看到“安装任务执行成功”字样则表示自动部署完成,点击底部右下角的“完成部署”按钮进入看板页面。

(完成后进入环境看板,逐项核验服务状态与关键连接状态。)

异常说明:如遇到自动部署异常,需要分析异常服务的日志并解决后再重试,相关日志从服务器上提取,如未修改程序,日志默认存放于:

  • 部署工具日志默认存放于 /data/comi-deployer-tools/Deployer-Tools-v3.0.0-linux-x86_64/logs
  • ai-engine日志默认存放于 /data/Seeyon/Comi/ai-engine/logs
  • ai-manager日志默认存放于 /data/Seeyon/Comi/ai-manager/logs
  • ai-security日志默认存放于 /data/Seeyon/Comi/ai-security/logs

【CoMi部署配置常见异常解决方案】 (opens new window) 提供了大量部署报错问题现象和解决方案,可根据现象做参照排查。

1762503976039.png

# 六、检查自动部署服务状态

完成部署后,进入核心服务状态看板页面,确保所有服务处于运行中,并且关键连接状态正常。

至此工具自动化部署CoMi程序完成,下一步还需要参考后续章节进行其它重要配置!

在核心服务状态面板页面,可以点击“生成报告”下载部署报告,报告中还有后续重要配置的操作说明。

1791544069126.png

# 工具部署后其它重要配置

工具部署CoMi核心服务之后,还需要做其它重要配置,才能在协同中使用。

# 一、Nginx增加CoMi配置(必须)

如使用CoMi部署工具部署时开启了外部依赖与集成配置,并且设置了正确的Nginx服务器,则CoMi工具会自动向Nginx写入配置。如参考本章节操作发现Nginx配置内容已经写入,则可以跳过本章节。

如发现近期Nginx配置文件夹生成了comi相关的conf配置,则说明CoMi部署工具已经自动写入,如没有生成则必须参考手册 《CoMi Nginx安装和配置(V5产品线) (opens new window)》 进行部署配置!

1791974228227.png

# 二、协同配置CoMi并启动

1、历史协同OA版本集成CoMi可能需要打补丁,具体参考【CoMi和协同对应关系表 (opens new window)】里面的说明,补丁包从CoMi安装部署云盘上面自取:

1791544305034.png

2、完成Nginx相关配置后,确保协同OA处于启动状态,然后通过浏览器访问Nginx代理地址检查能否访问协同登录页面。

启动协同服务之前,先修改协同OA部署目录下的 base/conf/plugin.properties 文件(若目录下没有 plugin.properties 就创建这个名字的文件再配置)。修改配置后,需要重启协同OA才能生效!

从部署完成页下载的「部署报告」中获取实际参数配置(以下为根据《Comi智能部署报告》提炼的标准配置格式示例):

# CoMi 服务集成配置(参数值来源于部署报告)
ai.comibuilderServer=http://<Nginx_IP>:<Nginx_Port>/seeyon/ai-platform/ai-manager/assistant/info/getAllRightsAssistant

ai.managerUrl=http://<AI_Manager_IP>:8181/ai-manager
comi_ai_manager_url=http://<Nginx_IP>:<Nginx_Port>/seeyon/ai-platform
ai.comi.apikey=<从部署报告中获取填入实际API_Key>

补充说明与运维指引:

  • 可视化修改:也可以通过运行协同目录下的 ApacheJetspeed/conf/SeeyonConfig.sh 系统配置工具进行可视化修改;
  • 插件与版本核对:如无相关配置项,请检查协同加密狗是否已注册更新 CoMi 授权插件,以及当前协同的 BuildID 是否在 CoMi 支持范围内;
  • API Key 一致性:ai.comi.apikey 必须与部署工具生成的部署报告中的 API Key 完全保持一致;敏感凭据由管理员在本地受控环境中填写,切勿泄露或记录在公开截图中。

3、配置完成后,需要重启协同OA才能生效!

1778132490711.png

1778132500593.png

注意:协同加密狗需要提前注册更新CoMi所需插件授权:

1747892980933.png

再次提醒:打补丁+配置完成后,需要重启协同OA才能生效!

# 三、协同后台访问CoMiBuilder

以上完成后,通过Nginx地址访问协同 → 系统管理员 → CoMi Builder菜单,如果看到如下界面则说明前期配置正常:

1791544378672.png

如果访问CoMi Builder异常,请参考《CoMi部署配置常见异常解决方案 (opens new window)》寻找根本原因修复!

# 四、协同CoMi后台新增模型

CoMi初始化配置依赖相关模型,需要到协同系统后台配置默认模型,详细配置方法详见《CoMi模型配置操作手册 (opens new window)》。

必须配置LLM模型和Embedding模型,并且设置成默认模型:

CoMi V3.0版本模型配置入口:系统管理员后台 → CoMi Builder菜单 → 资源库 → 模型管理。完整顺序:

  1. 先「接入模型维护」:左侧分类区「+」新建分类(如「公有云模型」)→ 右上「新增」在分类下添加接入模型条目(字段仅:模型名称=真实 model 名、模型类型 LLM/Embedding/ReRank、模型分类)。
  2. 「新增」建模型配置:模型标识只能英文/数字/中划线/下划线/点(不能含 /,如 SiliconFlow 的 Qwen/Qwen3.8-27B 标识可写 Qwen3.8-27B);模型类型;接入模型为级联下拉(分类 > 模型条目);Base URL 取 /v1/xxx 前面的部分;API Key 由用户从本地受保护配置中填写,不在对话、手册或截图中记录。
  3. 保存后模型默认禁用:先点行内「测试」,连接状态变「通过」后,行尾「···」菜单里「启用」(未测试通过直接启用会提示"模型未测试通过,不能启用")。
  4. 「设置默认模型」(列表右上):LLM模型(必须)、Embedding模型(必须,一旦配置不允许修改)、ReRank模型/意图识别模型(可选);连续两道确认弹窗(Embedding 不可改警示、替换原默认调用方警示)均选「是」。DB 验证:ai_manager 库 ai_model_info.default_status=1、status=1(启用)。

1791545135308.png

1778132526553.png

1778132534036.png

# 五、协同初始化CoMi应用

在上一步相关模型配置完成后,再进行应用初始化操作:系统管理员 → CoMiBuilder → 系统管理 → 进入数据初始化页面操作:

CoMi V3.0 数据初始化页共 7 个页签:技能 / 专家 / 快捷指令 / 应用 / Agent / 工作流 / 工具(红点=未初始化)。

每页操作:勾表头全选 → 右上「初始化」→ 覆盖确认「是」,部分应用初始化较慢。

应用初始化时若出现「依赖资源导入失败: [xxxx智能体->BI返回数据格式错误]」提示属正常(未部署协同驾驶舱高级版)。

1791545656955.png

初始化过程中,如遇到 依赖资源导入失败: [xxxxx智能体->BI返回数据格式错误] 提示是正常,没有部署协同驾驶舱高级版就会有此提示:

1792489470354.png

应用初始化完成后,再按相同操作初始化Agent和工具,确保全部数据初始化完成:

1791545724551.png

# 六、CoMi智能体应用授权

上一步数据初始化完成后,切换到前端,默认系统管理员会出现小章鱼,从小章鱼进入智能门户中,点击设计->应用中心->应用市场->选择对应的应用进入详情->点击数据权限进行授权

1791798114690.png

小章鱼入口授权如下: 1791798314817.png

# 七、用户使用CoMi

被授权普通用户登录系统,通过右侧CoMi图标进入智能应用页面:

如未显示CoMi图标,则参考《个人空间未显示CoMi超级入口(小章鱼图标) (opens new window)》排查。

1747896872837.png

# 八、CoMi智能问答配置

如需将协同数据推送到CoMi进行智能问答,则必须配置知识搜索和智能问答参数,配置方法详见《CoMi知识搜索和智能问答配置手册 (opens new window)》

# 九、CoMi智能问数部署配置

如需使用CoMi智能问数功能,则必须部署协同驾驶舱高级版及配置相关功能,配置方法见 《协同驾驶舱高级版智能问数手册 (opens new window)》

# 十、CoMi Table智能表格部署配置

如需使用CoMi Table智能表格功能,则必须部署智能表格相关功能,配置方法见《CoMi V3.0智能表格工具部署维护手册 (opens new window)》

# 十一、OCR图片识别集成配置(按需)

在构建知识库时,若用户有大量重要的扫描件、图片、扫描版 PDF 需要导入 CoMi 知识库进行文字提取与向量化,系统需要依赖 OCR 图片识别服务。

常见异常提示:若环境未配置 OCR 服务且上传了扫描件或图片附件,文档解析时会提示:ocr请求失败 或无法抽取图片文字;

环境要求:OCR 图片识别服务对计算资源要求较高,通常需要客户提供具备 GPU 算力的独立服务器环境;没有算力服务器则购买联网的API服务。

详细配置:

# 十二、详细功能见操作手册

更详细的操作、配置、说明见《CoMi用户操作手册 (opens new window)》。

# 日常维护操作

# 日常启停CoMi服务

1、通过智能部署工具安装的CoMi,日常启停服务均可以使用此工具在线化操作,首先确定服务处于启动状态:

# 到工具程序目录(示例为X86环境)
cd /data/comi-deployer-tools/Deployer-Tools-v3.0.0-linux-x86_64/
# 启动工具
bash startup.sh
# 启动后等待30秒,netstat检查工具端口是否存活,存活则表示正常
netstat -ntlp | grep 9526
# 根据日志文件输出信息,实时查看日志运行情况(示例为X86工具包)
tail -f logs/output.log

2、PC客户端通过浏览器访问 http://部署工具IP:端口(默认9526) ,在CoMi智能部署工作台,点击 [打开] 进入服务启停页面,在操作栏中可视化启用、停用服务即可。

1791546021737.png

1791546082076.png

# 查看CoMi日志

如需查看日志,可以通过CoMi智能部署工作台直接下载日志。

1791546121451.png

同样可以远程到服务器提取日志,常见服务日志存放路径如下:

  • ai-engine日志默认存放于 /data/Seeyon/Comi/ai-engine/logs
  • ai-manager日志默认存放于 /data/Seeyon/Comi/ai-manager/logs
  • ai-security日志默认存放于 /data/Seeyon/Comi/ai-security/logs
  • 部署工具日志默认存放于 /data/comi-deployer-tools/Deployer-Tools-v3.0.0-linux-x86_64/logs

# 修改CoMi配置

日常运行过程中,可能会存在调整指定服务参数的情况,可参考本章节操作。

1、通过CoMi智能部署工作台,点击“修改并更新环境”,进入修改列表页面:

1762529850413.png

2、按需修改指定服务的配置,点击确定保存:

1762530016637.png

3、修改后的服务状态变为“待校验”,需要勾选并点击一键校验,再“下一步”重新发布应用:

1762530164216.png

4、第二步进行“环境预检查”,确保所有配置通过,再到最后一步页面:

1762530233883.png

5、第三步点击“开始部署环境”,工具会重新更新发布修改的服务,发布完成后配置生效。

1762530283737.png

# 更新CoMi服务程序应用

日常运行过程中,CoMi某个应用的程序可能存在BUG,或者预制的智能体应用存在问题,在研发指导排查下,如需更新某个服务的程序应用,可参考本章节操作:

1、首先获得研发提供的需要修复的服务程序应用,本例以X86环境下的AI-Manager服务应用更新为例:AI-Manager-linux-x86_64.zip

2、通过CoMi智能部署工作台,点击“修改并更新环境”,进入修改列表页面:

1762529850413.png

3、上传第一步已经下载好的应用(注:更新CoMi服务可以直接上传具体服务的zip压缩包,不用再按全新部署时那样外层包一个文件夹的形式上传)

1765188932005.png

4、解析上传的CoMi服务,解析成功后,对应“已安装”的服务会变成“未配置”。点击“配置”按钮,不用做任何操作,再保存一次,接着就可以右下角下一页、下一页到重新部署应用页面。

1765189065939.png

5、确认无误的前提下,直接重新部署应用(工具仅重新部署上一步勾选配置的应用),直至看到部署完成为止,随后依次启动CoMi相关服务,检查功能是否正常:

1765189228294.png

6、(本步仅更新AI-Manager服务后需要检查操作)协同OA → 系统管理员后台 → CoMi Builder → 系统管理 → 数据初始化,如看到有标红数字则表示存在更新的预制包,参考CoMi首次部署完成后的应用初始化操作,更新预制包即可:

1791546326510.png

# 修改Nginx内网地址操作

如果项目涉及 测试环境的comi切换连接正式OA地址 或 调整Nginx服务内网地址 (如http切换https 或 更换NG端口),除了更新AI-Manager关于NG的配置之外,还需要重新初始化应用等一系列操作,涉及操作如下:

1、修改AI-Manager服务中的Nginx内网地址, 修改后需要重新发布应用 ,修改重新发布操作参考 【修改CoMi配置】 章节:

1762530957920.png

2、修改协同OA下的配置:到协同服务器,修改协同OA部署目录下的 base/conf/plugin.properties 文件,调整 ai.comibuilderServer 参数,将其修改为新的Nginx地址,并且重启协同OA:

1763369875379.png

3、协同系统内修改工具地址:需要替换基础路径:系统管理员 → 系统管理 → 数据初始化 → 工具 → 替换基础路径:

1791546434660.png

1765879458786.png

4、以上完成后,去工具菜单检查接口是否已经替换为NG新地址。

5、如果CoMi连接的协同OA从测试环境切换为生产环境,需要到协同OA后台重新做智能体应用授权(集团或单位管理员 → CoMi应用授权)。

6、如果测试环境使用了协同知识问答,已将测试环境的数据写入到CoMi向量库(管理员 → CoMiBuilder → 资源库 → 知识库 → 协同知识下检查是否存在测试数据),需要清理这一批测试数据: 此操作涉及清理向量库数据,需要发起技术服务支持申请单,由CoMi研发提供工具支持。

1765937153805.png

# 重置智能部署工具管理员登录密码

如忘记部署工具的登录密码,可以到后台进行密码重置:

# 到程序目录下运行resetpassword.sh脚本重置密码
cd /data/comi-deployer-tools/Deployer-Tools-v3.0.0-linux-x86_64
bash resetpassword.sh

# 确认重置后,启动服务,重新访问智能部署工具系统,设置登录密码
bash startup.sh

# 卸载CoMi单个服务

自CoMi 2.0.2版本开始,智能部署工具支持卸载指定服务:通过核心服务状态面板,找到对应服务点击卸载:

注意卸载操作不可恢复,卸载前备份好相关关键数据!

1791546547184.png

# 修改默认LLM模型

场景:客户此前使用A模型作为默认的语言模型,后来客户有了更好的B模型,需要替换。

通过系统管理员 → CoMiBuilder → 模型管理操作:

  • 先添加新的B模型,并通过模型对话等应用充分测试模型可用性,确保模型稳定可用
  • 再点击右上角“设置默认模型”,将原默认的A模型改为B模型即可实现批量替换

1775784296617.png

有时候,用户设置默认模型后也没有批量替换,可以考虑:A模型切换为B模型、然后B模型再切换为A模型、最后再切换B模型,反复操作。 或尝试操作栏的“全量替换”功能。

1775784663404.png

# 修改Embedding模型

Embedding模型一旦配置,在默认模型侧就不可修改: 原因见 【CoMi的默认模型Embedding模型为什么不可修改? (opens new window)】。 如一定要修改:

  • 场景一:如切换的是相同的模型产品,只是地址更换,可以通过修改模型的地址来快速处理。如测试初期使用硅基流动的BGE-M3,生产上线使用本地部署的BGE-M3,由于两个模型理论相同,只需更换地址别名。
  • 场景二:项目还在测试阶段,可直接重装 CoMi,重新配置 Embedding 模型,并重新初始化向量知识库,务必提醒客户生产环境不支持随意更换Embedding 模型。
  • 场景三:如客户已经上线,此时需要替换完全不同的Embedding模型,需要发起技术服务支持申请单,由研发提供替换SQL,替换后原来向量化的数据失效,需要重新初始化!此场景影响最大,需要慎重处理!

1791546811106.png

1791546935119.png

# 卸载CoMi全部服务

如项目需要完全清空CoMi环境,重新部署,可以登录智能部署工作台点击“卸载环境”,工具会自动将CoMi部署的服务全部卸载(不会卸载用户自己部署的服务-如数据库、Redis、Nginx),工具也不会删除ai-manager、comi_server等数据库数据:

1791614994619.png

# 常见问题

所有部署配置访问异常,请参考 《CoMi部署配置常见异常解决方案 (opens new window)》 手册进行排查处理。

编撰人:het、admin、hufei

快速跳转