Tool¶
Note: ⚠️ このドキュメントはAIによって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。
概要¶
Note:
詳細なインターフェースドキュメントに入る前に、FlexAIプラグインのツール統合プロセスについて全般的な理解があることを確認してください。
- メッセージタイプ - テキスト、リンク、画像、JSONなど、さまざまな種類のメッセージを返す
- 変数 - ワークフロー統合のための変数を作成および操作する
- 出力スキーマ - ワークフロー参照用のカスタム出力変数を定義する
データ構造¶
メッセージの戻り値¶
Info:
FlexAIは
text、links、images、file BLOBs、JSONなど、さまざまなメッセージタイプをサポートしています。これらのメッセージは専用のインターフェースを通じて返すことができます。
デフォルトでは、ワークフロー内のツールの出力には files、text、json の3つの固定変数が含まれます。以下のメソッドを使用して、これらの変数に適切なコンテンツを設定できます。
Tip:
create_image_messageなどのメソッドを使用して画像を返すことができますが、ツールはカスタム出力変数もサポートしており、ワークフロー内で特定のデータを参照するのに便利です。
メッセージタイプ¶
```python Image URL def create_image_message(self, image: str) -> ToolInvokeMessage: """ Return an image URL message
FlexAI will automatically download the image from the provided URL
and display it to the user.
Args:
image: URL to an image file
Returns:
ToolInvokeMessage: Message object for the tool response
"""
pass
python Link
def create_link_message(self, link: str) -> ToolInvokeMessage:
"""
Return a clickable link message
Args:
link: URL to be displayed as a clickable link
Returns:
ToolInvokeMessage: Message object for the tool response
"""
pass
```
```python Text def create_text_message(self, text: str) -> ToolInvokeMessage: """ Return a text message
Args:
text: Text content to be displayed
Returns:
ToolInvokeMessage: Message object for the tool response
"""
pass
python File
def create_blob_message(self, blob: bytes, meta: dict = None) -> ToolInvokeMessage:
"""
Return a file blob message
For returning raw file data such as images, audio, video,
or documents (PPT, Word, Excel, etc.)
Args:
blob: Raw file data in bytes
meta: File metadata dictionary. Include 'mime_type' to specify
the file type, otherwise 'octet/stream' will be used
Returns:
ToolInvokeMessage: Message object for the tool response
"""
pass
```
```python JSON def create_json_message(self, json: dict) -> ToolInvokeMessage: """ Return a formatted JSON message
Useful for data transmission between workflow nodes.
In agent mode, most LLMs can read and understand JSON data.
Args:
json: Python dictionary to be serialized as JSON
Returns:
ToolInvokeMessage: Message object for the tool response
"""
pass
``
<details>
<summary>パラメータ</summary>
ダウンロードして表示される画像のURL
クリック可能なリンクとして表示されるURL
表示されるテキストコンテンツ
バイト形式の生ファイルデータ
以下を含むファイルメタデータ：
-mime_type`：ファイルのMIMEタイプ（例："image/png"）
- ファイルに関連するその他のメタデータ
JSONとしてシリアライズされるPython辞書
Tip:
ファイルBLOBを扱う際は、ファイルが正しく処理されるように、
meta辞書に常にmime_typeを指定してください。例：{"mime_type": "image/png"}。
変数¶
python Standard Variable
from typing import Any
def create_variable_message(self, variable_name: str, variable_value: Any) -> ToolInvokeMessage:
"""
Create a named variable for workflow integration
For non-streaming output variables. If multiple instances with the
same name are created, the latest one overrides previous values.
Args:
variable_name: Name of the variable to create
variable_value: Value of the variable (any Python data type)
Returns:
ToolInvokeMessage: Message object for the tool response
"""
pass
```python Streaming Variable def create_stream_variable_message( self, variable_name: str, variable_value: str ) -> ToolInvokeMessage: """ Create a streaming variable with typewriter effect
When referenced in an answer node in a chatflow application,
the text will be output with a typewriter effect.
Args:
variable_name: Name of the variable to create
variable_value: String value to stream (only strings supported)
Returns:
ToolInvokeMessage: Message object for the tool response
"""
pass
```
パラメータ
作成または更新される変数の名前
変数に割り当てる値：
- 標準変数の場合：任意のPythonデータ型
- ストリーミング変数の場合：文字列データのみ
Warning:
ストリーミング変数メソッド（
create_stream_variable_message）は現在、文字列データのみをサポートしています。複雑なデータ型はタイプライター効果でストリーミングできません。
カスタム出力変数¶
Info:
ワークフローアプリケーションでツールの出力変数を参照するには、どの変数が出力される可能性があるかを定義する必要があります。これはツールのマニフェストで JSON Schema 形式を使用して行います。
出力スキーマの定義¶
yaml Tool Manifest with Output Schema
identity:
author: example_author
name: example_tool
label:
en_US: Example Tool
zh_Hans: 示例工具
ja_JP: ツール例
pt_BR: Ferramenta de exemplo
description:
human:
en_US: A simple tool that returns a name
zh_Hans: 返回名称的简单工具
ja_JP: 名前を返す簡単なツール
pt_BR: Uma ferramenta simples que retorna um nome
llm: A simple tool that returns a name variable
output_schema:
type: object
properties:
name:
type: string
description: "The name returned by the tool"
age:
type: integer
description: "The age returned by the tool"
profile:
type: object
properties:
interests:
type: array
items:
type: string
location:
type: string
スキーマ構造
ツールの出力スキーマを定義するルートオブジェクト ツール出力スキーマでは "object" である必要があります すべての可能な出力変数の辞書 各出力変数の定義（型と説明を含む）Warning:
出力スキーマを定義しても、実装コードで
create_variable_message()を使用して実際に変数を返す必要があります。そうしないと、ワークフローはその変数に対してNoneを受け取ります。
実装例¶
```python Basic Variable Example def run(self, inputs): # Process inputs and generate a name generated_name = "Alice"
# Return the name as a variable that matches the output_schema
return self.create_variable_message("name", generated_name)
python Complex Structure Example
def run(self, inputs):
# Generate complex structured data
user_data = {
"name": "Bob",
"age": 30,
"profile": {
"interests": ["coding", "reading", "hiking"],
"location": "San Francisco"
}
}
# Return individual variables
self.create_variable_message("name", user_data["name"])
self.create_variable_message("age", user_data["age"])
self.create_variable_message("profile", user_data["profile"])
# Also return a text message for display
return self.create_text_message(f"User {user_data['name']} processed successfully")
```
Tip:
複雑なワークフローの場合、複数の出力変数を定義してすべてを返すことができます。これにより、ワークフロー設計者がツールを使用する際の柔軟性が向上します。
例¶
完全なツール実装¶
```python Weather Forecast Tool
from typing import Any
class WeatherForecastTool: def run(self, inputs: dict) -> Any: # Get location from inputs location = inputs.get("location", "London")
try:
# Call weather API (example only)
weather_data = self._get_weather_data(location)
# Create variables for workflow use
self.create_variable_message("temperature", weather_data["temperature"])
self.create_variable_message("conditions", weather_data["conditions"])
self.create_variable_message("forecast", weather_data["forecast"])
# Create a JSON message for data transmission
self.create_json_message(weather_data)
# Create an image message for the weather map
self.create_image_message(weather_data["map_url"])
# Return a formatted text response
return self.create_text_message(
f"Weather in {location}: {weather_data['temperature']}°C, {weather_data['conditions']}. "
f"Forecast: {weather_data['forecast']}"
)
except Exception as e:
# Handle errors gracefully
return self.create_text_message(f"Error retrieving weather data: {str(e)}")
def _get_weather_data(self, location: str) -> dict:
# Mock implementation - in a real tool, this would call a weather API
return {
"location": location,
"temperature": 22,
"conditions": "Partly Cloudy",
"forecast": "Sunny with occasional showers tomorrow",
"map_url": "https://example.com/weather-map.png"
}
```
Tip:
ツールを設計する際は、直接出力（ユーザーが見るもの）と変数出力（他のワークフローノードが使用できるもの）の両方を考慮してください。この分離により、ツールの使用方法に柔軟性が生まれます。
{/ Contributing Section DO NOT edit this section! It will be automatically generated by the script. /}