# CoMi V2.0智能部署工具安装升级手册

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

2025年11月

# 前言

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

CoMi智能部署工具（以下简称“部署工具”）支持将 CoMi核心服务部署至 Linux 或信创系统服务器 ，支持将CoMi V1.1 Linux/信创老版本升级到当前版本。该工具采用B/S架构，您只需在一台部署服务器（或堡垒机）上启动本工具，即可通过浏览器访问其Web界面，以向导式流程完成所有目标服务器的部署与配置。部署后CoMi服务启停、网络互通检查、CoMi日志提取均可通过Web界面可视化操作。

部署视频： CoMi V2.0使用智能部署工具部署视频可访问协同云-赋能中心-致远学院-搜索“CoMi V2.0使用智能工具部署演示 (opens new window)”

# 部署工具适配说明

# 部署工具能力

场景	支持情况
CoMi V2.0全新安装	支持
CoMi V1.1升级CoMi V2.0	支持，CoMi V1.1部署在Linux/信创的环境可使用本工具升级

注：如原CoMi V1.1没有特殊数据需要保留，建议直接卸载CoMi V1.1，采用全新安装模式，可提高部署效率。

# 部署维护范围

CoMi V2.0智能部署工具支持部署维护范围：

服务	部署工具支持情况	备注
AI-Manager	支持	CoMi基础服务，必须部署
AI-Engine	支持	CoMi基础服务，必须部署
AI-Security	支持	CoMi基础服务，按需部署
Qdrant	支持	CoMi向量数据库，必须部署
关系型数据库	不支持	必须部署，可复用协同数据库服务资源（新建一个库给CoMi）
协同驾驶舱高级版	支持	智能问数BI，按需部署
CoMi Server	支持	CoMi APP服务，按需部署
Nginx	不支持	必须部署，需自行部署，详见后续章节
全文检索	不支持	协同知识问答场景需要，需自行部署，见《全文检索部署维护手册V10.SP1 (opens new window)》
协同	不支持	需自行部署
大模型	不支持	CoMi依赖模型，需由客户提供，详见《CoMi V2.0环境准备指导手册 (opens new window)》

注意：

本部署工具暂不支持如下服务的自动安装：协同全文检索ElasticSearch、Nginx、CoMi数据库，相关服务需要参考对应部署手册自行安装准备。
CoMi V2.0部署架构图、服务器环境资源要求（配置要求）、插件准备要求、支持协同清单、大模型准备要求等详见《CoMi V2.0环境准备指导手册 (opens new window)》，请先完成环境准备再进行本手册部署！

# 操作系统支持

CoMi V2.0部署工具系列服务支持如下操作系统：

分类	支持情况
权限要求	需要以管理员（root）权限操作
支持操作系统	CentOS 7、CentOS 8 RedHat 7、RedHat 8 openEuler 24.03-LTS Anolis 8.10 Ubuntu 22.04 LTS 麒麟V10 统信UOS V20
服务器类型	x86、Arm
其它说明	要求部署工具所在服务器和CoMi相关服务器都必须是支持范围内的操作系统

注意：

部署工具不支持Windows系统， 如无特殊要求，不建议使用Windows系统部署CoMi：没有部署工具、部署繁琐、易出错！

# 商务插件准备

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

# 适配协同版本

CoMi 2.0标准产品随协同V10.0SP1版本匹配发布，即标准支持V10.0SP1版本。

同时也提供了部分协同低版本适配，CoMi 2.0对V5产品线早期版本适配列表详见《协同版本边界feishu知识库 (opens new window)》；早期版本的适配补丁包详见CoMi安装包里的协同OA低版本补丁，协同侧需按要求打补丁。

# 依赖环境准备

# 操作系统环境准备（必须）

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

麒麟V10系统需要先删除podman，否则后续安装Docker会失败：

yum remove podman -y

预装部署所需的命令：

# Red Hat系列，使用yum命令安装，如当前系统提示yum不可用，则尝试使用apt
yum update -y
yum install tar curl net-tools unzip vim telnet rsync nc -y

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

# 基于欧拉openEuler、龙蜥Anolis OS等系统使用dnf安装
sudo dnf update -y
sudo dnf install tar curl net-tools unzip vim telnet rsync nc -y

修改Linux内核参数：

# 编辑配置文件，并在文件末尾添加参数配置
vim /etc/sysctl.conf

net.ipv4.tcp_fin_timeout = 30
net.ipv4.tcp_keepalive_time = 1800
net.ipv4.tcp_window_scaling = 0
net.ipv4.tcp_sack = 0
net.ipv4.tcp_timestamps = 0

# 读取 /etc/sysctl.conf 文件中的设置，使其立即生效
sysctl -p

修改Linux最大进程数最大文件打开数：

通过 vim /etc/security/limits.conf 命令编辑此文件添加以下内容

# open files  (-n)
* soft nofile 65535
* hard nofile 65535
# max user processes  (-u)
* soft nproc 65535
* hard nproc 65535

以上配置完成，重启操作系统，执行 ulimit -a 命令检查open files和max user processes是否都变成65535

部署前先关闭selinux：

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

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

# 协同Nginx准备（必须）

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

全新安装Nginx和配置可参考如下方式：

Nginx服务安装位置根据项目实际情况规划，Nginx部署拓扑和推荐方案参考《CoMi V2.0环境准备指导手册 (opens new window)》。
Nginx需要在Linux或信创系统下部署运行
Nginx服务部署参考《Nginx安装部署参考手册 (opens new window)》
Nginx配置代理协同OA参考《Nginx反向代理和负载均衡协同HTTP (opens new window)》

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

# CoMi数据库准备（必须）

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

CoMi V2.0支持的数据库版本要求如下，不在版本范围的数据库不可用：

mysql5.7、mysql8.0
达梦8.4
人大金仓（电科金仓）V8R6（Oracle兼容模式）
postgreSQL 13.3
sqlServer 2019
oracle 19c（其它Oracle版本不支持）

数据库参数配置兼容要求与协同OA一致，故可以复用协同OA数据库服务（新建一个comi的数据库）。

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

数据库服务准备之后，需要新建一个空库，命名如 comidb、ai_manager，CoMi部署工具运行过程中会连接数据库，并自动初始化数据：

# 大模型提前准备

必须提前准备：LLM和Embedding模型，在部署过程中需要配置模型信息！

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

# 安装包准备（必须）

CoMi智能部署工具从商务公布的安装程序地址下载（文档中心-文档库-营销中心-营销体系销售管理知识库-产品下载地址-提交给区域产品下载地址xxx.xls），产品线对应AI：

注意：CoMi智能部署工具部署包 和 CoMi相关服务部署包 是两个文件夹，项目上需要根据自身环境情况下载两个文件夹的部署包。

CoMi智能部署工具部署包：

CoMi相关服务部署包：

# 部署工具安装和访问

# 部署工具运行架构图

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

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

部署工具网络要求：

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

部署工具部署位置根据项目情况规划，以下整理几个典型场景的规划：

如客户单台服务器资源足够大，CoMi及BI相关服务都计划部署在这台服务器，则可以将部署工具也上传部署在这个服务器或其它同局域网服务器
如客户服务器较多，CoMi基础服务、BI、CoMi Server（APP服务）计划分离部署，则可以将部署工具上传部署在任意一台上面或其它同局域网的服务器

# 部署工具安装和运行

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

x86服务器下载：Deployer-Tools-v2.0-linux-x86_64.zip
arm服务器下载：Deployer-Tools-v2.0-linux-arm_64.zip

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

# 创建工具存放目录
mkdir -p /data/comi-deployer-tools
# 将上传的zip包解压到工具存放目录（示例为X86工具包）
unzip Deployer-Tools-v2.0-linux-x86_64.zip -d /data/comi-deployer-tools/
# 检查解压后的目录文件是否存在（示例为X86工具包）
cd /data/comi-deployer-tools/Deployer-Tools-v2.0-linux-x86_64/
ls

3、部署工具端口调整（按需）：工具默认端口9526，可修改startup.sh文件按需调整端口。

vim startup.sh

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

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

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

如无法访问，则考虑部署工具服务器防火墙是否未放开端口（如默认9526）访问权限。

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

# 部署工具安装CoMi步骤

# 一、新建环境项目

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

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

在弹出的“主机维护”窗口中，需要准确填写主机信息：

主机别名：自定义，填写清晰明确的名称方便识别
IP地址：目标服务器局域网IP地址
SSH端口、用户名、认证方式（支持密码认证或密钥认证）、密码：按需准确配置，需要确保当前部署工具服务器能通过SSH连接到目标服务器

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

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

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

# 二、上传解析CoMi部署包

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

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

产品提供了两种部署包上传解析方式：[本地上传部署包自动解析] 和 [输入服务器部署包路径自动解析]

方式一：本地上传部署包：

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

最终，您准备好的文件夹结构应如下所示：

- comi-v2.0-packages.zip
  |- AI-Manager_linux-x86_64.zip
  |- Qdrant_linux-x86_64.zip
  |- AI-Engine_centos7-x86_64.zip
  |- AI-Security_centos7-x86_64.zip
  |- seeyon-datapulse_linux_x86_64.zip
  |- Comi-Server-linux-x86_64.zip

点击上传区域，选择您已准备好的、包含所有服务安装包的部署压缩包（例如 comi-v2.0-packages.zip），工具将自动上传。

方式二：输入服务器部署包路径：如果您已将包含CoMi系列部署包 .zip文件提前上传至部署工具所在的服务器指定目录，可选择此项并填入zip文件目录绝对路径，直接解析目录文件。

以上方式二选一，确保最终解析出服务器环境规划表为止：

# 三、配置CoMi核心服务

# CoMi核心服务配置流程

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

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

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

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

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

5、当所有需要部署的服务的参数都填写完毕后，点击服务列表左下角的 [一键配置校验] 按钮

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

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

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

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

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

# CoMi核心服务详细配置说明

# Qdrant向量数据库配置

Qdrant 是存储知识库向量数据的核心组件，安装 CoMi V2.0时必选。

配置说明：

通常情况下，保持默认配置即可。除非目标服务器上的端口已被占用，或您有特定的部署路径规划，否则建议您无需修改。
部署模式：
- 重新安装（默认）： 部署全新的 Qdrant 服务
- 跳过安装使用现有实例：连接已安装的 Qdrant 服务并保留数据（需确保 IP 和端口配置正确），在预检查页面会检查端口占用，这时候需要把已有的qdrant停止后再检查，检查通过后在启动然后进入下一步开始部署
目标主机：指定把Qdrant服务安装到哪一个服务器上，下拉列表数据关联**主机管理与连接**中添加的主机
HTTP运行端口：默认为 6333。AI-Engine访问qdrant需要使用此端口
GRPC运行端口：默认为 6334。AI-Manager访问qdrant需要使用此端口
部署路径：服务在目标服务器上的安装目录，默认为 /data/Seeyon/Comi/qdrant，如果选择跳过安装，则该地方需要填一个空目录

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

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

配置说明：

基础信息
- 目标主机： 指定 AI-Manager 服务的部署目标服务器。
- 运行端口： 默认 8181，用于对外提供管理接口服务。
- 部署路径： 默认路径为 /data/Seeyon/Comi/ai-manager ，用于存放程序包、日志及配置文件。
- 产品线： 根据实际协同 OA 版本选择 A6、A8/A8N、G6/G6N 或 A9（云原生产品线），该项决定初始化 SQL 脚本及预置智能体模板的加载路径。
- 当前CoMi版本：新客户无需选择。如果是CoMi V1.1升级场景需要选择1.1，工具会执行从1.1到2.0的升级SQL。
数据库配置
- AI-Manager 依赖独立数据库，新建一个空库，确保数据库服务处于可使用状态。详细要求见【CoMi数据库准备】章节。
- 数据库类型： 下拉框选择你的数据库，注意数据库有版本要求，详细要求见【CoMi数据库准备】章节。
- JDBC URL： 工具会自动生成JDBC URL模板。请 手动修改 模板中的变量为实际信息 ${ip}对应<主机IP>, ${port}对应<端口>, ${database}对应<数据库名>
- 用户名、密码: 在用户名和密码框中，输入数据库的登录信息。 （注意：此账号需有建表权限）
- 测试连接： 务必点击 [点击按钮进行测试] 。只有测试成功后，才能继续下一步。
- 【重要提示 - 升级与重试场景】: 如果您正在执行 旧版本升级 ，请先备份原数据库。若后续部署过程失败，请恢复备份后再重新部署，避免在已被修改的数据库上继续操作导致错误。

# 达梦连接url（示例）
jdbc:dm://10.3.4.206:5236/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连接url（示例）
jdbc:postgresql://127.0.0.1:5432/ai_manager

集成配置
- 协同 OA 的反向代理地址： 必填项，填写 Nginx 反向代理协同 OA 的完整内网访问地址（通过NG能访问协同的http地址），示例如 http://192.168.188.168:80，该地址用于回调与授权验证。
- AI-Engine 服务地址： 集中部署保持默认值， ws://[AI-Engine主机IP]:8000，由部署规划自动填充，AI-Manager 通过此地址与引擎服务通信。
- AI-Security 服务地址： 集中部署保持默认值， ws://[AI-Security主机IP]:9000，为可选项，由部署规划自动填充，用于敏感词检测服务调用。
- 向量库主机与 gRPC 端口： 会关联 Qdrant 服务配置自动填充，默认端口为 6334，AI-Manager 通过该端口与 Qdrant 建立 gRPC 连接。
- OA OCR 服务地址与 V8 OCR 服务地址： 为选填项，分别用于文本识别扩展，未部署OCR可保持默认值
存储与文件路径
- 日志存储路径： 默认位于部署路径下的 logs 目录，用于保存运行日志；自动生成，无需手动修改
- 文件临时存储路径： 为部署路径下的 temp 目录，用于缓存临时文件；自动生成，无需手动修改
- 静态资源路径： 默认指向 frontend 与 static 目录，用于存放前端页面与静态文件；自动生成，无需手动修改。

# AI-Engine智能引擎配置

AI-Engine 是执行Agent智能体语义理解和逻辑调度的核心Python服务。

配置说明：

基础信息
- 目标主机: 指定服务部署的目标服务器。必填，升级时不可修改。
- 运行端口: 服务监听端口，默认 8000。必填，升级时不可修改。
- 部署路径: 服务安装目录，默认 /data/Seeyon/Comi/ai-engine。必填，升级时不可修改。
集成配置
- 向量库URL: Qdrant 的 HTTP 地址。根据 Qdrant 配置自动生成，只读。
- AI Manager 服务地址: AI-Manager 的访问地址。根据 AI-Manager 配置自动生成，只读。
- 向量模型标识: Embedding 模型标识，必填，建议临时填写成客户Embedding模型的model名称。此标识在本次部署 AI-Engine 时预先定义。部署完成后，在 CoMi Builder 后台【模型】页面创建或配置 Embedding 模型时，【模型标识】字段必须输入与此处完全相同的值，以确保 AI-Engine 能正确关联并使用该模型，否则可能导致连接失败。
- 向量维度: Embedding 模型输出维度，默认 1024。需与客户使用的模型实际维度匹配，范围 256-2048，必填。
存储/文件路径
- 日志路径: 存放运行日志的目录。根据部署路径自动生成，默认为 ${ai-engine.basic.deployment_path}/logs。只读。
- 临时数据路径: 存放临时数据或文件的目录。根据部署路径自动生成，默认为 ${ai-engine.basic.deployment_path}/data。只读。
安全与认证
- AI Manager API KEY: 此 Key 用于 AI-Engine 与 AI-Manager 之间的安全通信。在首次部署时，您无需填写此项，部署工具将自动生成并配置到 AI-Manager服务中。您将在部署完成后的报告或指引中获取此 Key，用于配置协同 OA 平台。

# AI-Security安全服务配置

AI-Security 是负责敏感词检测等安全策略的组件，为可选部署项。

配置说明：
- 目标主机：已自动选择，无需修改。
- 运行端口：默认为 9000。
- 部署路径：默认为 /data/Seeyon/Comi/ai-security。
- 日志路径：默认为 logs，即部署路径下的 logs 文件夹。
通常保持默认配置即可，如遇端口冲突或路径问题再行调整。

# CoMi Server App服务配置

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

配置说明
- 基础信息：
  - 目标主机：指定 CoMi Server 服务部署的目标服务器。必填，升级时不可修改。
  - 运行端口：服务监听端口，默认 8081。必填，升级时不可修改，取值范围 1024-65535。
  - 部署路径：服务安装目录，默认 /data/Seeyon/Comi/comi-server。必填，升级时不可修改。
数据库配置
- **数据库类型：**下拉框选择你的数据库（目前支持的数据库类型有 MySQL 5.7或8.0、PostgreSQL 13.3+、Oracle 19c（其它不支持）、SqlServer 2019、达梦8.4、人大金仓V8（Oracle兼容））。
- JDBC URL：工具会自动生成 JDBC URL 模板。请手动修改模板中的 ${ip}:<主机IP>, ${port}:<端口>, ${database}:<数据库名> 为你的实际数据库信息。
- 用户名、密码: 在 用户名 和 密码 框中，输入数据库的登录信息。（注意：此账号需有建表权限）
- 测试连接：务必点击 [点击按钮进行测试]。只有测试成功后，才能继续下一步。
- 【重要提示 - 升级与重试场景】:
  - 如果您正在执行旧版本升级，请先备份原数据库。若后续部署过程失败，请恢复备份后再重新部署，避免在已被修改的数据库上继续操作导致错误。
集成配置
- 协同OA反向代理地址：CoMi Server 的外部访问入口。必填，需填写完整 URL，例如 http://[nginx主机IP]:[nginx端口]。
- AI Manager 服务地址：AI-Manager 的访问地址。由系统根据 AI-Manager 配置自动生成，仅供查看。只读。
安全与认证
- 系统管理员-信息集成配置-三方互信访问权限修改（Comi一键登录）三方互信账号，用于CoMi App 的一键登录
- 回调地址：http://comi服务器ip:8081/comi/relation/callBack
- 绑定IP：comi服务器ip
- 填写完成后复制ID和密钥填写到工具中
- 三方互信 ID：系统间通信的唯一标识。必填。
- 三方互信密钥：对应的安全密钥。必填。
- API KEY：AI-Manager 为 CoMi Server 分配的通信密钥，由部署工具自动注入。只读。
存储与文件路径
- 日志存储路径：运行日志目录。自动根据部署路径生成，默认为 ${comi-server.basic.deployment_path}/logs。只读。
- 文件上传路径：文件存储目录。自动根据部署路径生成，默认为 ${comi-server.basic.deployment_path}/uploads。只读。
腾讯语音识别配置（可选）
- App ID / Secret Id / Secret Key：腾讯云语音识别服务凭证。需在腾讯云控制台申请后填写。
一键登录配置（可选）
- iOS 配置：包含 App ID、App Key、App Secret、Public Key、Private Key 等字段，需与苹果开发者控制台配置一致。
- Android 配置：包含 App ID、App Key、App Secret、Public Key、Private Key 等字段，需与腾讯或运营商登录服务配置一致。
实时转录配置（可选）
- App Key / Access Key / Access Key Secret：阿里云实时语音转录服务凭证，用于语音识别调用。

# 协同驾驶舱 (智能问数 BI)配置

此服务为智能问数功能提供数据处理和报表能力，为可选部署项。

配置说明：

基础信息：
- 目标主机：【必填】 选择需要部署到的目标主机
- 运行端口 (8058)、部署路径 通常保持默认即可。
集成配置：
- 协同OA的反向代理地址： 【必填】 填写Nginx代理协同OA的完整访问地址，例如 http://10.2.4.51:8080 。

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

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

操作步骤：

从“Nginx服务器主机”的下拉框中，选择一台已添加的主机作为Nginx服务器。
填写该服务器上Nginx的“主目录配置”的绝对路径nginx.conf所在的目录下。

工具会自动生成一份 comi.conf 配置文件，并提供清晰的操作指引，告知您在部署完成后，需要手动修改主配置文件 nginx.conf 以引入此文件。

# 四、环境预检查

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

注意：下一步按钮在页面底部右下角！

环境预检查功能说明：

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

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

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

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

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

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

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

# 五、自动化执行部署

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

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

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

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

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

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

ai-engine日志默认存放于 /data/Seeyon/Comi/ai-engine/logs
ai-manager日志默认存放于 /data/Seeyon/Comi/ai-manager/logs
qdrant日志默认存放于 /data/Seeyon/Comi/qdrant/qdrant.log
ai-security日志默认存放于 /data/Seeyon/Comi/ai-security/logs

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

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

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

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

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

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

# 一、Nginx增加CoMi配置

1、到Nginx服务器，通过修改主配置文件 vim nginx.conf 增加comi相关配置，仅需增加两块内容：

增加upstream统一管理AI-Manager地址
在协同OA的server块中增加include comi.conf;配置，让comi代理配置全部由comi.conf文件维护；如部署了智能问数，还需要增加include bi.conf;配置。

注：配置方法可以参考生成报告中的说明：

关于comi.conf和bi.conf配置文件文件：无需手动创建，如配置无误，在工具部署过程中会自动创建相关文件。

项目上只需要增加 comi start 到 comi end 区间的内容：

# comi start：增加AI-Manager的upstream配置（必须）
upstream ai_manager{
    # 这里IP端口指向AI-manager地址
    server 192.168.188.170:8181;
}
# comi end：增加AI-Manager的upstream配置

# 代理协同OA
server {
    listen 80;
    server_name  localhost;
    charset utf-8;

    # comi start:关联comi配置文件（必须）
    include comi.conf;
    # comi end:关联comi配置文件

    location / {
        proxy_pass http://seeyon_v5_cluster;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header REMOTE-HOST $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_redirect http:// $scheme://;
        proxy_connect_timeout 300;
        proxy_read_timeout 300;
        proxy_send_timeout 300;
    }
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   html;
    }
}

upstream seeyon_v5_cluster{
    sticky;
    server 192.168.188.169:81 max_fails=300 fail_timeout=30s;
}

Nginx配置示例截图如下（红框部分是新增comi配置）：

2、检查配置并重新加载Nginx配置

# 检查配置是否正确（示例代码见截图）
./nginx -p nginx目录 -c nginx.conf配置文件路径 -t

# 重新加载配置，使配置生效（示例代码见截图）
./nginx -p nginx目录 -c nginx.conf配置文件路径 -s reload

# 二、协同配置CoMi并启动

完成Nginx相关配置后，到协同服务器增加CoMi相关连接配置：修改协同OA部署目录下的 base/conf/plugin.properties 文件（若目录下没有plugin.properties就创建这个名字的文件再配置），增加与CoMi相关的三个参数配置ai.comibuilderServer、ai.managerUrl、ai.comi.apikey，相关配置在工具部署生成报表中，直接拷贝粘贴即可。配置完成后，需要重启协同OA才能生效！

注意：协同加密狗需要提前注册更新CoMi所需插件授权，所需插件详见《CoMi V2.0环境准备指导手册 (opens new window)》。

# 三、协同后台访问CoMiBuilder

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

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

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

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

必须配置LLM模型和Embedding模型，并且设置成默认模型：

# 五、协同初始化CoMi应用

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

2、提醒：必须完成上一步模型配置和默认模型设置再进行本章节操作，数据初始化依赖LLM模型和Embedding模型：

3、先初始化应用：应用列表默认只显示5条，需要通过翻页组件切换为100条，再全选所有应用列表，最后点击确定，将所有智能体应用初始化：

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

# 六、CoMi智能体应用授权

上一步数据初始化完成后，协同集团版用集团管理员登录后台管理页面，协同企业版用单位管理员登录后台管理页面。

进入【智能应用设置】点击【Comi应用授权】：

集团管理员“授权单位”，只是授权给单位管理员，再由该单位的单位管理员针对单位下人员进行授权
“授权用户”则是直接给指定普通用户授权智能体应用使用权限，普通用户重新登录系统就能看到相关智能体应用
注意：可授权人员数量受购买插件时注册用户数量控制。比如申请了100注册数，则每个智能体应用只能授权100位用户。

如进入CoMi应用授权页面报错，同样参考《CoMi部署配置常见异常解决方案 (opens new window)》寻找根本原因修复。

下一步，集团管理员 → CoMi工作台，授权全集团或指定单位（如果是企业版产品线，忽略本步操作）：

下一步，单位管理员 → CoMi工作台，授权全单位或指定人员：

以上全部完成后，切换到个人空间，检查是否出现小章鱼按钮：

# 七、用户使用CoMi

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

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

智能体页签仅显示用户被授权的智能体应用：

# 八、详细功能见操作手册

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

# 九、全文检索配置协同知识搜索（按需）

如需需要使用CoMi智能检索协同、文档、公文等数据，需要准备全文检索服务并且进行相关配置同步操作，详细手册见《CoMi V2.0全文检索协同知识检索配置手册 (opens new window)》

# 十、智能问数BI集成配置（按需）

如果您在部署 CoMi 的同时，也通过向导工具勾选并部署了智能问数 BI 服务（DataPulse），还需要进行 BI 服务自身的初始化配置。

1、 访问 BI 初始化页面： 通过浏览器访问 BI 服务的地址（Nginx 代理地址或直接 IP:端口，如 http://<BI服务器IP>:8058）。

2、 执行初始化向导： 根据《协同驾驶舱（BI）3.0 部署手册 (opens new window)》中的 初始化配置 章节指引，完成以下步骤：

基础信息配置（设置 admin 密码等）。
数据仓库配置（连接 PostgreSQL 数据库）。
协同数据库配置（连接协同 OA 的业务数据库）。
协同地址配置（配置 BI 服务地址到协同 OA 后台，并获取连接密钥/信道信息填回 BI）。

3、 验证集成： 完成初始化后，尝试在协同 OA 中访问智能问数相关功能，或直接登录 BI 后台（使用初始化时设置的 admin 密码），确认集成成功。

# 日常维护操作

# 日常启停CoMi服务

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

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

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

# 查看CoMi日志

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

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

ai-engine日志默认存放于 /data/Seeyon/Comi/ai-engine/logs
ai-manager日志默认存放于 /data/Seeyon/Comi/ai-manager/logs
qdrant日志默认存放于 /data/Seeyon/Comi/qdrant/qdrant.log
ai-security日志默认存放于 /data/Seeyon/Comi/ai-security/logs

# 修改CoMi配置

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

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

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

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

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

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

# 修改Nginx地址操作

如果项目涉及调整Nginx服务地址（如http切换https 或更换NG端口），除了更新AI-Manager关于NG的配置之外，还需要重新初始化应用等一系列操作，涉及操作如下：

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

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

3、重新初始化智能体应用：如修改NG地址发现CoMi无法调用工具接口，需要重新初始化智能体。

到CoMi数据库执行SQL重置初始化状态：

update ai_data_transfer_info set status = -1 where type = 1;

到协同系统管理员后台，参考【协同初始化CoMi应用】章节重新初始化应用再测试功能是否可用。

# 常见问题

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

编撰人：admin、het、hufei、wangyxyf

快速跳转

CoMi V2.0智能部署工具安装升级手册

← CoMi V2.0环境准备指导手册 CoMi V2.0基于Docker一体化部署手册 →