看到您运行zai服务使用的是windows系统，请参照一下步骤。

下载ZAI_beta2版本

注意到您当前使用的禅道ZAI插件版本为Beta2，而ZAI服务版本为Beta1。请先升级zai服务至beta2版本。

先下载zai服务的beta2版本。

<windows: https://dl.zentao.net/zai/zai_win_x64_beta2.zip>

<linux: https://dl.zentao.net/zai/zai_linux_x64_beta2.zip>

安装ZAI服务使用的数据库

ZAI服务使用的是带有pgvector插件（用于向量化存储）的PostgresSql。您可以从 https://dl.zentao.net/zai/postgresql-17.4-2-windows-x64-binaries.zip 下载编译好的带有pgvector的postgresql包。解压您将获得pgsql文件夹，进入它。

建议将pgsql放在C盘的根目录里。

配置并启动数据库（如已做过请忽略）

初始化数据库文件夹。

C:\pgsql\bin\initdb.exe -D C:\pgsql\data

编辑 C:\pgsql\data\postgresql.conf, 修改以下行。

listen_addresses = '*'

启动数据库服务。

C:\pgsql\bin\pg_ctl.exe -D C:\pgsql\data -l C:\pgsql\logs\logfile start

配置数据库。（创建数据库）

C:\pgsql\bin\psql.exe postgres
postgres=# CREATE ROLE user1 WITH LOGIN PASSWORD '123456';
CREATE ROLE
postgres=# CREATE DATABASE zai OWNER user1;
CREATE DATABASE
postgres=# \c zai
您现在已经连接到数据库 "zai",用户 "xxxx".
zai=# CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION

以 postgres=# 或 zai=# 开头表示在pgsql中执行的语句。

运行zai服务

解压进入到 C:\zai_win_x64_beta2\ 中。

修改zai配置文件

修改 appsettings.json 。

• ConnectionStrings：数据库连接字符串  （重要）

  • Default: Host=数据库地址(localhost); Port=数据库端口(5432) Database=zai; Username=user1; Password=123456;

  • RabbitMQ: 不填

  • Redis：Redis 连接字符串 默认空为不启用

• ServerSettings.BaseUrl：暴露给用户访问的服务器地址  （重要）（本机ip）

• Kestrel.Endpoints.Http.Url：后端HTTP 服务地址和端口 （重要）（服务地址与ServerSettings.BaseUrl相同）

• LlmProviderSettings：LLM 提供商设置（OpenAI格式）

  • Endpoint：LLM 提供商 API 端点 （重要）

  • Key：LLM 提供商 API 密钥 （重要）

  • DefaultChatModel：默认聊天模型 （重要）

  • Models 您所持有的模型提供商所提供的key中包含的模型。

    • Provider 模型提供商名称。

    • ModelId 模型的唯一ID，一般是固定的，一种模型对应一个ID。

    • ModelName 模型的名称

    • Abilities 模型所具备的能力

关于大模型配置请参照您所持有的模型提供商的API手册。举例OpenAI，其key可以在 API keys - OpenAI API 获得。推荐自建的openai模型服务，有关请参照 Overview - OpenAI API

运行ZAI服务

当您第一次运行zai服务时，会自动创建数据库的表。

.\zai.exe

可能的输出。

PS C:\zai_win_x64_beta2> .\zai.exe
[14:03:44 INF] License file found: C:\zai_win_x64_beta2\license.lic
[14:03:44 INF] License loaded successfully
[14:03:44 INF] Request: InitLlmProviderModelsCommand {"$type": "InitLlmProviderModelsCommand"}
[14:03:44 INF] Init LlmProviderModels
[14:03:44 INF] Init LlmProviderModels success
[14:03:44 INF] read init data
[14:03:44 INF] Request: InitDataCommand {"Account": "admin", "Password": "***", "Email": "admin@somecompany.com", "DisplayName": "系统管理员", "Workspace": "AgentSharp.InitWorkspace", "$type": "InitDataCommand"}
[14:03:44 INF] Initialize user
[14:03:44 INF] Initialize user role
[14:03:45 INF] Init workspace
[14:03:45 INF] Request: CreateWorkspaceCommand {"Name": "默认空间", "Description": "默认创建的空间", "Avatar": null, "CurrentUserId": "2185f5d8-777c-4b89-9bf9-d6248813632f", "$type": "CreateWorkspaceCommand"}
[14:03:45 INF] create workspace: {"Name": "默认空间", "Description": "默认创建的空间", "Avatar": null, "CurrentUserId": "2185f5d8-777c-4b89-9bf9-d6248813632f", "$type": "CreateWorkspaceCommand"}
[14:03:45 INF] Send memory notification event: {"Id": "684284c126fcee000b8760ff", "UserId": "2185f5d8-777c-4b89-9bf9-d6248813632f", "EventId": "73abbf51-1cca-4f1b-a875-060d4bda2d24", "EventCreationDate": "2025-06-06T14:03:45.4505997+08:00",
 "$type": "WorkspaceCreatedEvent"}
[14:03:45 INF] Initialization complete!
[14:03:45 INF] Now listening on: http://localhost:5000

你现在可以打开控制台 localhost:5000，查看您的模型信息是否正确配置。默认用户 admin 默认密码 123456 。

[系统管理] -> [模型管理] 查看您配置的模型信息。

beta版本请确保您的模型列表中有 gpt-4o-mini 。

与禅道连接

获取zai连接禅道的token

下载 https://dl.zentao.net/zai/zaicompose_beta2.zip 解压并进入。

.\zaiiniter.exe init

可能的输出：

appID: kfcngjiqpG
appToken: X9MWIaTnfiynu2IdyvTZct6wP6vwXjJl

将ID和Token填入禅道中

应用ID：AppID

主机：10.0.0.164（您的zai服务地址）

端口：5000（zai服务端口）

密钥：AppToken

如果您正确配置了这些字段，浏览器报错 Refused to connect to 'xxxxxx' because it violates the following Content Sec...... ，请在my.php中添加如下字段。注意修改 http://10.0.0.164:5000/ 为您的zai服务地址。