插件

前提条件

• 已完成工作流搭建，如果未搭建工作流，请参考搭建工作流。
• 如果需要添加共享插件，请确保已有他人共享的插件。
• 仅Versatile企业版支持使用他人共享的应用。Versatile基础版（限时免费）不支持该能力。

节点说明

作为功能扩展的重要载体，该节点允许通过调用插件来执行特定功能任务。每个插件实质上是经过标准化封装的API工具集合，提供即插即用的模块化服务，拓宽工作流的能力边界，完成更复杂的任务。

插件类型包括预置插件和个人插件。

• 预置插件：平台预置了代码解释器插件，能够执行输入的代码，得到运行结果。支持开发者直接将插件添加到工作流或应用中，丰富其能力。
• 个人插件：平台允许开发者创建自定义插件，支持将API通过配置方式快速创建为插件，提供给工作流或应用调用。
• 团队共享：平台支持不同空间之间的插件共享，用户可以查看本空间共享给其他团队的资源，也能查看其他空间共享给本空间的资源，详细操作请参见使用资产中心的插件资源。
• 如果“我的插件”和“插件广场”不满足用户需求，可以单击左上角“创建插件”，详细参数配置请参见基于API创建一个插件，插件创建成功后在“插件创建成功”界面单击“确定”即可直接添加插件。

配置插件节点

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 在左侧导航栏选择“开发中心 > 应用管理 > 工作流应用”，单击您创建的工作流。
3. 单击“添加节点”并选择“插件”节点。
4. 在“添加插件工具”窗口，选择“我的插件”或“插件广场”，单击目标插件右侧的展开工具列表，在展开的列表中单击目标工具右侧的“添加”将插件工具添加至画布中。
   平台提供的插件分为免费和付费两种:

   • 免费插件：免费插件无需购买，无需鉴权的插件可以直接使用，未鉴权的插件设置鉴权后即可使用。设置鉴权请参考使用平台精选的插件。
   • 付费插件：付费插件需要先购买并设置鉴权后才能使用，单击“获取鉴权信息”可跳转至购买和获取API Key的页面。

5. 单击画布中已添加的“插件”节点，参照表1，完成插件节点的配置。
   

   • 单击图标，可修改插件节点名称，修改完成后单击名称旁边的进行保存。
   • 单击图标，可查看插件详情，重命名插件节点名称，复制一个插件节点或删除插件节点，同时支持查看插件详情。
   • 单击图标，可对插件节点进行测试。

   表1 插件节点配置说明

   配置类型	参数名称	参数说明	配置示例
   参数配置	输入参数	参数名称：从插件元信息中导入，用户无需手动添加。 类型、值：支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点的输出变量值和全局配置中的记忆变量，适用于需要从前置节点输出中获取插件入参的场景。 输入：支持用户自定义取值，适用于插件入参取值固定的场景。 说明： 如果插件中设置了默认参数值，这些值将自动填充到输入框中，并且用户可以对其进行修改。	插件的输入参数需要从前置节点中获取时，配置“引用”。 插件的输入参数固定时，如翻译插件要将内容翻译成英文，插件入参to表示翻译后内容的语种，此时应该配置“输入”并赋值“en”。
   	输出参数	输出参数所有信息从插件元信息中自动导入，用户无需手动修改。	-
   	异常处理	支持对节点的异常（如超时、调用失败等情况）进行处理，包括超时时间、重试次数、异常处理方式。 “超时时间”：支持用户配置超时时间，取值范围0.1~900，默认900s。 “重试次数”：支持配置重试次数（不重试、重试1次、重试2次、重试3次），系统默认不重试。 “异常处理方式”：配置异常处理方式。 中断流程：节点发生异常后，直接中断流程，不再运行后续节点。 返回设定内容：节点发生异常后，工作运行不会中断，用户可自定义设置需要返回的输出字段内容，必须是输出参数中已定义的字段，且格式为合法的JSON格式。 执行异常流程：节点发生异常后，工作流不会中断，而是会执行异常处理流程。用户可以在该运行异常的节点前新增节点，并为新增的异常分支配置相应的处理流程。	“超时时间”：900。 “重试次数”：不重试。 “异常处理方式”：中断流程。

   图1 插件节点配置示例
   

6. 连接插件节点和其他节点。
7. 节点配置完成后，单击“确定”。