Install and Use Plugins
Last updated
Last updated
Click "Plugins" in the top right corner of the Dify platform to go to the plugin management page of your current Workspace. You can install plugins through these three methods:
Marketplace
GitHub
Local Upload
Marketplace
The Dify Marketplace contains officially maintained and community-contributed models and tools. Simply click the "Install" button on a plugin to easily install it into your current Workspace.
GitHub
You can install plugins directly through GitHub repository links. When installing through this method, ensure the plugin meets code standards. The plugin repository must create a Release and include the plugin package file as an attachment. For detailed requirements, please refer to Publishing Plugins: GitHub.
Local Upload
After packaging a plugin, you'll get a file with a .difypkg extension, commonly used in offline or testing environments, allowing installation of plugin files outside the official marketplace. Organizations can develop and maintain internal plugins and install them through local upload to avoid exposing sensitive information.
Some third-party service plugins may require API Keys or other forms of authorization. After installation, manual authorization is needed for normal use.
API Keys are sensitive information, and authorization is only valid for the current user. Other team members will need to manually enter their authorization keys when using the plugin.
After installing a plugin to your Workspace, you can use it within Dify applications. Below is a brief introduction to different usage methods for each type of plugin.
Taking OpenAI as an example, after installing a model type plugin, click on Profile Picture → Settings → Model Providers in the top right corner, and configure the API Key to activate the model provider. After authorization, you can select and use this large language model in all application types.
Authorization allows you to select and use this large language model within all application types.
Tool type plugins can be used in Chatflow, Workflow, and Agent application types. This section will demonstrate usage in these application types using the Google tool plugin as an example.
Some tool plugins require API Key authorization before use, so you can configure them after installation for subsequent use.
After creating an Agent application, find the "Tools" option at the bottom of the application orchestration page. Select the installed tool plugin.
When using the application, input tool usage instructions. For example, entering "today's news" will invoke the plugin to use Google search engine for online content retrieval.
Chatflow and Workflow type applications share the same workflow orchestration canvas, so the method for using tool type plugins is consistent.
You can click the + sign at the end of a node, select the installed Google plugin tool, and connect it to upstream nodes.
In the plugin's input variables, fill in the user's input query variable or other information that needs online retrieval.
Different tool plugins have different usage methods. Please refer to each plugin's introduction page for specific parameter configuration methods.
Extension type plugins are highly customizable applications with independent request endpoints, generally not requiring integration with Dify applications.
Different extension type plugins vary greatly in functionality; please refer to each plugin's instructions for detailed usage methods.
Bundles plugins are mainly used for batch installation of multiple plugins simultaneously. A bundle may contain model, tool, and extension type plugins. Specific usage methods should follow each plugin's instructions.
