---
dimensions:
  type:
    primary: implementation
    detail: advanced
  level: intermediate
standard_title: Reverse Invocation Tool
language: ja
title: ツール
description: このドキュメントでは、プラグインがDifyプラットフォーム内のツールサービスをリバース呼び出しする方法について詳しく説明します。内容は、インストール済みのツール（Built-in
  Tool）の呼び出し、Workflow as Toolの呼び出し、カスタムツール（Custom Tool）の呼び出しという3つの異なるタイプのツール呼び出し方法を網羅しています。各呼び出し方法には、対応するエントリポイントとインターフェースパラメータの説明が付いています。
---

リバース呼び出しツールとは、プラグインがDifyプラットフォーム内の他のツールタイプのプラグインを呼び出すことができることを指します。リバース呼び出しの基本概念にまだ慣れていない場合は、まず[Difyサービスのリバース呼び出し](/plugin-dev-ja/9241-reverse-invocation)をお読みください。

次のような要求に遭遇した場合：

* あるツールタイプのプラグインが既に機能を実装しているが、期待通りの効果が得られず、データの二次加工が必要な場合。
* あるタスクでクローラーを使用する必要があり、クローラーサービスを自由に選択したい場合。
* 複数のツールの結果を統合する必要があるが、Workflowアプリケーションでは処理が難しい場合。

この場合、プラグイン内で既に実装されている他のツールを呼び出す必要があります。そのツールは、マーケットプレイスのツールプラグイン、独自に構築したWorkflow as a Tool、またはカスタムツールである可能性があります。

上記の要求は、プラグインの `self.session.tool` フィールドを呼び出すことで実現できます。

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

プラグインが現在のワークスペースにインストールされている各ツール（他のツールタイプのプラグインも含む）を呼び出すことを許可します。

**エントリポイント**

```python
    self.session.tool
```

**インターフェース**

```python
    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 の呼び出し

**エントリポイント**

```python
    self.session.tool
```

**インターフェース**

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

この場合、provider はそのツールのIDです。tool\_name はそのツールの作成時に記入が求められます。

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

**エントリポイント**

```python
    self.session.tool
```

**インターフェース**

```python
    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` であり、存在しない場合は Dify が自動生成した `tool_name` となります。具体的な名称はツール管理ページで確認できます。

## 関連リソース

- [Difyサービスのリバース呼び出し](/plugin-dev-ja/9241-reverse-invocation) - リバース呼び出しの基本概念を理解する
- [Appのリバース呼び出し](/plugin-dev-ja/9242-reverse-invocation-app) - プラットフォーム内のAppを呼び出す方法を理解する
- [Modelのリバース呼び出し](/plugin-dev-ja/9242-reverse-invocation-model) - プラットフォーム内のモデル機能を呼び出す方法を理解する
- [ツールプラグイン開発ガイド](/plugin-dev-ja/0211-getting-started-dify-tool) - ツールプラグインの開発方法を学ぶ
- [高度なツールプラグイン](/plugin-dev-ja/9223-tool.ja) - Workflow as Tool などの高度な機能を理解する

{/*
Contributing Section
DO NOT edit this section!
It will be automatically generated by the script.
*/}

---

[このページを編集する](https://github.com/langgenius/dify-docs/edit/main/plugin-dev-ja/9242-reverse-invocation-tool.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?template=docs.yml)