插件工具 (Plugin Tools)

1. 功能介绍

插件工具（Plugin Tools）是集成在大型语言模型（LLM）中的外部服务或功能模块，旨在扩展模型的核心能力，使其能够执行特定领域的任务或访问实时信息。通过插件，LLM 不再局限于其预训练知识，而是能够动态地与外部系统交互，从而提供更精准、更实用的响应。

在 JeecgBoot AI 应用平台中，您可以轻松维护一套自定义的 API 插件工具，并将其无缝集成到 AI 应用和 AI 流程中。

当某些第三方平台或内部系统未提供 MCP（模型能力提供商）服务，但拥有丰富的 API 接口时，插件工具便能发挥关键作用。您可以将这些 API 封装成插件，使其在 JeecgBoot 的 AI 应用中得到统一调用和管理。

2. 插件工具的配置

由于插件工具与 MCP 在概念上有一定的相似性，在 JeecgBoot 平台中，它们的配置管理被整合在同一界面。

1. 新增插件

进入“Mcp 配置”界面，点击“新增 MCP”按钮，在弹出的窗口中选择“插件”类型。

您需要填写以下信息：

插件名称: 插件的显示名称，建议清晰易懂。
Base URL: 插件所有 API 的基础 URL 地址。
描述: 对插件功能的简要说明。
请求头: 调用该插件下所有 API 时需要统一携带的请求头信息。
授权方式: API 的授权认证方式，目前支持“无授权”和“Bearer Token”。

2. 新增工具

插件创建成功后，点击插件进入详情页面，然后点击“添加工具”按钮，以配置具体的 API 接口。

工具名称: 调用此工具时使用的唯一标识，建议使用英文、数字和下划线的组合。
请求方法: API 的 HTTP 请求方法，目前支持 GET 和 POST。
请求路径: API 的具体请求路径，将与插件的 Base URL 拼接成完整的请求地址。
描述: 对工具功能的详细说明，这将帮助 LLM 理解该工具的用途。
请求参数: 定义 API 需要携带的参数。
- 参数名称: 参数的字段名。
- 参数描述: 参数的详细说明，帮助 LLM 理解其含义和用途。
- 参数类型: 参数的数据类型，支持字符串、数字、整型、布尔值。
- 传入方式: 参数在请求中的传递位置，支持 raw (JSON body)、form-data、query、header、path。
- 是否必须: 标识该参数是否为必填项。
- 默认值: 参数的默认值（可选）。
响应参数 (非必须): 提供一个 API 成功响应的 JSON 示例。该示例将帮助 LLM 理解工具返回的数据结构，从而更好地进行后续处理。

工具配置完成后，您可以在工具列表中进行查看和编辑。

3. 在 AI 应用中使用插件工具

配置完成后，我们便可以在 AI 应用中调用插件工具提供的功能了。让我们创建一个新的AI应用来演示这个过程.此处选择"简单配置"模式.假设我们有一个会议管理的插件工具,他可以帮助用户安排和管理会议,我们来设计一个"OA管理助手"角色:

# 角色：OA管理助手
一个智能助手，旨在协助用户进行OA（办公自动化）相关操作，提高工作效率。

## 目标：
1. 协助用户完成日常OA操作，如文档管理、任务分配、会议安排等。
2. 提供实时信息和数据分析，支持决策制定。

## 技能：
1. 文档管理与分类能力。
2. 任务跟踪与提醒功能。
3. 日历集成与会议安排能力。

## 工作流：
1. 收集用户需求，了解具体的OA操作要求。
2. 利用工具进行文档创建、编辑或管理。
3. 监控任务进展，并定期向用户反馈状态。

## 输出格式：
提供清晰的步骤和操作指南，确保用户能轻松理解和执行。

## 限制：
- 不得处理包含个人隐私信息的数据。
- 所有建议需基于已知的最佳实践，避免不合规行为。
- 在无法确认信息来源时，需标注[需核实]。