このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
構築するもの#
このガイドを終えると、以下の機能を持つDifyプラグインが完成します:
- Flomoメモ取りAPIへの接続
- AIとの会話から直接Flomoにメモを保存する機能
- 認証とエラー状態の適切な処理
- Dify マーケットプレイスでの配布準備完了
10分
基本的なPythonの知識とFlomoアカウント
ステップ1:Dify プラグイン CLIのインストールとプロジェクト作成#
Dify プラグイン CLIのインストール
Dify Plugin Daemonリリースページから最新のバイナリをダウンロードしてください。x86_64の場合はdify-plugin-linux-amd64を、ARMの場合はdify-plugin-linux-arm64を選択してください。
インストールを確認:
プラグインプロジェクトの初期化
以下のコマンドで新しいプラグインプロジェクトを作成します:
プロンプトに従ってプラグインをセットアップします:
- 名前を
flomoにする - プラグインタイプとして
toolを選択 - その他の必須フィールドを入力
プロジェクトに移動
このプロジェクトには、必要なすべてのファイルを含むプラグインの基本構造が含まれています。
ステップ2:プラグインマニフェストの定義#
manifest.yaml ファイルはプラグインのメタデータ、権限、機能を定義します。
manifest.yamlファイルを作成します:
ステップ3:ツール定義の作成#
ツールプラグインは2つのYAMLファイルを使用します:認証情報を宣言しツールをリストするプロバイダーファイルと、呼び出し可能なツールごとに1つのツールファイルです。完全なスキーマについては一般仕様を参照してください。
provider/flomo.yamlを作成します:
tools/flomo.yamlを作成します:
ステップ4:コアユーティリティ関数の実装#
API連携用のユーティリティモジュールをutils/flomo_utils.pyに作成します:
ステップ5:ツールプロバイダーの実装#
ツールプロバイダーは認証情報の検証を処理します。provider/flomo.pyを作成します:
ステップ6:ツールの実装#
Toolクラスはユーザーがプラグインを呼び出したときに実際のAPI呼び出しを処理します。tools/flomo.pyを作成します:
常に例外を適切に処理し、ユーザーフレンドリーなエラーメッセージを返すようにしてください。あなたのプラグインはDifyエコシステムにおけるブランドを代表するものであることを忘れないでください。
ステップ7:プラグインのテスト#
デバッグ環境のセットアップ
サンプル環境ファイルをコピーします:
.env ファイルを Dify 環境の詳細で編集します:
デバッグURLとキーはDifyダッシュボードで確認できます:右上のプラグインアイコンをクリックし、デバッグアイコンをクリックします。APIキーとホストアドレスをコピーしてください(ホストにはすでにポートが含まれています)。
依存関係のインストールと実行
プラグインがデバッグモードでDifyインスタンスに接続されます。
機能のテスト
Dify インスタンスで プラグイン ページを開き、プラグイン(debugging とマークされています)を見つけます。Flomo API の認証情報を追加し、メモの送信をテストします。
ステップ8:パッケージ化と配布#
プラグインを共有する準備ができたら:
これにより、Dify マーケットプレイスにアップロードできる plugin.difypkg ファイルが作成されます。
FAQとトラブルシューティング#
デバッグモードでプラグインが表示されない
.envファイルが正しく設定されていること、正しいデバッグキーを使用していることを確認してください。
API認証エラー
Flomo API URLの形式を再確認してください。形式は次のようになっている必要があります:https://flomoapp.com/iwh/{token}/{secret}/
パッケージ化に失敗
必要なすべてのファイルが存在し、manifest.yaml の構造が有効であることを確認してください。
まとめ#
外部 API サービスと連携する機能的な Dify プラグインを構築しました。この同じパターンは、データベースや検索エンジンから生産性ツールやカスタム API まで、何千ものサービスとの統合に使用できます。
機能、セットアップ、使用例を説明する README.md を英語(en_US)で作成してください
他の言語用にreadme/README_zh_Hans.mdのような追加のREADMEファイルを作成してください