feat: release 2.0.9

2026-07-19 21:07:28 +08:00 · 2026-05-22 12:25:22 +08:00
parent cc10d230b0
commit 069bffa3e8
44 changed files with 1756 additions and 744 deletions
--- a/docs/ja/tools/vision.mdx
+++ b/docs/ja/tools/vision.mdx
@@ -1,41 +1,57 @@
 ---
-title: vision - 画像分析
-description: 画像コンテンツの分析（認識、説明、OCR など）
+title: vision - 画像理解
+description: 画像コンテンツを分析（認識、説明、OCR など）
 ---

 Vision API を使用してローカル画像や画像 URL を分析します。コンテンツの説明、テキスト抽出（OCR）、オブジェクト認識などに対応しています。

 ## モデル選択

-Vision ツールは多段階の自動選択＋自動フォールバック戦略を採用しており、手動設定なしで利用可能です：
+Vision ツールは多段階の自動選択 + 自動フォールバック戦略を採用しており、手動設定なしで利用できます：

-1. **メインモデル** — 現在設定されているメインモデルで画像認識を実行（追加コストなし）
-2. **その他の設定済みモデル** — API キーが設定されている他のマルチモーダルモデルを自動検出
-3. **OpenAI** — `open_ai_api_key` を使用して gpt-4.1-mini を呼び出し
-4. **LinkAI** — `linkai_api_key` を使用して LinkAI ビジョンサービスを呼び出し
+1. **メインモデル** — 現在設定されているメインモデルを優先的に使用して画像認識を行います（マルチモーダルモデルである必要があります）
+2. **その他の設定済みモデル** — API Key が設定済みのその他のマルチモーダルモデルを自動的に検出して候補とします

-`use_linkai=true` の場合、LinkAI が最優先になります。
-
-現在のプロバイダーが失敗した場合、成功するかすべて失敗するまで自動的に次のプロバイダーを試行します。
+現在のプロバイダーで呼び出しに失敗した場合、成功するかすべて失敗するまで自動的に次のプロバイダーを試行します。

 ### 対応モデル

-| ベンダー | ビジョンモデル | 説明 |
+| プロバイダー | ビジョンモデル | 説明 |
 | --- | --- | --- |
-| OpenAI / 互換プロトコル | メインモデル | すべての OpenAI 互換マルチモーダルモデルに対応 |
-| Baidu Qianfan | メインモデル | 多モーダルの主モデル（`ernie-5.1` など）は直接画像を処理。テキスト専用主モデルの場合は `ernie-4.5-turbo-vl` に自動フォールバック |
-| 通義千問 (DashScope) | メインモデル | MultiModalConversation API 経由 |
-| Claude | メインモデル | Anthropic ネイティブ画像形式 |
-| Gemini | メインモデル | inlineData 形式 |
-| 豆包 (Doubao) | メインモデル | doubao-seed-2-0 シリーズがネイティブ対応 |
-| Kimi (Moonshot) | メインモデル | kimi-k2.6、kimi-k2.5 がネイティブ対応 |
+| OpenAI / 互換プロトコル | メインモデルを使用 | すべての OpenAI 互換マルチモーダルモデルに対応 |
+| 通義千問 (DashScope) | メインモデルを使用 | 例：qwen3.6-plus など |
+| Claude | メインモデルを使用 | Anthropic ネイティブ画像形式 |
+| Gemini | メインモデルを使用 | inlineData 形式 |
+| 豆包 (Doubao) | メインモデルを使用 | doubao-seed-2-0 シリーズがネイティブ対応 |
+| Kimi (Moonshot) | メインモデルを使用 | kimi-k2.6、kimi-k2.5 がネイティブ対応 |
+| 百度 Qianfan | メインモデルを使用 | デフォルトでマルチモーダルメインモデル（`ernie-5.1` など）を使用。メインモデルが非対応の場合は `ernie-4.5-turbo-vl` にフォールバック |
 | 智谱 AI | glm-5v-turbo | 常にビジョン専用モデルを使用 |
 | MiniMax | MiniMax-Text-01 | 常にビジョン専用モデルを使用 |

 <Note>
-  智谱 AI と MiniMax のテキストモデルは画像理解に対応していないため、対応するビジョン専用モデルが自動的に使用されます。
+  智谱と MiniMax のテキストモデルは画像理解に対応していないため、常に対応するビジョン専用モデルが使用されます。手動で指定する必要はありません。
 </Note>

+> `use_linkai=true` の場合、デフォルトで LinkAI のマルチモーダルモデルが使用されます。
+
+## カスタム設定
+
+Vision で使用するモデルを指定したい場合は、`config.json` に以下のように設定できます：
+
+```json
+{
+    "tools": {
+        "vision": {
+            "model": "gpt-4.1"
+        }
+    }
+}
+```
+
+指定したモデルが**優先的に使用**され、ツールはモデル名に応じて対応するプロバイダーへ自動ルーティングします。呼び出しに失敗した場合は、他の設定済みプロバイダーへ自動的にフォールバックします。
+
+ほとんどの場合、設定は不要です。メインモデルがマルチモーダルに対応しているか、ビジョン対応の API Key が 1 つでも設定されていれば自動的に動作します。
+
 ## パラメータ

 | パラメータ | 型 | 必須 | 説明 |
@@ -45,29 +61,15 @@ Vision ツールは多段階の自動選択＋自動フォールバック戦略

 対応画像形式：jpg、jpeg、png、gif、webp

-## カスタム設定

-Vision ツールで使用するモデルを指定するには、`config.json` に以下を追加します：
-
-```json
-{
-    "tools": {
-        "vision": {
-            "model": "ernie-4.5-turbo-vl"
-        }
-    }
-}
-```
-
-ほとんどの場合、設定は不要です。メインモデルがマルチモーダルに対応しているか、ビジョン対応の API キーが設定されていれば自動的に動作します。

 ## ユースケース

 - 画像コンテンツの説明
 - 画像からのテキスト抽出（OCR）
- オブジェクト、色、シーンの識別
- スクリーンショットやスキャン文書の分析
+- オブジェクト、色、シーンの認識
+- スクリーンショットやスキャン文書などの分析

 <Note>
-  1MB を超える画像は自動的に圧縮されます（最大辺 1536px）。すべての画像（リモート URL を含む）は base64 に変換して送信され、すべてのモデルバックエンドとの互換性を確保します。
+  1MB を超える画像は自動的に圧縮してアップロードされます。すべての画像（リモート URL を含む）は base64 に統一変換して送信され、すべてのモデルバックエンドとの互換性を確保します。
 </Note>
--- a/docs/ja/tools/web-search.mdx
+++ b/docs/ja/tools/web-search.mdx
@@ -1,32 +1,51 @@
 ---
-title: web_search - Web検索
-description: インターネットからリアルタイム情報を検索
+title: web_search - Web 検索
+description: インターネットからリアルタイム情報を検索。複数の検索プロバイダーに対応
 ---

-インターネットからリアルタイムの情報、ニュース、リサーチなどを検索します。2つの検索バックエンドに対応し、自動フォールバック機能を備えています。
+インターネットからリアルタイム情報、ニュース、リサーチなどを検索します。Bocha、百度 Qianfan、智谱（Zhipu）、LinkAI の 4 つのバックエンドに対応しており、いずれか 1 社を設定すれば利用可能です。

-## 依存関係
+<Tip>
+  [Web コンソール](/ja/channels/web) の「モデル管理 → 検索」パネルから、プロバイダーと戦略を可視化して設定するのが推奨です。設定ファイルを手動で編集する必要はありません。
+</Tip>

-少なくとも1つの検索APIキーが必要です（`env_config` Toolまたはワークスペースの `.env` ファイルで設定）：
+## プロバイダー

-| バックエンド | 環境変数 | 優先度 | 取得方法 |
-| --- | --- | --- | --- |
-| Bocha Search | `BOCHA_API_KEY` | プライマリ | [Bocha Open Platform](https://open.bochaai.com/) |
-| LinkAI Search | `LINKAI_API_KEY` | フォールバック | [LinkAI Console](https://link-ai.tech/console/interface) |
+| プロバイダー | 認証情報 | 申請窓口 |
+| --- | --- | --- |
+| Bocha | `tools.web_search.bocha_api_key` | [Bocha Open Platform](https://open.bochaai.com/) |
+| 百度 Qianfan | `qianfan_api_key` を再利用 | [Qianfan コンソール](https://cloud.baidu.com/doc/qianfan/s/2mh4su4uy) |
+| 智谱 Zhipu | `zhipu_ai_api_key` を再利用 | [Zhipu Open Platform](https://docs.bigmodel.cn/cn/guide/tools/web-search) |
+| LinkAI | `linkai_api_key` を再利用 | [LinkAI コンソール](https://link-ai.tech/console/interface) |

-## パラメータ
+Bocha のみ独立した `bocha_api_key` が必要ですが、他の 3 社は対応するモデルの API Key をそのまま再利用するため、モデルを設定すれば検索機能も同時に利用可能になります。
+
+## ルーティング戦略
+
+```json
+{
+  "tools": {
+    "web_search": {
+      "strategy": "auto",
+      "provider": ""
+    }
+  }
+}
+```
+
+- `auto`（デフォルト）：Agent が設定済みのプロバイダーから自動的に選択し、1 回のタスク内で複数回呼び出し、異なるプロバイダーを切り替えてより包括的な結果を取得できます。未指定の場合は `bocha → qianfan → zhipu → linkai` の順でフォールバックします。
+- `fixed`：`provider` で指定したプロバイダーに固定。該当プロバイダーの認証情報が欠けている場合は自動的に auto の順序にフォールバックします。
+
+## ツールパラメータ

 | パラメータ | 型 | 必須 | 説明 |
 | --- | --- | --- | --- |
 | `query` | string | はい | 検索キーワード |
-| `count` | integer | いいえ | 結果件数（1-50、デフォルト10） |
-| `freshness` | string | いいえ | 期間指定：`noLimit`、`oneDay`、`oneWeek`、`oneMonth`、`oneYear`、または `2025-01-01..2025-02-01` のような日付範囲 |
-| `summary` | boolean | いいえ | ページ要約を返す（デフォルトfalse） |
-
-## ユースケース
-
-ユーザーが最新情報について質問したり、事実確認やリアルタイムデータが必要な場合、AgentはこのToolを自動的に呼び出します。
+| `count` | integer | いいえ | 返却する結果数（1–50、デフォルト 10） |
+| `freshness` | string | いいえ | 期間指定：`noLimit`（デフォルト）、`oneDay`、`oneWeek`、`oneMonth`、`oneYear`、または `2025-01-01..2025-02-01` のような日付範囲 |
+| `summary` | boolean | いいえ | ページ要約を返すか（デフォルト false） |
+| `provider` | string | いいえ | `auto` 戦略で複数プロバイダーを設定している場合に表示。単回のプロバイダー切り替えに使用 |

 <Note>
-  検索APIキーが設定されていない場合、このToolは読み込まれません。
+  4 社の認証情報がいずれも未設定の場合、このツールは Agent に登録されません。
 </Note>