このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
構築するもの
このガイドを終えると、以下の機能を持つDifyプラグインが完成します:- Flomoメモ取りAPIへの接続
- AIとの会話から直接Flomoにメモを保存する機能
- 認証とエラー状態の適切な処理
- Dify マーケットプレイスでの配布準備完了
所要時間
10分
前提条件
基本的なPythonの知識とFlomoアカウント
ステップ1:Dify プラグイン CLIのインストールとプロジェクト作成
1
Dify プラグイン CLIのインストール
- Mac
- Linux
2
プラグインプロジェクトの初期化
以下のコマンドで新しいプラグインプロジェクトを作成します:プロンプトに従ってプラグインをセットアップします:
- 名前を
flomoにする - プラグインタイプとして
toolを選択 - その他の必須フィールドを入力
3
プロジェクトに移動
ステップ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を作成します:
ステップ7:プラグインのテスト
1
デバッグ環境のセットアップ
サンプル環境ファイルをコピーします:デバッグURLとキーはDifyダッシュボードで確認できます:右上のプラグインアイコンをクリックし、デバッグアイコンをクリックします。APIキーとホストアドレスをコピーしてください(ホストにはすでにポートが含まれています)。
.env ファイルを Dify 環境の詳細で編集します:2
依存関係のインストールと実行
3
機能のテスト
Dify インスタンスで プラグイン ページを開き、プラグイン(debugging とマークされています)を見つけます。Flomo API の認証情報を追加し、メモの送信をテストします。
ステップ8:パッケージ化と配布
プラグインを共有する準備ができたら:plugin.difypkg ファイルが作成されます。
FAQとトラブルシューティング
デバッグモードでプラグインが表示されない
デバッグモードでプラグインが表示されない
.envファイルが正しく設定されていること、正しいデバッグキーを使用していることを確認してください。API認証エラー
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ファイルを作成してください