Pluginurile Dify (Integrations) și Dify Marketplace în Dify: fluxuri agentice, Knowledge și self-hosting

Integrations → Marketplace | GitHub | Local Package File (.difypkg)
dify plugin init  →  python -m main (debug)  →  dify plugin package ./plugin

Dify 1.0.0 (28 februarie 2025) a introdus sistemul de pluginuri: pachete cu extensia .difypkg care adaugă capabilități în Dify. Uneltele și furnizorii de modele au fost scoși din nucleu și se instalează separat, nodul Agent primește strategii din pluginuri, iar Dify Marketplace a devenit catalogul public. În versiunile actuale, interfața numește această zonă Integrations: un plugin instalat o dată este disponibil pentru toate aplicațiile din workspace.

Tipurile de integrări din interfață sunt Model Provider (LLM, embedding, rerank, TTS, STT, moderare), Tool, Data Source (pentru Knowledge Pipeline), Trigger, Agent Strategy și Extension (endpoint-uri HTTP pe care le apelează servicii externe). Pe lângă ele, Custom Endpoint conectează API-ul tău pentru moderare sau date externe. Un plugin Tool poate expune și endpoint-uri; un plugin Model nu poate include alte tipuri.

Surse de instalare: Marketplace (verificare automată și umană înainte de publicare), GitHub (orice repo public, după URL și versiune, fără verificare) și Local Package File (pachete private). Proprietarul și administratorii workspace-ului decid din Permissions cine poate instala și cine poate face debugging; actualizările automate se setează pe categorii (oprite, doar patch-uri sau mereu ultima versiune). Pe instanțele self-hosted, pluginurile rulează în serviciul plugin_daemon, iar semnătura pachetelor este verificată implicit (FORCE_VERIFYING_SIGNATURE=true).

Pentru dezvoltare folosești CLI-ul de pluginuri dify, diferit de difyctl (CLI-ul care rulează și administrează aplicații). Pe macOS se instalează cu Homebrew, pe Linux și Windows din release-urile repo-ului dify-plugin-daemon; documentația cere Python 3.12. dify plugin init creează proiectul (tipuri: tool, agent-strategy, llm, text-embedding, rerank, tts, speech2text, moderation, extension, datasource, trigger), iar pluginul se conectează la o instanță prin debugging de la distanță.

Concepte cheie și caracteristici

Concept / Parametru	Descriere practică
Model Provider	Furnizorii de modele (OpenAI, Anthropic, Ollama etc.) se instalează ca pluginuri; după instalare, introduci cheia API cu Setup. Doar proprietarul și administratorii îi pot gestiona.
Tool	Unelte pentru nodurile Tool și Agent. Din aceeași pagină se adaugă și unelte OpenAPI (Swagger), workflow-uri publicate ca unelte și servere MCP.
Data Source	Surse pentru Knowledge Pipeline (Google Drive, Notion, crawlere web etc.).
Trigger	Plugin care transformă evenimentele unei platforme (primite prin webhook) în porniri de workflow (din 1.10.0).
Agent Strategy	Bucla de raționament a nodului Agent clasic (de exemplu Function Calling sau ReAct).
Extension	Endpoint HTTP găzduit în Dify, apelat de un serviciu extern.
.difypkg	Pachetul unui plugin. Același fișier se folosește pentru Marketplace, release-uri GitHub sau instalare locală.
FORCE_VERIFYING_SIGNATURE	Implicit true: pachetele nesemnate instalate din fișier sunt respinse. Alternativa recomandată în locul dezactivării este verificarea cu semnături terțe.
MARKETPLACE_ENABLED	Implicit true. Cu false, consola ascunde Marketplace, iar instalarea din GitHub sau din fișier rămâne posibilă.
PLUGIN_MAX_PACKAGE_SIZE / PIP_MIRROR_URL	Mărimea maximă a unui pachet (implicit 50 MB) și un mirror PyPI pentru dependențele pluginurilor.

Exemple practice și scenarii reale

Exemplul 1: Instalarea CLI-ului și un proiect nou (macOS)

brew tap langgenius/dify
brew install dify
dify version
dify plugin init

Exemplul 2: Debugging de la distanță

Cheia și adresa le copiezi din pagina de pluginuri a instanței (iconița de debug). REMOTE_INSTALL_URL are forma gazdă:port; portul implicit pentru debugging este 5003.

cd hello-world
cp .env.example .env
# în .env:
# INSTALL_METHOD=remote
# REMOTE_INSTALL_URL=dify.example.com:5003
# REMOTE_INSTALL_KEY=<cheia de debug>
pip install -r requirements.txt
python -m main

Exemplul 3: Împachetare și semnare pentru o instanță self-hosted

Administratorul adaugă cheia publică în lista de verificare a instanței; cheia privată rămâne secretă.

dify plugin package ./hello-world
dify signature generate -f cheia_mea
dify signature sign hello-world.difypkg -p cheia_mea.private.pem
dify signature verify hello-world.signed.difypkg -p cheia_mea.public.pem

Greșeli frecvente și capcane

• Cauți modelele OpenAI sau Anthropic „gata incluse” într-o instanță nouă. Din 1.0.0, furnizorii sunt pluginuri; îi instalezi din Integrations › Model Provider și adaugi cheia.
• Dezactivezi complet verificarea semnăturilor ca să instalezi un plugin intern. Documentația recomandă semnarea pachetului cu o cheie proprie și adăugarea cheii publice în instanță.
• Confunzi dify (CLI-ul de pluginuri) cu difyctl (CLI-ul pentru aplicații). Au instalări și comenzi diferite.
• Instalezi din GitHub un plugin pe care nu l-ai citit. Instalarea din GitHub nu trece prin verificarea Marketplace.

Noțiuni și module înrudite

• dify-mcp
• dify-knowledge-pipeline
• dify-docker-self-hosting
• dify-variabile-mediu