ツール

• ツールタイプのプラグインが機能を実装したものの、結果が期待どおりではなく、データの後処理が必要な場合。
• タスクに Web スクレイパーが必要で、スクレイピングサービスを柔軟に選びたい場合。
• 複数のツールの結果を集約する必要があるが、Workflow アプリケーションでは処理が難しい場合。

​

インストール済みツールの呼び出し

​

エントリーポイント

    self.session.tool

​

インターフェース

    def invoke_builtin_tool(
        self, provider: str, tool_name: str, parameters: dict[str, Any]
    ) -> Generator[ToolInvokeMessage, None, None]:
        pass

• provider：プラグイン ID とツール供給元名を組み合わせたもので、langgenius/google/google のような形式です。
• tool_name：具体的なツール名です。
• parameters：ツールに渡す引数です。

​

Workflow as Tool の呼び出し

​

エントリーポイント

    self.session.tool

​

インターフェース

    def invoke_workflow_tool(
        self, provider: str, tool_name: str, parameters: dict[str, Any]
    ) -> Generator[ToolInvokeMessage, None, None]:
        pass

• provider：このツールの ID です。
• tool_name：ツールの作成時に指定した名前です。

​

カスタムツールの呼び出し

​

エントリーポイント

    self.session.tool

​

インターフェース

    def invoke_api_tool(
        self, provider: str, tool_name: str, parameters: dict[str, Any]
    ) -> Generator[ToolInvokeMessage, None, None]:
        pass

• provider：このツールの ID です。
• tool_name：OpenAPI 仕様の operation_id です。operation_id が存在しない場合は、Dify によって自動生成された tool_name であり、ツール管理ページで確認できます。

​

関連リソース

• Dify サービスの逆呼び出し - 逆呼び出しの基本概念を理解する
• アプリの逆呼び出し - プラットフォーム内でアプリを呼び出す方法を学ぶ
• モデルの逆呼び出し - プラットフォーム内でモデル機能を呼び出す方法を学ぶ
• ツールプラグイン開発ガイド - ツールプラグインの開発方法を学ぶ
• 高度なツールプラグイン - Workflow as Tool などの高度な機能について学ぶ