系统运维

# 致远新一代智能体产品家族CoMi V1.1安装部署手册Windows

# 1.概述

本文档主要针对在Windows Server服务器部署CoMi V1.1核心服务进行说明。

本手册不包含智能问数部署，如需智能问数，需要先部署本手册服务，再详见CoMi V1.1智能问数手册部署问数服务。

# 在线化资料支持

手册存在不定期更新，为了方便您获取最新资料，本手册在致远开放平台也放置了一份，建议您收藏以下地址，并尽量使用在线手册以获得最新的部署信息: https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjM3ODQ=

# 2.部署准备

# 2.1.环境要求

CoMi V1.1有多种部署方式，关于部署方式选择、部署架构图、服务器环境资源要求（配置要求）、插件准备要求、支持协同清单、大模型准备要求等 详见 《CoMi V1.1环境准备指导手册 (opens new window)》，请先完成环境准备再进行本手册部署！

# 2.2.安装包获取

从商务公布的安装程序下载地址（产品线为AI）下载CoMi V1.1部署包，将部署包上传至CoMi应用服务器。部署包主要包含如下内容：

名称 应用名称 安装包 依赖的中间件或环境 说明
miniconda3 miniconda3 miniconda3.zip Windows server 系统 用于创建Python环境
微软运行库 微软常用运行库 微软常用运行库合集.exe Windows server 系统 不安装qdrant无法正常运行
Qdrant Qdrant qdrant_windows-x86_64_v.13.6.zip 微软运行库 Qdrant向量数据库
初始化sql ai-manager的关系数据库 如：mysql.sql MySQL数据库 ai-manager服务的数据库初始化SQL
ComiBuilder-Engine ai-engine seeyonagents.zip、agent_packages.zip miniconda3、qdrant ComiBuilder-Agent引擎服务
ComiBuilder-Security ai-security ai-security-service.zip、sensitive_packages.zip miniconda3 ComiBuilder 安全服务（可选）
ComiBuilder-Manager ai-manager ai-manager-windows.zip mysql、qdrant、ai-engine ComiBuilder 管理服务
  • 在部署服务器数据盘目录创建“packages”目录，将安装包上传至“packages”目录中，如下图：

1756176705237.png

# 2.2.1.微软运行库安装(Windows服务器都需要安装)

Windows服务器都需要安装
Windows服务器都需要安装
Windows服务器都需要安装

  • 1、点击exe安装文件进行安装。

1756178592243.png

  • 2、“下一步”->“下一步”->“完成”

1756178603831.png

# 2.2.2.miniconda3安装

  • 1、在数据盘创建安装目录‘D:\comi\app\miniconda3’
  • 2、解压‘miniconda3.zip’安装包，双击exe文件开始安装；

1756178897679.png

  • 3、安装目录选择‘D:\comi\app\miniconda3’

1756178917895.png

1756178926427.png

1756178931782.png

  • 4、配置miniconda3环境变量，Win + R 输入sysdm.cpl，并确定

1756184530023.png

编辑系统变量 Path,将miniconda3的路径(D:\comi\app\miniconda3;D:\comi\app\miniconda3\Scripts;D:\comi\app\miniconda3\Library\bin;)添加进去

1756184705067.png

1756184827292.png

  • 5、验证miniconda3,Win + R 输入cmd， 打开命令行窗口;输入conda -V 查看conda是否安装成功，如果输出版本号那么证明安装成功

1756185190156.png

1756185210161.png

# 2.2.3.qdrant向量数据库部署

  • 1、解压‘’安装包，将解压后的文件夹整体复制粘贴到安装目录（D:\comi\app\qdrant-x86_64_v.13.6）,注意目录结构。

1756185482594.png

1756185657505.png

  • 2、启动qdrant

双击qdrant.exe即可启动服务

1756185711207.png

  • 3、停止qdrant

通过任务管理器结束qdrant进程即可

1753405563172.png

# 3.AI-Engine部署（需要提前部署好qdrant、miniconda3）

# 3.1.依赖说明

# 3.1.1.配置要求

CPU 内存 磁盘
4核 8GB 200GB

# 3.1.2.中间件或服务依赖

类型 名称 版本 说明
操作系统 Windows Server 2012及以上版本 用户预装
向量数据库 Qdrant 1.13.6及以上 下载Windows的安装包，需提前安装，和AI-Manager服务共用

# 3.2.部署配置

# 3.2.1.部署包

类型 名称 说明
python依赖库 agent_packages.zip conda虚拟环境及python离线依赖库
ai-engine包 seeyonagents.zip agents项目代码包

# 3.2.2.安装部署

1.创建python 虚拟环境并导入Python依赖库；

创建‘D:\comi\app\packages’目录，解压‘agent_packages.zip’到‘D:\comi\app\packages\agent_packages’;注意目录结构；

1756186428820.png

1756186412940.png

解压‘seeyonagents.zip’安装包到‘D:\comi\app\seeyonagents’；注意目录结构

1756186590485.png

1756186627022.png

2.以管理员命令打开cmd窗口，进入seeyonagents目录， 输入以下命令执行安装

service_env_install.bat -p D:\comi\app\packages

其中 -p 后面指定的目录是agent_packages.zip解压后的目录，我在上面示例中，将这个压缩包解压到了D:\comi\app\packages下。此命令离线环境可使用，不依赖公网环境

若执行过程中出现如下报错

1753268426179.png

停止运行中的python应用，如ai-engine和ai-secrity服务，然后重新执行service_env_install.bat -p D:\comi\app\packages，等命令执行成功后，在启动之前停掉Python服务。

1753268435646.png

4.复制‘.env_llm.yaml.example.windows’，并重命名为‘.env_llm.yaml’;

1756187417900.png

5.复制‘.env.example.windows’，并重命名为‘.env’。这个需要在powershell中执行copy命令，否者会报错；

copy .env.example.windows .env

1756187395838.png

1756187485002.png

6.修改‘.env’和‘.env_llm.yaml’ 配置文件

  • .env文件参照如下配置修改，其他不要动：

1、修改日志路径，使用相对路径；
2、根据实际情况修改向量数据库的地址；

# 配置运行端口
SEEYON_AGENTS_SERVER_PORT=8000
SEEYON_AGENTS_MAX_WORKERS=200
SEEYON_AGENTS_RESTORE_SESSION=True

# 日志路径
SEEYON_AGENTS_LOGS_ROOT=./logs
SEEYON_AGENTS_TEMP_DATA_PATH=./data
SEEYON_AGENTS_LOG=INFO

# 配置向量库
SEEYON_AGENTS_VECTORSTORE_TYPE=qdrant
SEEYON_AGENTS_VECTORSTORE_URL=http://x.x.x.x:6333
SEEYON_AGENTS_VECTORSTORE_EMBEDDING_LLM=ai_embedding
SEEYON_AGENTS_LOGS_FILESIZE=20
  • .env_llm.yaml文件参照如下配置修改，其他不要动；因为ai-manager还未部署，这一步暂时不用操作，使用默认的配置即可。等将ai-manage部署后，生成了对应的api_key后，在回来修改，并重启服务。
# 所有第三方模型都需要接入Comi builder
# ai manager 配置
ai_manager:                                                        # 默认名称，不可更改
  api_type: "openai"                                               # API类型, 默认值为openai
  api_version: ""                                                  # API版本号 (不用填)
  model: ""                                                        # 模型随agent配置 (不用填)
  base_url: "http://X.X.X.X:XXXX/v1"                               # AI Manager服务地址:端口
  api_key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"    # Ai Manager路由到服务菜单，找到Api Key 创建

# Embedding 配置
ai_embedding:                                                      # 默认名称，不可更改
  api_type: "openai"                                               # API类型, 默认值为openai
  api_version: ""                                                  # API版本号 (不用填)
  model: ""                                                        # 基础模型 (不用填)
  base_url: "http://X.X.X.X:XXXX/v1"                               # AI Manager服务地址:端口
  api_key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"    # Ai Manager路由到服务菜单，找到Api Key 创建
  embedding_model: "XXXXXXXXXXXXXXXXX"                             # 接入AI Manager的向量模型
  embedding_dimensions: 1024                                       # 向量维度 (暂时不用，勿动)

# 3.3.服务启停

启动服务

双击 start.bat, 即可运行服务，命令窗口不要关闭

1753268837300.png

查看服务运行及端口占用情况，具体端口号见 .env配置，默认为8000

停止服务

关闭启动打开的命令行窗口即可

# 4.AI-Security部署（可选，需要提前安装miniconda3）

# 4.1.依赖说明

# 4.1.1.配置要求

CPU 内存 磁盘
4核 8GB 200GB

# 4.1.2.中间件或服务依赖

类型 名称 版本 说明
操作系统 Windows Server 2012及以上版本 用户预装

# 4.2.部署配置

# 4.2.1.部署包

类型 名称 说明
Python库 sensitive_packages.zip Python虚拟环境及python离线依赖库
ai-security包 ai-security-service.zip Agent Security项目代码包

# 4.2.2.安装部署

1、创建Python虚拟环境，导入Python依赖库
创建‘D:\comi\app\packages’目录，解压‘sensitive_packages.zip’到‘D:\comi\app\packages\sensitive_packages’;注意目录结构；

1756189745164.png

1756189738300.png

解压‘ai-security-service.zip’安装包到‘D:\comi\app\ai-security-service’；注意目录结构

1756189830969.png

1756189822964.png

2.以管理员命令打开cmd窗口，进入ai-security-service目录， 输入以下命令执行安装, 其中 -p 后面指定的目录是sensitive_packages.zip解压后的目录，我在上面示例中，将这个压缩包解压到了D:\comi\app\packages下。

service_env_install.bat -p D:\comi\app\packages

1753268963803.png

若执行过程中出现报错，停止运行中的python应用，如ai-engine和ai-secrity服务，然后重新执行service_env_install.bat -p D:\comi\app\packages。等命令执行成功后，在启动之前停掉Python服务。

3.配置.env 使用nodepad编辑

复制.env.example， 并重命名为.env, 打开该文件进行编辑

需要再power shell中执行

copy .env.example .env

4.修改‘.env’配置文件
仅需要修改日志目录，如下：使用相对路径

# 服务运行IP，默认0.0.0.0
SERVER_HOST=0.0.0.0

# 服务运行端口，按需配置
SERVER_PORT=9000

# 日志目录
LOG_PATH=./logs

# 日志级别，可选：DEBUG, INFO, WARNING, ERROR
LOG_LEVEL=INFO

# 4.3.服务启停

启动服务

双击 start.bat, 即可运行服务，命令窗口不要关闭

1753268998317.png

查看服务运行及端口占用情况，具体端口号见 .env配置，默认为9000

停止服务

关闭启动打开的命令行窗口即可

# 5.AI-Manager部署（提前部署qdrant向量数据、关系型数据库）

# 5.1.依赖说明

# 5.1.1.配置要求

CPU 内存 磁盘 其他
4核 16GB 200GB 其中：日志保存180天，所需磁盘空间：30G

# 5.1.2.中间件或服务依赖

操作系统

类型 名称 版本 说明
操作系统 Windows Server 2012及以上版本 用户预装

中间件或服务依赖

类型 名称 版本 说明
关系数据库 MySQL 5.6 及以上 需提前安装，可以复用OA库
向量数据库 Qdrant 1.13.6及以上 需提前安装
AI引擎服务 AI-Engine 对应版本 参考第3章节部署
JAVA运行环境 JDK jdk17或以上 根据操作系统替换为对应的jdk，安装包中自带了，无需部署

# 5.2.部署配置

# 5.2.1.数据库初始化

在部署组件服务前需要先准备一个关系型数据库，用于存储CoMi的数据，关系型数据库可以复用协同的数据库服务（针对AI新建一个表空间/数据库）。CoMi支持的数据库版本要求：

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

根据v5的版本选择数据库的初始化脚本进行初始化，非A6版本的协同选择ai-manager1.0-非A6版本数据初始化脚本，A6、A8版本的系统选择ai-manager1.0-A6或A8版本数据库初始化脚本

确保关系型数据库部署完成后，连接到数据库服务进行数据库新建和SQL初始化：

1、创建名为ai_manager的数据库，以下提供不同数据库的建库语句：

-- 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数据库：
CREATE DATABASE ai_manager TABLESPACE 表空间名称 ENCODING 'UTF8';

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

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

2、向ai_manager数据库导入CoMi初始化脚本：

数据库脚本位于ComiBuilder-Manager部署包中，A6版本与其它版本初始化脚本不同，根据实际情况选择正确的初始化脚本：

1753503168116.png

初始化SQL脚本按不同数据库进行了分类，根据项目实际情况选择对应数据库的初始化脚本。

确定产品线、数据库，找到正确的数据库初始化SQL后，将SQL导入上一步创建的ai_manager数据库中，确保数据库下有对应初始化表。

# 5.2.2.JDK检查

ai-manager依赖JDK，安装包默认自带，检查解压后的ai-manager是否存在jdk即可。

# 5.2.3.解压部署包

将‘ai-manager-windows.zip’安装包解压到‘D:\comi\app\ai-manager’ ;注意目录结构

1756199812346.png

1756257514083.png

# 5.2.4.修改配置文件 使用nodepad编辑

在解压后的ai-manager目录中找到 application.yaml 文件，并根据实际情况进行配置。
需要修改如下内容：
1、seeyon.ai.datasource中数据库链接配置，数据源类型配置参考：

    # 达梦数据库示例配置:
    datasource:
      url: jdbc:dm://127.0.0.1:5237/ai_manager
      username: db_user
      password: db_password

    # 人大金仓数据库示例配置：
    datasource:
      url: jdbc:kingbase8://127.0.0.1:54323/ai_manager
      username: db_user
      password: db_password

    # postGreSql数据库示例配置：
    datasource:
      url: jdbc:postgresql://127.0.0.1:5432/ai_manager
      username: db_user
      password: db_password

    # sqlServer数据库示例配置：
    datasource:
      url: jdbc:sqlserver://127.0.0.1:1433;database=ai_manager
      username: sa
      password: Seeyon@123456

    # oracle 数据库示例配置：
    datasource:
      url: jdbc:oracle:thin:@127.0.0.1:1521/SEEYONDB
      username: AI_MANAGER
      password: Seeyon123456

2、spring.web.resources值的目录路径；
3、seeyon.ai.vector-store中qdrant的配置；
4、seeyon.ai.common中对应的值；
5、seeyon.ai.websocket中的URL；
6、seeyon.ai.common中的路径；
7、即使不是对接v8,其中v8的配置保持默认即可，不要去动；

其中，appliction.yaml文件的示例配置：

server:
  # (可选修改)监听端口，默认为：8181
  port: 8181
  tomcat:
    # 最大线程数设置为1000
    threads:
      max: 1000
    connection-timeout: 600000

spring:
  servlet:
    multipart:
      enabled: true #是否启用http上传处理
      max-file-size: 100MB #设置单个文件最大长度
      max-request-size: 500MB #最大请求文件的大小
  mvc:
    static-path-pattern: /ai-static/**
  web:
    resources:
      # (需修改)静态资源路径，将 you_path 修改为 ai-manager 的实际部署路径
      static-locations: file:D:/comi/app/ai-manager/frontend,file:D:/comi/app/ai-manager/static/

logging:
  # 日志级别
  level:
    root: info

seeyon:
  application:
    # 应用名称
    name: ai-manager
  ai:
    # (需修改)数据源配置，根据客户实际数据库信息修改
    datasource:
      url: jdbc:mysql://127.0.0.1:3306/ai_manager
      username: xxxx
      password: xxxxxx
    websocket:
      # (需修改) ai-engine 服务管理通道，修改其中的ip和端口
      manageUrl: ws://127.0.0.1:8000/agent/services
      # (需修改)ai-engine 服务消息通道，修改其中的ip和端口
      messageUrl: ws://127.0.0.1:8000/agent/msg
      # (需修改)ai-security 敏感词消息通道，修改其中的ip和端口
      # sensitiveUrl: ws://127.0.0.1:9000/sensitive/services
      token: ai-engine
    # 向量数据库配置，修改为实际部署的qdrant地址和端口
    vector-store:
      engine: qdrant
      host: 127.0.0.1
      port: 6334
    common:
      # (需修改)文件临时存储的路径
      filePath: D:/comi/app/ai-manager/temp
      # (需修改)修改为ai-manager服务器的IP
      baseUrl: http://10.1.141.246:8181/ai-manager
      # (需修改)集成v5时，注意修改为Nginx代理后的v5的访问地址和端口
      v5Address: http://10.1.141.246:80
      # (需修改)集成v8时，修改为v8的访问地址和端口，v5客户请忽略
      v8Address: https://dev.seeyonv8.com
      encryRequired: false
      commonFileSuffixes: txt,md,markdown,rtf,zip,rar,7z,tar,gz,jpg,jpeg,png,gif,bmp,tiff,tif,webp,doc,docx,xls,xlsx,pdf,rep,csv,json
      oaOcrUrl: http://172.31.15.186:12841/ocr/pic/get_all_text
      v8OcrUrl: http://192.168.80.41:8666/udc/recognize

knowledge-source-chunk-max-size: 10

# 5.3.服务启停

# 5.3.1.启动服务

进入解压目录，以管理员身份运行 startup.bat 脚本以启动 AI-Manager 服务。

看到日志显示Tomcat started on port xxxx (http) with context path 类似字样时，代表服务成功启动。

# 5.3.2.停止服务

停止服务，关闭cmd窗口即可。

# 5.4.日志维护

# 5.4.1.日志存储

系统基于logback日志框架存储日志，在{ai-manager部署位置}/logs目录下的Info、error、llm分别存储Info级别、error级别以及大模型访问的相关日志。

# 5.4.2.日志清理及转存

日志存储周期为180天，超过180天的日志系统会自动清理。

如果在180天内磁盘空间不足或者需要保存更长时间日志需要手动备份相关的日志文件。

# 6 Nginx配置

1、Nginx部署后，首先参考《协同OA反向代理和负载均衡 (opens new window)》进行协同的代理配置，确保通过NG能访问协同系统之后，再进行CoMi的代理配置。

2、修改nginx.conf增加comi相关配置，仅需增加两块内容：

  • 增加upstream统一管理AI-Manager地址

  • 在协同OA的server块中增加include comi.conf;配置，让comi代理配置全部由comi.conf文件维护

# comi start到comi end是增加的comi配置

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

upstream seeyon_v5_cluster{
    sticky;
    server 192.168.0.70:80 max_fails=300 fail_timeout=30s;
}

# comi end：增加AI-Manager的upstream配置

# 代理协同OA
server {
    listen 8080;
    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;
    }
}

3、在nginx.conf同级目录下新建comi.conf（编辑comi.conf），将如下配置完整保存到comi.conf（不用特殊调整任何参数）：

location ~ /\.(git|env|svn|htaccess|bak|old|swp)$ {
    deny all;
}
location /ai-static {
    proxy_set_header X-Real-Ip $remote_addr;
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_pass http://ai_manager;
    proxy_buffering off;
}
location ^~ /seeyon/ai-platform/ai-manager/agent/info/call/sse{
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    # SSE 连接时的超时时间
    proxy_read_timeout 86400s;
    # 取消缓冲
    proxy_buffering off;
    # 关闭代理缓存
    proxy_cache off;
    rewrite ^/seeyon/ai-platform(.*)$ $1 break;
    proxy_pass http://ai_manager;
}
location ^~ /seeyon/ai-platform/backend {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-Proto $scheme;
    rewrite ^/seeyon/ai-platform(.*)$ $1 break;
    proxy_pass http://ai_manager;
    set $nocache 1;
    proxy_cache_bypass $nocache $cookie_nocache $arg_nocache $arg_comment;
}
location ^~/seeyon/ai-platform/frontend {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-Proto $scheme;
    rewrite ^/seeyon/ai-platform(.*)$ $1 break;
    proxy_pass http://ai_manager;
    set $nocache 1;
    proxy_cache_bypass $nocache $cookie_nocache $arg_nocache $arg_comment;
}
location ~ /seeyon/ai-platform {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $http_host;
    rewrite ^/seeyon/ai-platform(.*)$ $1 break;
    proxy_pass http://ai_manager;
}
location /ai-manager {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $http_host;
    proxy_pass http://ai_manager;
}
location = /seeyon/ai-platform/ai-manager/assistant/info/call/stream {
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    # SSE 连接时的超时时间
    proxy_read_timeout 86400s;
    # 取消缓冲
    proxy_buffering off;
    # 关闭代理缓存
    proxy_cache off;
    # 禁用分块传输编码
    chunked_transfer_encoding off;
    gzip off;
    rewrite ^/seeyon/ai-platform(.*)$ $1 break;
    proxy_pass http://ai_manager;
}

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

1753270208517.png

# 检查配置是否正确（示例代码见截图）
nginx -t

5、启动NGINX

双击运行NGINX

1753270299471.png

# 7、协同配置更新启动

# 配置OA

协同侧加密授权需要包含CoMi相关插件，将授权seeyonkey更新到协同程序/base/license目录下。

1747892980933.png

CoMi相关服务部署后，修改协同OA部署目录下的 base/conf/plugin.properties 文件。新增以下配置后，需要重启协同OA才能生效！

“ai.comi.apikey = YNVefeUt6HP98SKkL52k37BZjo6vSsl5uUaeKT9qtYFvkggjD9”，其中apikey，需要在“8、创建ComiBuilder API Key”完成后，配置到此处，然后重启v5服务。

# http://10.1.141.246是Nginx代理协同OA的地址，请按照实际情况修改
ai.comibuilderServer=http://10.1.141.246/seeyon/ai-platform/ai-manager/assistant/info/getAllRightsAssistant
# ai.managerUrl必须配置ai-manager服务器的IP加端口；不能配置NGINX的地址；
ai.managerUrl = http://10.1.141.246:8181/ai-manager
ai.comi.apikey = YNVefeUt6HP98SKkL52k37BZjo6vSsl5uUaeKT9qtYFvkggjD9

也可以通过运行ApacheJetspeed/conf/SeeyonConfig.sh协同系统配置工具可视化修改：

如无相关配置，请检查是否存在CoMi授权插件，以及当前协同的BuildID在CoMi支持范围内，详见【适配协同版本】章节！如备注涉及打补丁，按照【适配协同版本】章节的注意事项下载安装补丁再进行配置。

1747905299387.png

首次更新CoMi插件并启动协同系统，可能遇到启动过程中卡住超过7分钟才完成的情况，这个是正常现象，thirdInterfaceFactory会连接互联网CVE等漏洞平台获取安全相关的信息，供安全助理智能体应用使用：

1747893055507.png

# 8、创建ComiBuilder API Key

确保协同系统启动后，协同系统管理员（分保插件模式下，是在安全管理员）登录到后台，访问CoMi Builder菜单-服务页签，创建API Key：

如无相关菜单，请检查是否存在CoMi授权插件，以及当前协同的BuildID在CoMi支持范围内，详见【适配协同版本】章节！

1747845754552.png

为AI-Engine服务创建一个API Key：

1747846039198.png

拷贝创建的api key

1747846008781.png

回到AI-Engine配置.env_llm.yaml章节将系统管理员（分保插件模式下，是在安全管理员）创建的api key配置到配置文件中。配置完成后，重启ai-engine服务。

1747846462310.png

回到"7、协同配置更新启动"章节将系统管理员（分保插件模式下，是在安全管理员）创建的api key配置到配置文件中。配置完成后，重启v5服务。

1756263227120.png

# 9、初始化CoMi应用

接入模型配置：

此步必做，参考《CoMi模型配置操作手册 (opens new window)》进行CoMi依赖的模型参数配置和默认模型设置。

初始化智能体应用：

登录协同OA系统管理员（分保插件模式下，是在安全管理员）后台，访问CoMi Builder菜单-系统管理页签。

1、选择“数据初始化”：

2、初始化数据配置填写如下内容：

  • 模型标识：对应模型页签中配置的LLM大模型
  • 协同baseUrl：对应协同的Nginx代理地址（地址不含/seeyon），详见示例截图
  • 向量模型标识：对应模型页签中配置的Embedding模型

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

1747883777164.png

4、观察所有应用的初始化进度，如出现异常，需要根据ai-manage日志分析解决异常，再重新初始化： 1753271314726.png

5、使用同样的方式，初始化agent和工具

1753342619562.png

# 常见问题

如部署配置过程中遇到异常，参考《CoMi部署配置常见异常解决方案 (opens new window)》中的问题现象和解决方案排查解决。

编撰人：het、liubo、zhuhui、wangyxyf

快速跳转

← 工具可视化部署CoMi V1.1手册Linux →