AI插件安装 分享链接/book/zentaopms/1773.html?releaseID=21

一、获取AI插件 

可以到禅道官网->应用商店下载AI插件。 

禅道官网应用商店地址： https://www.zentao.net/extension-viewext-313.html

目前我们的AI插件兼容禅道开源版21.7.4，企业版12.3，旗舰版7.3，IPD版4.3版本。

注意：开源版21.7.6、企业版12.5、旗舰版7.5，IPD版4.5版本及以上版本已实现AI插件中的内容，无需安装此插件，手册可查看：https://www.zentao.net/book/zentaopms/1814.html。

二、安装AI插件

在您的禅道中的后台->插件管理->本地安装 选择您下载的AI插件 按照流程进行安装。

选择覆盖，然后刷新页面。

安装成功后，可在已安装下可以查看到。

AI插件和ZAI服务都配置成功后，可以在禅道页面的右下角查看到AI入口。

如果配置后没有显示，那么可以强制刷新一下浏览器。

需要注意的是，该插件会更新前端依赖的 JS 文件。由于属于非常规版本升级，可能需要清理浏览器缓存后才能生效。

三、配置 ZAI 服务

ZAI 是一款面向企业的智能服务平台，基于 雷驼智能引擎 实现。禅道 AI 插件依赖 ZAI 服务提供 AI 基础能力。ZAI 服务安装参考：ZAI 服务安装使用手册。

当 ZAI 服务安装部署完成后，请参考 ZAI 安装使用文档，创建一个禅道应用集成，并获取如下信息：

• ZAI 服务器地址：禅道会使用此地址来调用 ZAI API，实现各种 AI 功能，地址可以为服务器主机 IP 或域名，例如 localhost；
• ZAI 服务器端口：禅道会使用此端口来调用 ZAI API，如果不知道端口，可以留空，默认使用端口 8000；
• 应用集成 ID：禅道作为应用接入 ZAI 平台时分配的 ID，例如 zentao；
• 应用密钥：禅道在调用 ZAI API 时会安全地使用此密钥，请妥善保管，例如 qAs0y85cebIOWBPsBDaHmwkv8WNfgDSw。
• 管理密钥：禅道在调用 ZAI 管理 API 时会安全地使用此密钥，请妥善保管，例如 z1Jh0GrchSCE5CBCRvJhsx1JPZKj2kPR。

当准备好上述信息后，就可以打开禅道“后台 → AI 配置 → ZAI”页面，点击编辑按钮，将上述配置填写在表单中，然后进行保存即可。

需要注意的是：

• 确保 ZAI 服务器支持使用禅道相同的协议访问，例如禅道使用 https 访问，则 ZAI 服务器也需要通过反向代理配置相关证书来支持通过 https 访问。
• 为了避免浏览器内容安全策略（CSP）阻止访问 ZAI 服务器，需要配置禅道 CSP 规则，方法为修改 config/my.php 文件，添加如下配置：

$config->CSPs = array("form-action 'self';connect-src 'self' http://localhost:8000"); 

四、禅道数据向量化

数据向量化会将禅道系统内产生的数据（例如需求、BUG、文档等）进行向量化，便于在 AI 对话中引用，让 AI 更准确地回答问题。

要启用禅道数据向量化，点击 ZAI 界面左侧菜单中的“数据向量化”，首次需要手动启用，点击“启用数据向量化”按钮即可。禅道数据向量化需要预先在 ZAI 配置中配置管理密钥，请参考上文“配置 ZAI 服务”。

启用后，数据向量化需要进行一次同步，点击“开始同步”按钮，进入数据同步状态，界面上会显示各类型对象同步进度。

完成同步后即可在对话中通过上下文引用禅道数据。详情参考禅道 AI 使用文档“对话上下文”。