插件管理与使用指南 ​

前言 ​

插件（Plugin）是为你的智能助手（Agent）注入超能力的“增强模块”。为了让你能轻松地发现、创建并管理这些强大的插件，平台提供了两大核心功能区：“插件广场” 和 “插件管理”。

• 插件广场：是你发现、添加和创建新插件的“应用商店”。
• 插件管理：是你个人的“工具箱”，用于配置、维护和启用你已经选择的涉及外部资源的插件。

本指南将引导你掌握如何有效利用这两个模块，为你的智能助手装备最合适的能力。

第一部分：插件广场 ​

插件广场是所有可用插件的展示中心，你可以在这里浏览平台提供的所有插件，并根据需要创建自己的专属插件。

1.1 浏览与探索插件 ​

在插件广场，你可以看到平台已接入的所有插件卡片。

• 插件类型区分：
  • 平台服务插件：这类插件由平台官方提供，通常无需复杂配置，可以直接添加使用。
  • 外部授权插件：这类插件需要连接到第三方服务。你需要根据“参数配置”的指引，填写所需要的对应参数等认证信息，才能成功启用。

• 查看详情：点击任意一个你感兴趣的插件，右侧会展开其详情视图。这里包含了：
  • 功能描述：详细说明该插件的功能、用途和适用场景。
  • 参数配置：列出启用此插件前需要填写的必要参数。

1.2 创建自定义插件 ​

如果现有插件无法满足你的特定需求，你可以创建自定义插件。在插件广场页面，点击 “自定义插件” 或类似的创建按钮。

在弹出的配置窗口中，你需要填写以下信息来定义你的插件：

• 图标和名称: 为你的插件设置一个易于识别的图标和唯一的名称。
• 鉴权方式 : 根据你API的验证要求选择。
  • 无需鉴权 : 如果你的API是公开的，选择此项即可，无需填写额外信息。
  • API Key: 如果你的API需要密钥验证，请选择此项，并填写以下两个字段：
    • 密钥参数名: API Key的名称。
    • 密钥值: 你的有效API Key。
• Schema 定义: 这是插件的核心部分，用于向大模型描述API的功能和如何调用。你需要在此处详细定义API的接口信息，包括地址、请求方法、参数和返回值等。
  • 平台会提供相应的参考例子（ JSON 或 YAML 格式）来帮助你完成填写。
• 调试与测试: 在完成上述配置后，你可以使用界面下方提供的调试工具来验证插件是否能正常工作。
  • 在 “操作” 部分，你可以针对定义的具体功能进行测试。
  • 输入所需的 参数和对应的 **值 **。
  • 点击 “测试” 按钮发起调用。
  • “测试结果” 区域将会显示API调用的返回信息，帮助你判断配置是否正确。

只有在调试测试成功后，你才能保存并创建该插件。

第二部分：插件管理 ​

“插件管理”是你个人的工作空间，所有你从广场添加或亲手创建外部的插件都会在这里集中展示和维护。

2.1 统一管理你的插件 ​

在此界面，你可以清晰地看到你个人工具箱中的所有插件列表。

• 状态概览：列表会直观地展示每个涉及外部资源使用的插件连接状态（例如：“已连接”或“未连接”），让你对这些插件的可用性一目了然。
• 资源管理：由于外部插件可能会连接到消耗资源的外部服务，我们建议你定期检查此列表，对于不再使用的插件及时进行管理（如编辑或删除），以避免不必要的资源消耗。

2.2 编辑与删除 ​

你可以对列表中的任何插件进行维护操作。

1. 点击你想要管理的插件。
2. 系统将跳转到该插件的详情与配置页面。
3. 在此页面，你可以：
   • 编辑：修改该插件的各项配置参数。修改后同样建议进行连接测试。
   • 删除：将该插件从你的个人工具箱中永久移除。

2.3 将插件添加到你的应用 ​

仅仅将插件添加到个人工具箱还不够，你需要将其“装配”到具体的智能助手上，才能使其生效。

1. 在“插件管理”界面，点进一个已成功连接的插件详情页。
2. 找到并点击 “添加到我的应用” 按钮。
3. 系统会弹出一个窗口，列出你已创建的所有Agent或工作流。
4. 勾选 你希望使用此插件的应用。
5. 点击确认后，该插件的能力便成功赋予了你所选择的智能助手。

总结 ​

通过插件广场和插件管理等相关功能，你可以更好的选择合适的插件工具集成到你的助手当中，也可以对涉及外部资源的工具进行管理，避免不必要的资源消耗。