ツール

事前構築された統合で外部サービスとAPIに接続

⚠️ このドキュメントはAIによって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。

ツールノードは、事前構築された統合を通じて、ワークフローを外部サービスやAPIに接続します。HTTPリクエストノードとは異なり、ツールは構造化されたインターフェース、組み込みエラーハンドリング、人気のサービス向けの簡素化された設定を提供します。

ツールノード設定インターフェース

​

ツールの種類

Difyは、さまざまな統合ニーズに対応するため、複数のタイプのツールをサポートしています：

利用可能なツールカテゴリとオプション

組み込みツール

Google検索、天気API、生産性ツール、AIサービスなどの人気サービス向けに、Difyが管理する、すぐに使用できる統合。これらのツールは最小限の設定で、信頼性があり、テスト済みの統合を提供します。

​

設定

​

認証

多くのツールはAPIキーまたはOAuth認証を必要とします。ワークフローで使用する前に、ワークスペースのツールセクションでこれらの認証情報を設定してください。認証は一度設定すれば自動的に処理されます。

​

入力パラメータ

ツールは、入力設定のための検証付き構造化フォームを提供します。前のワークフローノードからの変数を使用してパラメータを設定します。インターフェースは自動的にデータタイプの検証を処理し、各パラメータに役立つ説明を提供します。

​

出力処理

ツールは構造化されたデータを返し、これが下流のノードで変数として利用可能になります。出力スキーマは事前定義されており、互換性を確保し、統合の複雑さを軽減します。

​

HTTPリクエストに対する利点

構造化されたインターフェースは、組み込み検証を備えたフォームベースの設定を提供し、手動でのHTTPリクエスト設定よりもセットアップを簡単にします。

組み込みエラーハンドリングには、自動リトライロジックとエラー管理が含まれ複雑さを軽減します。

型安全性により、入力および出力スキーマがワークフローノード間でのデータ互換性を維持することが保証されます。

ドキュメントには、各ツールの使用例と詳細なパラメータ説明が含まれています。

​

エラーハンドリングとリトライ

外部サービスに依存するツールの堅牢なエラーハンドリングを設定します：

ツールリトライ設定

リトライ設定は、失敗したツール実行を設定可能な間隔（最大5000ms）で最大10回まで自動的にリトライします。これは一時的なサービス問題やネットワークの問題を処理します。

ツールエラーハンドリングオプション

エラーハンドリングは、ツール実行が失敗した場合の代替ワークフローパスを定義し、外部サービスが利用できない場合でもワークフローが継続することを確保します。

​

カスタムツールの作成

OpenAPI統合により、OpenAPI/Swagger仕様を持つ任意のサービスをインポートできます。インポートされると、そのサービスは組み込みオプションと同じ使いやすさでツールとして利用可能になります。

ワークフロー公開は、マルチノードワークフローを、異なるアプリケーション間で再利用できるシングルノードツールに変換します。これはモジュール性を促進し、複雑なワークフロー管理を簡素化します。

​

ツール管理

ワークスペースナビゲーションのツールを通じてツール設定にアクセスします。ここでは、認証認証情報の管理、カスタムツールのインポート、MCPサーバーの設定、ワークフローのツールとしての公開を行うことができます。

ツールの作成、管理、ワークフローのツールとしての公開に関する詳細なガイダンスについては、ツール設定ガイドを参照してください。