插件

什么是插件

插件本质上就是一个 手工编码 的 代码节点。

在编写代码节点时，常常有需要重用已经编写好的代码节点的场景。插件的出现正是为了解决这个问题。你可以把一些常用的功能封装成插件，需要的时候直接调用插件即可。

创建插件

创建插件的方式有两种：

1. 从 代码节点 直接创建

   在智能体编辑页面中，右键点击代码节点，选择 创建插件，即可直接创建插件。

   注意：只有代码节点是 手工编码 类型时，才可以创建插件

2. 从 我的插件 中创建

   在 插件广场 / 我的插件 页面中，点击 创建插件，也可以创建插件。

插件的属性

插件的属性包括：

• 插件名称
• 插件描述
• 插件的编程语言

插件的源码与输入参数

你可以在 我的插件 中编写或者修改插件的源码。插件的源码与普通的手工编写的代码节点没有任何区别。你唯一需要考虑的是设计插件时逻辑应该更抽象和泛化，以便不同的智能体都可以调用。

插件的输入参数是指任何在源代码中用格式 {{参数名}} 引用的变量。在智能体调用该插件时，需要在插件的属性面板中提供对应参数的值。 你可以输入固定的值，或者用 {{变量名}} 引用智能体的中的其他变量。

如果没有配置插件的输入参数，智能体调用插件时，会首先尝试直接引用该参数名对应的变量。举个例子：如果某一个插件的输入参数名为 myName，如果在插件节点上没有配置具体的值，但是智能体的上下文有 myName 变量，那么智能体会直接引用 myName 变量的值。如果智能体的上下文没有 myName 变量，那么这个参数的值会被设为 N/A。

发布插件

当你编写好插件后，可以点击发布来发布插件到插件广场中，共自己或其他人使用。发布插件时，需要填写以下信息：

• 可见范围：
  • 租户可见：本租户的所有用户都可以使用
  • 用户可见：插件只能被自己使用
• 是否开源：如果开源，则其他用户可以查看插件的源代码。注意如果插件的代码里包含敏感信息，比如 API 密钥、数据库连接字符串等，建议不要开源。
• 图标：可以上传一个自定义的插件图标。
• 插件的标签：可以输入插件的标签，方便用户识别。
• 输入参数说明：可以输入插件的输入参数说明，方便用户理解调用插件时需要提供的参数。
  • 是否可选：如果输入参数是可选的，那么用户在调用插件时可以不提供该参数，此时参数对应的值为 N/A, 注意插件的代码逻辑里需要处理此种情况。
• 输出结果说明：输入该插件的输出结果说明，以便用户在后续节点处理该结果。

插件广场

发布后的插件都会出现在插件广场中。点击插件卡片，可以看到该插件的详细说明，并且可以直接手工调用该插件。如果插件是开源的，还可以查看该插件的源代码。