系统运维

# 致远新一代智能体产品家族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.安装包获取

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

名称 应用名称 安装包 依赖的中间件或环境 说明
Qdrant Qdrant 下载qdrant_windows下的压缩包 Qdrant向量数据库
ComiBuilder-Engine ai-engine 下载Windows目录下的seeyonagents.zip、agent_packages.zip、seeyonagents.zip python、conda、qdrant ComiBuilder-Agent引擎服务
ComiBuilder-Security ai-security 下载Windows目录下的ai-security-service.zip、miniconda.zip、sensitive_packages.zip python、conda ComiBuilder 安全服务
ComiBuilder-Manager ai-manager 下载与Windows相关的ai-manager-windows.zip、CoMi-Preset-assistants-1.1.zip、ai-manager数据库初始化脚本 mysql、qdrant、ai-engine ComiBuilder 管理服务

# 2.2.环境准备

# 2.2.1.服务器资源

序号 CPU 内存 磁盘 用途
1 4核 8GB 200GB ai-engine服务
2 4核 8GB 200GB ai-security服务
3 4核 16GB 200GB ai-manager服务、关系数据库、向量数据库
  • 1、所有Comi服务可以部署在一台服务器上面，按照以上表格保障资源大小即可
  • 2、NGINX直接复用V5的NGINX
  • 3、关系型数据库可以服用V5的数据库，支持以下数据库类型

1753404675156.png

# 2.2.2.系统基础环境

Windows Server系统需要客户提前准备：

序号 系统软件名称 配置建议 备注
1 操作系统 Windows server 2012及以上版本 客户准备

# 2.2.3.服务默认端口

服务 默认对外端口 是否必须 备注
AI-Manager 8181 必须 Comi管理服务
AI-Engine 8000 必须 Comi Agent引擎
AI-Security 9000 非必须 Comi 安全服务
Qdrant 6333、6334 必须 向量数据库
数据库 - 必须 可共用协同的数据库服务（针对AI新建一个表空间/数据库）
Nginx 80 必须 反向代理

# 2.2.4.授权文件准备

使用本组件，需要如下授权信息：

编号 授权信息 获取路径
1 CoMi智能体套件（CoMi运行引擎、CoMi超级入口、CoMi标准智能体） 致远商务侧下单申请，计价规则见商务报价

# 2.2.5.向量数据库部署

获取安装包(Qdrant中qdrant_windows下的qdrant_windows-x86_64_v.13.6.zip)

将安装包解压到规划的安装目录，如D:\comi\

1753405371591.png

启动qdrant

双击qdrant.exe即可启动服务

1753405472845.png

停止qdrant

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

1753405563172.png

# 3.AI-Engine部署

# 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.部署包

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

# 3.2.2.安装部署

1.安装miniconda3

首先解压下载的miniconda3.zip包，得到miniconda3的安装程序，双击安装程序，进行安装miniconda3, 一直下一步，安装路径可以自己选择或者使用默认路径

1753268177152.png

1753268187154.png

然后下一步，取消勾选第一项，点击Install

1753268211737.png

取消下面两个勾选，点击Finish

1753268220637.png

接下来添加环境变量

Win + R 输入sysdm.cpl，并确定

1753268245036.png

在打开的系统属性窗口，选择高级，并打开环境变量窗口

1753268255747.png

1753268269315.png

注意此处选择系统变量，编辑PATH，添加以下内容，注意实际路径以自己安装的路径为准

E:\comi\miniconda3;E:\comi\miniconda3\Scripts;E:\comi\miniconda3\Library\bin;

Win + R 输入cmd， 打开命令行窗口

1753268341666.png

输入conda -V 查看conda是否安装成功，如果输出版本号那么证明安装成功

1753268351582.png

2.下载agent_packages.zip并解压

1753268387896.png 下载seeyonagents.zip并解压

1753268402391.png

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

其中 -p 后面指定的目录是agent_packages.zip解压后的目录，我在上面示例中，将这个压缩包解压到了E:\comi\app\packages下。

此命令离线环境可使用，不依赖公网环境

第一次执行可能会报错

1753268426179.png

再重复执行即可，需要保证没有报错才能执行后面的部署步骤。

1753268435646.png

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

4.配置.env_llm.yaml 使用nodepad编辑 这一步暂时不用操作，使用默认的配置即可。等将ai-manage部署后，生成了对应的api_key后，在回来修改，并重启服务。

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

需要再power shell中执行

copy .env_llm.example.yaml .env_llm.yaml

1753268700036.png

其中标记为xxx的都需要根据实际配置进行替换：

# 所有第三方模型都需要接入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                                       # 向量维度 (暂时不用，勿动)

5.配置.env 使用nodepad编辑

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

需要再power shell中执行

copy .env.example .env

1753268787311.png

其中标记为xxx的都需要根据实际配置进行替换：

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

# 日志路径
SEEYON_AGENTS_LOGS_ROOT=/xxx/app/logs
SEEYON_AGENTS_TEMP_DATA_PATH=/xxx/app/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

# 3.3.服务启停

启动服务

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

1753268837300.png

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

停止服务

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

# 4.AI-Security部署（可选）

# 4.1.依赖说明

# 4.1.1.配置要求

CPU 内存 磁盘
4核 8GB 200GB

# 4.1.2.中间件或服务依赖

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

# 4.2.部署配置

# 4.2.1.部署包

类型 名称 说明
conda miniconda.zip miniconda3安装包
python sensitive_packages.zip conda虚拟环境及python离线安装包
ai-security包 ai-security-service.zip Agent Security项目代码包

# 4.2.2.安装部署

1.下载sensitive_packages.zip，并解压

1753268924357.png

下载ai-security-service.zip并解压

1753268939307.png

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

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

1753268963803.png

3.配置.env 使用nodepad编辑

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

需要再power shell中执行

copy .env.example .env

其中标记为xxx的都需要根据实际配置进行替换：

# 服务运行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部署

# 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.MySQL 数据库初始化

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

1753341574736.png

使用命令行或者客户端工具执行附件中的sql脚本即可。

create database ai_manager character set utf8mb4;

1753269063121.png

执行初始化sql:

1753269074660.png

1753269084557.png

# 5.2.2.JDK检查

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

# 5.2.3.解压部署包

将 ai-manager-windows.zip文件上传到目标服务器，并解压到指定目录。

ai-manager（服务安装目录）
    - ai-manager-assemble-xxxxxx.jar
    - application.yaml
    - jdk
    - frontend
    - startup.bat
    - static

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

在解压后的ai-manager目录中找到 application.yaml 文件，并根据实际情况进行配置。

监听端口：
修改server.port可以调整服务的监听端口，默认为：8181。
静态文件地址: 
配置 spring.web.resources.static-locations为前端静态文件的存储路径，确保配置的路径是准确的全路径。
文件存储路径: 
配置seeyon.ai.common.filePath为文件临时存储的路径。
数据源信息: 
seeyon.ai.datasource.url 数据库jdbc Url地址
seeyon.ai.datasource.username 数据库用户
seeyon.ai.datasource.password 数据库密码
agent引擎服务配置: 
seeyon.ai.websocket.manageUrl Agent引擎服务管理通道，修改其中的ip和端口
seeyon.ai.websocket.messageUrl Agent引擎服务消息通道，修改其中的ip和端口
seeyon.ai.websocket.sensitiveUrl 如果部署了ai-security服务，则修改为对应的ip和端口
Qdrant向量库地址: 
seeyon.ai.vector-stor.host Qdrant服务IP地址
seeyon.ai.vector-stor.port Qdrant服务监听端口
集成v5平台地址：
seeyon.ai.common.v5Address  集成v5访问地址配置，修改其中的ip和端口        
服务配置ip及端口：
seeyon.ai.common.baseUrl	ai-manager服务配置地址 修改为本机的ip地址和上面server.port端口且可以使用此ip和端口直接访问,注意：不可以填写127.0.0.1

关闭swagger：
springdoc.swagger-ui.enabled: false  设置限制swagger-ui的访问

设置JWT密钥：
seeyon.ai.common.secretSign:    随便一个uuid去掉中间的横线即可。如：1deb738fb6a23e6a4dad34b64d8a4f49

OA的OCR服务地址配置：
seeyon.ai.common.oaOcrUrl    修改为部署的oa端的ocr服务地址。如：
http://172.31.15.186:12841/ocr/pic/get_all_text

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

server:
  # (可选修改)监听端口，默认为：8181
  port: 8181
  tomcat:
    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:/comi/app/ai-manager/frontend,file:/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: root
      password: seeyon_123
    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: /comi/app/ai-manager/ai/temp
      # (需修改)修改为ai_manager服务器的IP
      baseUrl: http://127.0.0.1:8181/ai-manager
      # (需修改)集成v5时，注意修改为Nginx代理后的v5的访问地址和端口
      v5Address: http://127.0.0.1:10005
      # (需修改)集成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
  ocr:
    path: http://127.0.0.1:8000/recognize
    params:
      #     是否自动对大图进行切割与合并处理
      cutCheck: true
      #     是否对表格数据进行重复节的处理
      repeatedCheck: true
      #     对换行进行处理时判断是否临近行的最小距离，默认值为20
      yAdjacentDistance: 20
      #     一次LLM请求处理的判定任务限制数量，默认值为3
      limitedTaskNumber: 3
      #     重复节的序列形似识别阈值，默认值为0.5
      repeatedSetThreshold: 0.5
      #     多图片批处理的起始索引
      startIndex: 0
      #     多图片批处理的结束索引
      endIndex: 1

knowledge-source-chunk-max-size: 10

# 5.3.预置助手初始化

# 5.3.1.预置助手文件

将预置-系列助手.zip(CoMi-Preset-assistants-1.1.zip)文件解压到指定目录下。

具体路径为：application.yaml中配置的{seeyon.ai.common.filePath}/transfer/assistant/preset

目录不存在的话需要手动创建。

检查解压后的文件，包括assistant_preset.init文件和其他助手zip文件。

例如：

1753269212074.png

# 5.4.服务启停

# 5.4.1.启动服务

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

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

# 5.4.2.检查服务状态

在浏览器中访问以下地址以进入 AI-Manager 平台，并根据需要进行模型配置。

访问如下地址进行验证

http://: 端口默认为：8181

请根据实际的 IP 地址和端口号进行替换。

1753269561489.png

# 5.4.3.停止服务

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

# 5.5.日志维护

# 5.5.1.日志存储

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

# 5.5.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、协同配置更新启动

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

1747892980933.png

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

# 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-manage服务。

1747846462310.png

# 9、初始化CoMi应用

接入模型配置

购买CoMi后，登录协同OA系统管理员后台，进入【CoMi】，【模型】，点击【接入模型维护】

1747707301002.png

点击 "+" ，新建分类（分类名称可自定义）

1747847107311.png

再点击 "新增"，新增模型，根据模型类型，选择LLM或者Embedding模型:

  • 分类没有特别意义，项目上可根据不同特性做规划
  • 必须至少新建一个LLM模型和一个Embedding模型，用于后面的数据初始化

1747847334164.png

1747847472350.png

再次点击模型栏，返回上一级，点击新增，填写模型完整信息，LLM和Embedding需要分别新增一个：

1747847830783.png

1747848013194.png

保存后，通过“测试”确保大模型的连接状态为“通过”：

1747893449550.png

初始化智能体应用

登录协同OA系统管理员后台，访问CoMi Builder菜单-系统管理页签。

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

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

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

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

1747883777164.png

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

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

1753342619562.png

编撰人：het、wangyxyf、liubo

快速跳转

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