mirror of
https://github.com/langgenius/dify-docs.git
synced 2026-03-27 13:28:32 +07:00
103 lines
4.9 KiB
Plaintext
103 lines
4.9 KiB
Plaintext
---
|
||
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)
|
||
|