AI插件功能使用 分享链接/book/zentaopms/1775.html?releaseID=21

安装好插件并配置好 ZAI 服务后，登录禅道即可使用 AI 插件提供的功能。下面分别介绍：

全局 AI 按钮

在禅道界面右下角会显示一个全局 AI 功能按钮。该按钮作为通用 AI 对话入口，点击后会弹出 AI 对话面板，可输入文本与大模型对话。同时，按钮上方会智能提示当前可用的 AI 功能，点击即可使用。

AI 对话

点击全局 AI 按钮，会打开通用 AI 对话面板。在该面板可查看所有历史对话并创建新对话；选中对话后，可在右侧查看消息，并与大模型进行对话。

对话列表

通用 AI 对话面板分为左右两栏展示，左侧为对话列表，右侧为对话详情。 左侧对话列表按创建时间排序，最新对话排在最前。对话会按时间段分组展示，可按需折叠或展开。

点击对话列表中的对话名称，即可在右侧查看对话消息，并与大模型对话。

搜索对话

在对话列表上方的搜索框输入关键字，可按对话标题进行搜索。

创建新对话

点击对话列表上方的“新建对话”按钮，会创建并选中新对话；随后可在右侧对话详情面板中与大模型对话。

选择大模型

创建对话后，可点击消息输入框下方的模型选择按钮，选择要使用的大模型，然后发送消息。

需要注意：目前暂不支持在同一对话中切换模型。

删除对话

点击对话列表项右侧的“更多”按钮，在菜单中选择“删除”，即可将该对话从历史列表中移除。

对话上下文

在进行 AI 对话时，支持将外部数据快捷地添加到对话中。这些数据可能来自当前界面，也可能来自向量化数据，例如当前页面内容、禅道文档等。

添加上下文

要使用对话上下文，在创建对话时点击消息输入框上方的“@”按钮，弹出上下文选择面板后，选择要添加的上下文类型即可。

也可直接在对话中通过 @上下文名称 引入上下文，无须手动打开选择面板。例如，询问 AI 当前页面内容时输入 @当前页面；引用特定需求时使用 @需求#ID。

部分上下文类型需要在特定页面才能使用。例如，@当前文档 需要先打开具体的禅道文档页面。

支持的上下文类型

下面列举禅道 AI 插件支持的上下文类型：

• @当前页面：当前禅道页面的文本内容；
• @选中内容：页面上当前选中的内容；
• @剪切板：剪切板中的内容（目前仅支持文本）；
• @当前文档：访问具体文档时，可将该文档内容作为上下文；
• @禅道：向量化中的所有对象类型数据，包括需求、BUG、文档等；
• @禅道对象类型：向量化中某一对象类型的数据，例如使用 @BUG 引入所有 BUG 数据；
• @禅道对象#XXX：向量化中某一具体对象的数据，例如 @需求#123 引入 ID 为 123 的需求。

上下文功能限制

目前上下文功能存在如下限制：

• 基于禅道数据向量化的上下文，以最后一次同步时的数据为准，不会实时根据禅道当前数据更新；
• 禅道数据向量化暂不支持权限控制，普通用户可能会在对话中访问到在禅道中无权限访问的文档、需求等数据，对于数据权限敏感的组织，不建议使用数据向量化功能；
• 上下文实际内容在创建对话（第一次发送消息）时加载，在同一个对话的后续消息中，不会再更新上下文内容，之前添加的上下文不能移除，并且也无法再添加新的上下文；
• 上下文会增加 Token 的使用。

我们将在后续版本中逐步解决这些问题，带来更好的上下文使用体验。

AI 需求评审

禅道 AI 插件提供“AI 需求评审”功能，支持对禅道中的需求进行自动评审。 目前该功能仅在需求详情页面可用。进入具体需求后，在需求描述右上方会显示“AI 评审”按钮，点击即可使用。

AI 评审结果将以临时面板的形式展示在页面右上方。

进入需求详情页面后，全局 AI 按钮上方也会智能提示“需求评审”快捷按钮，点击同样可使用。

目前，AI 需求评审会给出结果总结、核心优先改进项和次要优化建议。修改需求后，可再次调用以获取新的评审建议。我们将在后续版本中进一步增强该功能，提供更强的交互式评审能力。

选中内容操作

翻译

禅道 AI 插件提供“翻译”功能。在页面选中需要翻译的内容后，全局 AI 按钮上方会显示“翻译”快捷按钮；点击后，会在页面右上方弹出面板展示翻译结果。

总结

禅道 AI 插件提供“总结”功能。操作方式与“翻译”相同：选中需要总结的内容后，点击全局 AI 按钮上方的“总结”快捷按钮，即可在页面右上方弹出面板查看总结结果。