Tools

ツールは、組み込み操作、MCPツール、Web検索、メディアバックエンドなど、作業中にAnyyが呼び出せる機能です。

Dashboard → Toolsを開くと、選択中のProfileからセッションに提供できる機能を確認できます。

ツールの分類

分類	管理する内容
Built-in	ローカルツールの定義とCodemode設定
MCP	有効なMCPサーバーから現在利用可能になっているツール
Image	画像理解・生成モデルのルート
Video	動画理解モデルのルート
Voice	音声合成と音声認識のルート
Web Search	最新の公開情報を検索するバックエンド

ツールを確認する

組み込みツールまたはMCPツールを選ぶと、次の情報を確認できます。

• ソースとツールセット
• 説明と入力スキーマ
• タイムアウト
• 表示用・保存用の出力上限

入力スキーマは、Anyyがツールを呼び出す際に従う仕様です。MCPツールの定義は、現在のサーバーカタログから取得します。公開するリモートツールは、MCPで管理してください。

ランタイムの情報

詳細ページには、現在のタイムアウトと、表示用／保存用の出力上限が表示されます。このページでは、ツールの説明、スキーマ、リソース設定は読み取り専用です。定義はツール実装またはMCPサーバーカタログから取得します。表示対象は、機能バックエンド、MCPの選択、ツールセットを通じて設定します。

Codemodeの設定

Tools → Built-in → codemodeを開きます。Codemodeでは、モデルがJavaScriptを通じてSessionで利用可能なツールを呼び出せます。設定には、独立した二つのスコープがあります。

Profileの既定値

有効化設定と共通の呼び出しモードを選び、Saveを押します。

有効化	効果
Use current tool selection	既存の選択とMCPの自動有効化規則に従う。無効を意味するわけではない
Enable	ほかのツールを有効にせず、新しいSessionの既定選択にCodemodeを追加
Disable	新しいSessionの既定選択からCodemodeを明示的に除外

モード	Codemodeが有効な場合の動作
Direct calls and scripts (on)	スクリプトと併せて直接のツール呼び出しも保持
Concentrate calls in scripts (only)	スクリプトから呼べる直接の宣言を非表示にする。それらのツールはCodemodeから引き続き利用可能

モードはProfileで共有し、次のリクエスト準備時に適用します。準備済みのリクエストは変えません。有効化の既定値を保存しても、既存Sessionのツールを選び直すことはありません。ページにはAppliedまたはSaved, not yet appliedが表示されます。外部から設定を編集した後は、このページで明示的に保存するか、Gatewayを再起動してください。プロバイダーの再読み込みでは、ツール設定は適用されません。

ほかのツール規則や、より広い範囲の除外は引き続き適用されます。Codemodeだけを変更しようとして、ほかのツール規則も変わってしまう場合は保存を拒否し、元の設定を保持します。このページでCodemodeをRoleにしたり、一般のツール定義を編集したりすることはありません。

既存のSession

1. Session overrideでSessionを選び、状態を確認します。
2. アイドル状態で、保留中の入力がないときに、EnableまたはDisableを選びます。
3. Apply to Sessionを選び、返された状態を確認します。

この操作は、Sessionのほかの有効なツールと選択規則を保持したまま、Codemodeだけを変更します。そのSessionの許可ツール一覧を広げることはできないため、Profileの既定値では有効でも、以前からある制限付きSessionでは有効化できない場合があります。処理中のSessionは、先にアイドル状態になる必要があります。Not loaded yetは、常駐ランタイムのツール状態をまだ観測していないことを示し、無効と確認できた状態ではありません。Session専用のモードはありません。ProfileのSaveとSessionのApplyは、独立した操作です。

MCPとツール検索

MCPの設定が許す場合、Codemodeを自動的に有効化できます。Use current tool selectionは、この動作を保持します。明示的な除外は引き続き適用されます。ツール検索は独立しています。Codemodeを無効にしてもMCPやツール検索は無効にならず、許可されている有効なツール検索から、間接的なMCPツールを検出できます。ページには、利用可能な場合にその残りの経路が表示されます。

CLIでの選択と手動設定は、ツールセットを参照してください。 スクリプトAPIはCodemode、検出と次のリクエストでの有効化はツール検索を参照してください。

機能バックエンドを設定する

機能カードでは、設定とヘルスチェックを行えます。

• Web Searchでは、プロバイダー、エンドポイント、認証情報を選び、検証します。
• Image, Video, and Voiceでは、モデル設定画面を使って、それぞれ専用のルートを設定します。

対応するCLI操作

設定済みの機能を一覧表示します。

anyy tools list

対話式の設定を実行するか、機能をProbeします。

anyy tools websearch
anyy tools image --probe
anyy tools image generation --probe
anyy tools video understanding --probe
anyy tools voice tts --probe
anyy tools voice stt --probe

ツールの表示対象

設定済みのバックエンドが、既存セッションに必ず表示されるとは限りません。ツールセットは、選択中のProfileとセッションのコンテキストに基づいて解決します。新しい機能を有効にした後は、バックエンドとSessionの選択を確認してください。Codemodeには、上記の明示的なSession操作を使います。Profileの既定値だけを変えても、既存Sessionは変わりません。

トラブルシューティング

問題	対処
ツールが一覧にあるのにセッションにない	機能バックエンドとツールセット設定を確認
MCPツールが見つからない	サーバーの有効化／公開方法とSessionの選択を確認し、必要に応じてサーバーをProbeまたは再読み込み
ツール出力が途中で切れる	続きを読むための案内に従う、inspectableな結果参照をtool_result_readで読む、または結果の範囲を狭めて依頼