Files
dify-docs/ja-jp/plugins/quick-start/develop-plugins/bundle.mdx
2025-05-17 04:00:59 +08:00

129 lines
6.2 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: バンドル
---
{/*
コントリビューター注:
----------------
これはレガシードキュメントであり、非推奨になります。
このバージョンに変更を加えないでください。
すべての更新は新しいバージョンに向けられるべきです:
/plugin_dev_ja/9241-bundle.ja
*/}
<Card title="このドキュメントはまもなく非推奨になります" icon="circle-exclamation" href="/plugin_dev_ja/9241-bundle.ja">
<p>ドキュメント再編の一環として、このページは段階的に廃止されます。</p>
<p><u><b>このカードをクリックして</b></u>、最新情報が含まれる更新版にリダイレクトしてください。</p>
<p>新しいドキュメントに不一致や改善が必要な箇所を見つけた場合は、ページ下部の「問題を報告」ボタンを使用してください。</p>
</Card>
バンドルプラグインパッケージは、複数のプラグインをまとめたものです。複数のプラグインを一つのパッケージにまとめることで、プラグインの一括インストールを可能にし、より高度な機能を提供します。
Dify CLIツールを使用すると、複数のプラグインをバンドルとしてパッケージ化できます。バンドルプラグインパッケージには、以下の3つのタイプがあります。
* `Marketplace` タイププラグインのIDとバージョン情報を保持します。インポート時には、Dify Marketplaceから該当するプラグインパッケージをダウンロードします。
* `GitHub` タイプGitHubリポジトリのアドレス、リリースバージョン番号、アセットファイル名を保持します。インポート時に、Difyは該当するGitHubリポジトリにアクセスしてプラグインパッケージをダウンロードします。
* `Package` タイプ:プラグインパッケージをバンドル内に直接格納します。参照元は保持されませんが、バンドルパッケージのサイズが大きくなる可能性があります。
### 事前準備
* Difyプラグインのひな形ツール
* Python環境バージョン3.11以上)
プラグイン開発のひな形ツールを準備する方法の詳細については、「[開発ツールの初期化](/ja-jp/plugins/quick-start/develop-plugins/initialize-development-tools)」を参照してください。
### バンドルプロジェクトの作成
現在のディレクトリで、ひな形コマンドラインツールを実行し、新しいプラグインパッケージプロジェクトを作成します。
```bash
./dify-plugin-darwin-arm64 bundle init
```
このバイナリファイルを `dify` にリネームし、`/usr/local/bin` ディレクトリにコピーした場合、次のコマンドを実行して新しいプラグインプロジェクトを作成できます。
```bash
dify bundle init
```
#### 1. プラグイン情報の入力
プロンプトに従って、プラグイン名、作成者情報、プラグインの説明を設定します。チームで共同作業している場合は、作成者に組織名を記入することもできます。
> 名前は1〜128文字で、文字、数字、ダッシュ、アンダースコアのみを使用できます。
![バンドルの基本情報](https://assets-docs.dify.ai/2024/12/03a1c4cdc72213f09523eb1b40832279.png)
情報を入力してEnterキーを押すと、バンドルプラグインプロジェクトのディレクトリが自動的に作成されます。
![](https://assets-docs.dify.ai/2024/12/356d1a8201fac3759bf01ee64e79a52b.png)
#### 2. 依存関係の追加
* **マーケットプレイス(Marketplace)**
次のコマンドを実行します。
```bash
dify-plugin bundle append marketplace . --marketplace_pattern=langgenius/openai:0.0.1
```
ここで、`marketplace_pattern` は、Marketplaceでのプラグインの参照であり、形式は `組織名/プラグイン名:バージョン番号` です。
* **Github**
次のコマンドを実行します。
```bash
dify-plugin bundle append github . --repo_pattern=langgenius/openai:0.0.1/openai.difypkg
```
ここで、`repo_pattern` は、GitHubでのプラグインの参照であり、形式は `組織名/リポジトリ名:リリース/添付ファイル名` です。
* **パッケージ(package)**
次のコマンドを実行します。
```bash
dify-plugin bundle append package . --package_path=./openai.difypkg
```
ここで、`package_path` は、プラグインパッケージのディレクトリです。
### バンドルプロジェクトのパッケージ化
次のコマンドを実行して、バンドルプラグインをパッケージ化します。
```bash
dify-plugin bundle package ./bundle
```
コマンドを実行すると、現在のディレクトリに `bundle.difybndl` ファイルが自動的に作成されます。このファイルが最終的なパッケージ結果です。
{/*
Contributing Section
DO NOT edit this section!
It will be automatically generated by the script.
*/}
<CardGroup cols="2">
<Card
title="このページを編集する"
icon="pen-to-square"
href="https://github.com/langgenius/dify-docs-mintlify/edit/main/ja-jp/plugins/quick-start/develop-plugins/bundle.mdx"
>
直接貢献することでドキュメントの改善にご協力ください
</Card>
<Card
title="問題を報告する"
icon="github"
href="https://github.com/langgenius/dify-docs-mintlify/issues/new?title=ドキュメントの問題%3A%20&body=%23%23%20問題の説明%0A%3C%21--%20発見した問題について簡単に説明してください%20--%3E%0A%0A%23%23%20ページリンク%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs-mintlify%2Fblob%2Fmain%2Fja-jp/plugins/quick-start/develop-plugins%2Fbundle.mdx%0A%0A%23%23%20提案される変更%0A%3C%21--%20特定の変更案がある場合は、ここで説明してください%20--%3E%0A%0A%3C%21--%20ドキュメントの品質向上にご協力いただきありがとうございます%20--%3E"
>
エラーを見つけたり提案がありますか?お知らせください
</Card>
</CardGroup>