⚠️ 本文档由 AI 自动翻译。如有任何不准确之处,请参考英文原版。
路径规范
在 Manifest 或任何 yaml 文件中填写文件路径时,根据文件类型遵循以下两种规范:- 如果目标文件是多媒体文件(如图片或视频),例如填写插件的
icon时,应将这些文件放在插件根目录下的_assets文件夹中。 - 如果目标文件是普通文本文件,如
.py或.yaml代码文件,应填写该文件在插件项目中的绝对路径。
通用结构
在定义插件时,有一些数据结构可以在工具、模型和 Endpoints 之间共享。这些共享结构在此处定义。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
工具提供者名称
工具名称
工具描述
工具配置信息
相关资源
- 插件开发基本概念 - 全面了解 Dify 插件开发
- 开发者速查表 - 插件开发中常用命令和概念的快速参考
- 工具插件开发详解 - 了解如何定义插件信息和工具插件开发流程
- 模型设计规则 - 了解模型配置的标准
Edit this page | Report an issue