Dify のツールプラグインを作成する

• 前提
• 環境構築
• プラグインプロジェクトの作成
• プラグインプロジェクトの設定
• Dify プロジェクト用仮想環境の構築
• プラグイン実行
• 実装
• パッケージ化
• パッケージ化したプラグインのインストール
  • 野良パッケージインストールのため、署名検証を OFF にする
  • インストール
• 参考資料

前提

• OS: Ubuntu 24.04 on WSL2
• Dify CLI: 0.6.1

環境構築

Dify CLI をダウンロードし、パスを通す。

curl -L https://github.com/langgenius/dify-plugin-daemon/releases/download/0.6.1/dify-plugin-linux-amd64 -o dify
chmod +x dify
sudo mv dify /usr/local/bin/

プラグインプロジェクトの作成

mkdir ~/project
cd ~/project
dify plugin init

ウィザードが始まるので、それにしたがって入力する。 今回は、 file-outputer という名前のプラグインを作成することにする。

cd file-outputer

プラグインプロジェクトの設定

cp .env.example .env
vim .env

1. Dify 環境にログインし、右上の「プラグイン」アイコン -> デバッグアイコン（虫のようなもの）をクリック
2. ポップアップウィンドウで「APIキー」と「ホストアドレス」が表示されるので、これを .env ファイルの DIFY_API_KEY と DIFY_HOST にそれぞれコピーする

Dify プロジェクト用仮想環境の構築

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -r requirements.txt

プラグイン実行

以下コマンドを実行すると、 DIFY_HOST で指定した Dify 環境にプラグインが接続され、インストールされる。

python3 -m main

実装

詳細は省略。

mikoto2000/dify-file-outputer: Dify のファイルアウトプット用ツールプラグイン。 を参考にしてください。

パッケージ化

cd ..
dify plugin package file-outputer

これで、 file-outputer.difypkg というファイルが生成される。

パッケージ化したプラグインのインストール

野良パッケージインストールのため、署名検証を OFF にする

Dify の docker/.env に以下を追加または変更。

FORCE_VERIFYING_SIGNATURE=false

コンテナ再起動。

docker compose down
docker compose up -d

インストール

Dify の Web UI で以下を実施。

1. 右上の プラグイン アイコンを開く
2. プラグインをインストールする をクリック
3. ローカルパッケージファイル を選択
4. 作成した .difypkg をアップロード
5. インストール をクリック

これで、ワークフローからツールが使えるようになる。

以上。

参考資料

• CLI - Dify Docs