Dify Plugin SDK Schema Documentation

Table of Contents

• Manifest
• PluginType
• Plugins
• Meta
  • PluginArch
  • PluginRunner
  • PluginLanguage
• PluginResourceRequirements
  • Permission
  • Endpoint
  • Node
  • Storage
  • Model
  • App
  • Tool
• ToolProvider
• Tool
  • ToolIdentity
  • ToolExtra
  • ToolDescription
  • ToolParameter
• ToolProviderExtra
• ToolProviderIdentity
• OAuthSchema
• EndpointGroup
• Endpoint
  • EndpointExtra
• ModelFeature
• DefaultParameterName
• ModelFormShowOnObject
• ParameterTemplate
• ParameterAutoGenerate
• ToolParameterOption
• ModelPropertyKey
• ProviderModel
• ModelConfigScope
• AgentStrategyProviderExtra
• Python
• FetchFrom
• I18nObject
• AppSelectorScope
• ToolLabelEnum
• ModelProvider
• AIModelEntity
  • PriceConfig
  • ParameterRule
  • ParameterType
• ModelProviderCredentialSchema
  • ModelCredentialFormSchema
  • ModelFormType
  • ModelFormOption
• ModelProviderExtra
• ModelConfigurateMethod
• ModelProviderHelp
• ModelPosition
• ParameterOption
• ModelType
• ToolSelectorScope
• PluginProviderType
• AgentStrategyProvider
• AgentStrategyProviderIdentity
• AgentStrategy
  • AgentStrategyParameter
  • AgentStrategyIdentity
  • AgentStrategyExtra
  • Python
  • AgentStrategyFeature
• CommonParameterType
• ProviderConfig
• ConfigOption
• ModelFieldModelSchema

Manifest

The Manifest of the plugin

Fields

Name	Type	Description	Default	Extra
version	str			pattern='^\d{1,4}(\.\d{1,4}){1,3}(-\w{1,16})?$'
type	PluginType
author	str	None
name	str			pattern='^[a-z0-9_-]{1,128}$'
repo	str	None	The repository URL of the plugin	None
description	I18nObject
icon	str
icon_dark	str	None	The dark mode icon of the plugin	None
created_at	datetime
resource	PluginResourceRequirements
plugins	Plugins
meta	Meta

ToolProvider

The Manifest of the tool provider

Fields

Name	Type	Description	Default	Extra
identity	ToolProviderIdentity
credentials_schema	list[ProviderConfig]	The credentials schema of the tool provider
oauth_schema	dify_plugin.entities.oauth.OAuthSchema	None	The OAuth schema of the tool provider if OAuth is supported	None
tools	list[str]	The tools of the tool provider	[]
extra	ToolProviderExtra

PriceConfig

The price config

Fields

Name	Type	Description	Default	Extra
input	Decimal	Input price
output	decimal.Decimal	None	Output price	None
unit	Decimal	Unit, e.g. 0.0001 -> per 10000 tokens
currency	str	Currency, e.g. USD

ParameterType

Values

• FLOAT: float
• INT: int
• STRING: string
• BOOLEAN: boolean
• TEXT: text

EndpointGroup

The Manifest of the endpoint group

Fields

Name	Type	Description	Default	Extra
settings	list[ProviderConfig]
endpoints	list[str]	Paths to yaml files that will be loaded as Endpoint

ModelFeature

Values

• TOOL_CALL: tool-call
• MULTI_TOOL_CALL: multi-tool-call
• AGENT_THOUGHT: agent-thought
• VISION: vision
• STREAM_TOOL_CALL: stream-tool-call
• DOCUMENT: document
• VIDEO: video
• AUDIO: audio
• STRUCTURED_OUTPUT: structured-output

Plugins

Extensions of plugin

Fields

Name	Type	Description	Default	Extra
tools	list[str]	manifest paths of tool providers in yaml format, refers to ToolProvider
models	list[str]	manifest paths of model providers in yaml format, refers to ModelProvider
endpoints	list[str]	manifest paths of endpoint groups in yaml format, refers to EndpointGroup
agent_strategies	list[str]	manifest paths of agent strategy providers in yaml format,refers to AgentStrategyProvider

DefaultParameterName

Values

• TEMPERATURE: temperature
• TOP_P: top_p
• TOP_K: top_k
• PRESENCE_PENALTY: presence_penalty
• FREQUENCY_PENALTY: frequency_penalty
• MAX_TOKENS: max_tokens
• RESPONSE_FORMAT: response_format
• JSON_SCHEMA: json_schema

PluginArch

Values

• AMD64: amd64
• ARM64: arm64

ModelFormShowOnObject

Form show on

Fields

Name	Type	Description	Default	Extra
variable	str
value	str

ToolDescription

The description of the tool

Fields

Name	Type	Description	Default	Extra
llm	str	The description presented to the LLM

Python

The extra of the agent strategy

Fields

Name	Type	Description	Default	Extra
source	str

ModelFormType

Values

• TEXT_INPUT: text-input
• SECRET_INPUT: secret-input
• SELECT: select
• RADIO: radio
• SWITCH: switch

ParameterTemplate

The template of the parameter

Fields

Name	Type	Description	Default	Extra
enabled	bool	Whether the parameter is jinja enabled

ParameterAutoGenerate

The auto generate of the parameter

Fields

Name	Type	Description	Default	Extra
type	Type

ToolParameterOption

The option of the tool parameter

Fields

Name	Type	Description	Default	Extra
value	str	The value of the option
icon	str	None	The icon of the option, can be a URL or a base64 encoded string	None

AgentStrategyProviderIdentity

The identity of the agent strategy provider

Fields

Name	Type	Description	Default	Extra
author	str	The author of the tool
name	str	The name of the tool
icon	str	The icon of the tool
icon_dark	str	None	The dark mode icon of the tool	None
tags	list[ToolLabelEnum]	The tags of the tool	[]

PluginLanguage

Values

• PYTHON: python

AgentStrategyParameter

The parameter of the agent strategy

Fields

Name	Type	Description	Default	Extra
name	str	The name of the parameter
help	dify_plugin.entities.I18nObject	None		None
type	ToolParameterType	The type of the parameter
auto_generate	dify_plugin.entities.tool.ParameterAutoGenerate	None	The auto generate of the parameter	None
template	dify_plugin.entities.tool.ParameterTemplate	None	The template of the parameter	None
scope	str	None		None
required	bool	None		False
default	Union[int, float, str, NoneType]		None
min	Union[float, int, NoneType]		None
max	Union[float, int, NoneType]		None
precision	int	None		None
options	list[dify_plugin.entities.tool.ToolParameterOption]	None		None

Endpoint

Permission of endpoint

Fields

Name	Type	Description	Default	Extra
enabled	bool	None	Whether to enable registration of endpoint	False

ModelProviderExtra

Model provider configuration extra

Fields

Name	Type	Description	Default	Extra
python	Python

ModelPropertyKey

Values

• MODE: mode
• CONTEXT_SIZE: context_size
• MAX_CHUNKS: max_chunks
• FILE_UPLOAD_LIMIT: file_upload_limit
• SUPPORTED_FILE_EXTENSIONS: supported_file_extensions
• MAX_CHARACTERS_PER_CHUNK: max_characters_per_chunk
• DEFAULT_VOICE: default_voice
• VOICES: voices
• WORD_LIMIT: word_limit
• AUDIO_TYPE: audio_type
• MAX_WORKERS: max_workers

ProviderModel

The provider model

Fields

Name	Type	Description	Default	Extra
model	str	The model name
model_type	ModelType	The model type
features	list[dify_plugin.entities.model.ModelFeature]	None	The features of the model	None
fetch_from	FetchFrom	The fetch from	FetchFrom.PREDEFINED_MODEL
model_properties	dict[ModelPropertyKey, Any]	The model properties
deprecated	bool	Whether the model is deprecated	False

ModelConfigurateMethod

Values

• PREDEFINED_MODEL: predefined-model
• CUSTOMIZABLE_MODEL: customizable-model

AgentStrategy

The Manifest of the agent strategy

Fields

Name	Type	Description	Default	Extra
identity	AgentStrategyIdentity
parameters	list[AgentStrategyParameter]	The parameters of the agent	[]
extra	AgentStrategyExtra
has_runtime_parameters	bool	Whether the tool has runtime parameters	False
output_schema	collections.abc.Mapping[str, typing.Any]	None		None
features	list[AgentStrategyFeature]	The features of the agent	[]

Permission

Permission of plugin

Fields

Name	Type	Description	Default	Extra
tool	dify_plugin.core.entities.plugin.setup.PluginResourceRequirements.Permission.Tool	None	Permission of tool	None
model	dify_plugin.core.entities.plugin.setup.PluginResourceRequirements.Permission.Model	None	Permission of model	None
node	dify_plugin.core.entities.plugin.setup.PluginResourceRequirements.Permission.Node	None	Permission of node	None
endpoint	dify_plugin.core.entities.plugin.setup.PluginResourceRequirements.Permission.Endpoint	None	Permission of endpoint	None
app	dify_plugin.core.entities.plugin.setup.PluginResourceRequirements.Permission.App	None	Permission of app	None
storage	dify_plugin.core.entities.plugin.setup.PluginResourceRequirements.Permission.Storage	None	Permission of storage	None

ModelConfigScope

Values

• LLM: llm
• TEXT_EMBEDDING: text-embedding
• RERANK: rerank
• TTS: tts
• SPEECH2TEXT: speech2text
• MODERATION: moderation
• VISION: vision

ModelProviderHelp

Model provider help

Fields

Name	Type	Description	Default	Extra

ToolProviderExtra

The extra of the tool provider

Fields

Name	Type	Description	Default	Extra
python	Python

AgentStrategyProviderExtra

The extra of the agent provider

Fields

Name	Type	Description	Default	Extra
python	Python

ToolExtra

The extra of the tool

Fields

Name	Type	Description	Default	Extra
python	Python

EndpointExtra

The extra of the endpoint

Fields

Name	Type	Description	Default	Extra
python	Python

PluginRunner

Runner of plugin

Fields

Name	Type	Description	Default	Extra
language	PluginLanguage
version	str
entrypoint	str

FetchFrom

Values

• PREDEFINED_MODEL: predefined-model
• CUSTOMIZABLE_MODEL: customizable-model

ModelCredentialFormSchema

Credential form schema

Fields

Name	Type	Description	Default	Extra
variable	str
type	ModelFormType
required	bool		True
default	str	None		None
options	list[dify_plugin.entities.model.provider.FormOption]	None		None
placeholder	dify_plugin.entities.I18nObject	None		None
max_length	int		0
show_on	list[ModelFormShowOnObject]

I18nObject

Common i18n object

Fields

Name	Type	Description	Default	Extra
zh_Hans	str	None		None
pt_BR	str	None		None
en_US	str

AppSelectorScope

Values

• ALL: all
• CHAT: chat
• WORKFLOW: workflow
• COMPLETION: completion

AgentStrategyFeature

Values

• HISTORY_MESSAGES: history-messages

PluginResourceRequirements

Resource requirements of plugin

Fields

Name	Type	Description	Default	Extra
memory	int
permission	dify_plugin.core.entities.plugin.setup.PluginResourceRequirements.Permission	None	Permission of plugin	None

ToolLabelEnum

Values

• SEARCH: search
• IMAGE: image
• VIDEOS: videos
• WEATHER: weather
• FINANCE: finance
• DESIGN: design
• TRAVEL: travel
• SOCIAL: social
• NEWS: news
• MEDICAL: medical
• PRODUCTIVITY: productivity
• EDUCATION: education
• BUSINESS: business
• ENTERTAINMENT: entertainment
• UTILITIES: utilities
• OTHER: other

AIModelEntity

AI model entity

Fields

Name	Type	Description	Default	Extra
model	str	The model name
model_type	ModelType	The model type
features	list[dify_plugin.entities.model.ModelFeature]	None	The features of the model	None
fetch_from	FetchFrom	The fetch from	FetchFrom.PREDEFINED_MODEL
model_properties	dict[ModelPropertyKey, Any]	The model properties
deprecated	bool	Whether the model is deprecated	False
parameter_rules	list[ParameterRule]		[]
pricing	dify_plugin.entities.model.PriceConfig	None		None

ModelProviderCredentialSchema

Model provider credential schema

Fields

Name	Type	Description	Default	Extra
credential_form_schemas	list[ModelCredentialFormSchema]

ModelProvider

Model provider configuration

Fields

Name	Type	Description	Default	Extra
provider	str
description	dify_plugin.entities.I18nObject	None		None
icon_small	dify_plugin.entities.I18nObject	None		None
icon_large	dify_plugin.entities.I18nObject	None		None
background	str	None		None
help	dify_plugin.entities.model.provider.ProviderHelpEntity	None		None
supported_model_types	collections.abc.Sequence[dify_plugin.entities.model.ModelType]
configurate_methods	list[ModelConfigurateMethod]
models	list[str]	Paths to yaml files that will be loaded as AIModelEntity
provider_credential_schema	dify_plugin.entities.model.provider.ProviderCredentialSchema	None		None
model_credential_schema	dify_plugin.entities.model.provider.ModelCredentialSchema	None		None
position	dify_plugin.entities.model.provider.ModelPosition	None		None
extra	ModelProviderExtra

PluginType

Values

• Plugin: plugin

ParameterOption

The option of the parameter

Fields

Name	Type	Description	Default	Extra
value	str	The value of the option
icon	str	None	The icon of the option, can be a URL or a base64 encoded string	None

Node

Permission of node

Fields

Name	Type	Description	Default	Extra
enabled	bool	None	Whether to enable invocation of node	False

Endpoint

The Manifest of the endpoint

Fields

Name	Type	Description	Default	Extra
path	str
method	str
hidden	bool	Whether to hide this endpoint in the UI	False
extra	EndpointExtra

ModelType

Values

• LLM: llm
• TEXT_EMBEDDING: text-embedding
• RERANK: rerank
• SPEECH2TEXT: speech2text
• MODERATION: moderation
• TTS: tts
• TEXT2IMG: text2img

Python

The extra of the agent provider

Fields

Name	Type	Description	Default	Extra
source	str

ToolSelectorScope

Values

• ALL: all
• PLUGIN: plugin
• API: api
• WORKFLOW: workflow

PluginProviderType

Values

• Tool: tool
• Model: model
• Endpoint: endpoint

Model

Permission of model

Fields

Name	Type	Description	Default	Extra
enabled	bool	None	Whether to enable invocation of model	False
llm	bool	None	Whether to enable invocation of llm	False
text_embedding	bool	None	Whether to enable invocation of text embedding	False
rerank	bool	None	Whether to enable invocation of rerank	False
tts	bool	None	Whether to enable invocation of tts	False
speech2text	bool	None	Whether to enable invocation of speech2text	False
moderation	bool	None	Whether to enable invocation of moderation	False

Meta

Meta information of plugin

Fields

Name	Type	Description	Default	Extra
version	str	The version of the manifest specification, designed for backward compatibility,when installing an older plugin to a newer Dify, it's hard to ensure breaking changes never happen, but at least, Dify can detect it by this field, it knows which version of the manifest is supported.
arch	list[PluginArch]
runner	PluginRunner
minimum_dify_version	str	None	The minimum version of Dify, designed for forward compatibility.When installing a newer plugin to an older Dify, many new features may not be available,but showing the minimum Dify version helps users understand how to upgrade.	None

ParameterRule

The parameter rule of the model

Fields

Name	Type	Description	Default	Extra
name	str	The name of the parameter
use_template	str	None	The template of the parameter	None
type	ParameterType	The type of the parameter
help	dify_plugin.entities.I18nObject	None	The help of the parameter	None
required	bool	Whether the parameter is required	False
default	typing.Any	None	The default value of the parameter	None
min	float	None	The minimum value of the parameter	None
max	float	None	The maximum value of the parameter	None
precision	int	None	The precision of the parameter	None
options	list[str]	The options of the parameter	[]

App

Permission of app

Fields

Name	Type	Description	Default	Extra
enabled	bool	None	Whether to enable invocation of app	False

OAuthSchema

The schema of the OAuth

Fields

Name	Type	Description	Default	Extra
client_schema	collections.abc.Sequence[dify_plugin.entities.provider_config.ProviderConfig]	The schema of the OAuth client
credentials_schema	collections.abc.Sequence[dify_plugin.entities.provider_config.ProviderConfig]	The schema of the OAuth credentials

AgentStrategyIdentity

The identity of the agent strategy

Fields

Name	Type	Description	Default	Extra
author	str	The author of the tool
name	str	The name of the tool

Tool

Permission of tool

Fields

Name	Type	Description	Default	Extra
enabled	bool	None		False

ModelFormOption

Form option

Fields

Name	Type	Description	Default	Extra
value	str
show_on	list[ModelFormShowOnObject]

Storage

Permission of storage

Fields

Name	Type	Description	Default	Extra
enabled	bool	None	Whether to enable uses of storage	False
size	int	Size of storage	1048576	Ge(ge=1024) Le(le=1073741824)

Tool

The manifest of the tool

Fields

Name	Type	Description	Default	Extra
identity	ToolIdentity
parameters	list[ToolParameter]	The parameters of the tool	[]
description	ToolDescription
extra	ToolExtra
has_runtime_parameters	bool	Whether the tool has runtime parameters	False
output_schema	collections.abc.Mapping[str, typing.Any]	None		None

AgentStrategyProvider

The Manifest of the agent strategy provider

Fields

Name	Type	Description	Default	Extra
identity	AgentStrategyProviderIdentity
strategies	list[str]	The strategies of the agent provider	[]

AgentStrategyExtra

The extra of the agent strategy

Fields

Name	Type	Description	Default	Extra
python	Python

ToolIdentity

The identity of the tool

Fields

Name	Type	Description	Default	Extra
author	str	The author of the tool
name	str	The name of the tool

ToolProviderIdentity

The identity of the tool provider

Fields

Name	Type	Description	Default	Extra
author	str	The author of the tool
name	str	The name of the tool
icon	str	The icon of the tool
icon_dark	str	None	The dark mode icon of the tool	None
tags	list[ToolLabelEnum]	The tags of the tool	[]

CommonParameterType

Values

• SECRET_INPUT: secret-input
• TEXT_INPUT: text-input
• SELECT: select
• STRING: string
• NUMBER: number
• FILE: file
• FILES: files
• BOOLEAN: boolean
• APP_SELECTOR: app-selector
• MODEL_SELECTOR: model-selector
• TOOLS_SELECTOR: array[tools]
• ANY: any
• OBJECT: object
• ARRAY: array
• DYNAMIC_SELECT: dynamic-select

ProviderConfig

A common config schema

Fields

Name	Type	Description	Default	Extra
name	str	The name of the credentials
type	Config	The type of the credentials
scope	str	None		None
required	bool		False
default	Union[int, float, str, bool, NoneType]		None
options	list[dify_plugin.entities.provider_config.ConfigOption]	None		None
help	dify_plugin.entities.I18nObject	None		None
url	str	None		None
placeholder	dify_plugin.entities.I18nObject	None		None

ModelFieldModelSchema

Field model schema

Fields

Name	Type	Description	Default	Extra
placeholder	dify_plugin.entities.I18nObject	None		None

ConfigOption

The option of the credentials

Fields

Name	Type	Description	Default	Extra
value	str	The value of the option

ModelPosition

Model position

Fields

Name	Type	Description	Default	Extra
llm	list[str]	None	Sorts of llm model in ascending order, fill model name here
text_embedding	list[str]	None	Sorts of text embedding model in ascending order, fill model name here
rerank	list[str]	None	Sorts of rerank model in ascending order, fill model name here
tts	list[str]	None	Sorts of tts model in ascending order, fill model name here
speech2text	list[str]	None	Sorts of speech2text model in ascending order, fill model name here
moderation	list[str]	None	Sorts of moderation model in ascending order, fill model name here

ToolParameter

The type of the parameter

Fields

Name	Type	Description	Default	Extra
name	str	The name of the parameter
type	ToolParameterType	The type of the parameter
auto_generate	dify_plugin.entities.tool.ParameterAutoGenerate	None	The auto generate of the parameter	None
template	dify_plugin.entities.tool.ParameterTemplate	None	The template of the parameter	None
scope	str	None		None
form	ToolParameterForm	The form of the parameter, schema/form/llm
llm_description	str	None		None
required	bool	None		False
default	Union[int, float, str, NoneType]		None
min	Union[float, int, NoneType]		None
max	Union[float, int, NoneType]		None
precision	int	None		None
options	list[dify_plugin.entities.tool.ToolParameterOption]	None		None
input_schema	collections.abc.Mapping[str, typing.Any]	None		None