本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。本页介绍所有插件类型共享的结构。建议结合 插件开发基本概念 和 开发者速查表 一起阅读,以了解整体架构。
路径规范
在 Manifest 或任何 YAML 文件中填写文件路径时,根据文件类型遵循以下两条规则:- 图片、视频等多媒体文件(例如插件的
icon),放在插件根目录下的_assets文件夹中。 - 普通文本文件,如
.py或.yaml代码文件,使用其在插件项目中的绝对路径引用。
通用结构
部分数据结构在工具、模型和 Endpoint 之间共享,在此统一定义。I18nObject
I18nObject 是符合 IETF BCP 47 标准的国际化结构,支持四种语言:
英语(美国)。
简体中文。
日语。
葡萄牙语(巴西)。
ProviderConfig
ProviderConfig 是供应商通用表单结构,Tool 和 Endpoint 都会使用。
表单项名称。
显示标签,遵循 IETF BCP 47 标准。
表单字段类型,决定该字段在 UI 中的渲染方式。
可选的范围限定,随
type 的取值而变化。该字段是否不能为空。
默认值。仅支持基本类型:
float、int、string。可用选项。仅在
type 为 select 时使用。帮助文档链接标签,遵循 IETF BCP 47。
帮助文档链接。
多语言占位符文本,遵循 IETF BCP 47。
ProviderConfigOption (object)
选项的值。
选项的显示标签,遵循 IETF BCP 47。
ProviderConfigType (string)
将被加密的配置信息。
纯文本输入字段。
下拉选择字段。
开关/切换控件。
模型配置选择器,包含供应商名称、模型名称和模型参数。
应用 ID 选择器。
工具配置选择器,包含工具供应商、名称和参数。
数据集选择器(待定)。
ProviderConfigScope (string)
当type 为 model-selector 时:
所有模型类型。
仅大语言模型。
仅文本嵌入模型。
仅重排序模型。
仅文字转语音模型。
仅语音转文字模型。
仅内容审核模型。
仅视觉模型。
type 为 app-selector 时:
所有应用类型。
仅聊天应用。
仅工作流应用。
仅补全应用。
type 为 tool-selector 时:
所有工具类型。
仅插件工具。
仅 API 工具。
仅工作流工具。
ModelConfig
包含
plugin_id 的模型供应商名称,格式为 langgenius/openai/openai。具体的模型名称。
NodeResponse
最终传入节点的变量。
节点的输出结果。
节点执行期间生成的数据。
ToolSelector
工具供应商名称。
工具名称。
工具描述。
工具配置信息。