メインコンテンツまでスキップ

ツールセット

ツールセットは、関連するツールをまとめた名前付きグループです。Profile／セッションのグループ選択と親のアクセス制限が、利用対象の一覧を決めます。Sessionは別途、モデルに宣言するツールとCodemodeから呼べるツールを選びます。

組み込みの既定値​

組み込みで既定表示されるグループは次のとおりです。

ツールセット主な機能
artifactセッションファイルの一覧、確認、固定、エクスポート
web公開Webの検索と取得
sessionsProfileの過去のセッション検索
memoryProfileメモリ操作
tasks, automationタスク、リマインダー、予約作業
clarify不足入力に対する構造化質問
file, terminalファイルアクセスと直接コマンド実行
messagingChannelを認識するメッセージ操作
skillsProfileのSkillライブラリ管理。読み取りはread／bash
subagents委任、バックグラウンド作業、子の制御
ttsTTS設定時の音声返信

これらは利用対象の製品グループであり、全Sessionですべてのツールがアクティブである保証ではありません。移植可能な既定アクティブ名はread、bash、edit、writeで、製品ツールが独自の既定アクティブ項目を加える場合があります。実際のランタイムには追加グループがある場合があり、認証情報やバックエンドの利用可否でも制限されます。

カタログを確認する​

Dashboard → Tools → Built-inは各ツールのソース、ツールセット、ネイティブ定義、ランタイム制限を表示します。行を開くと定義、タイムアウト、出力予算を確認できます。これは一覧であり、現在Sessionのアクティブ宣言ではありません。定義は読み取り専用です。CodemodeにはProfile既定値と明示選択Session用の専用設定ページがあり、汎用的なツール別上書きエディターではありません。

Dashboardには「既定ツールセットをすべて切り替える」汎用エディターはありません。対応する任意機能が製品グループを更新します。MCP設定はこれらのグループから独立しています。

Sessionのツール選択​

会話ツールのフラグでSessionの選択を変えます。

anyy --tools '+codemode,+tool_search'
anyy --resume SESSION_ID --tools '+codemode,+tool_search'
anyy chat --session SESSION_ID --tools 'read,bash' "Inspect the project"

新SessionはProfile既定値と指定フラグから開始します。+nameと-nameは既定値を変え、再開Sessionの現在アクティブなツールセットを変えるものではありません。上の--resume例は、既存Sessionが待機中で保留入力なしならCodemodeを有効化でき、新Sessionは不要です。上書きなしなら、ライブSessionは現在の選択を保持します。他のアクティブ名や規則を維持してCodemodeだけ変えるには、CLI選択を再適用せずDashboard設定を使います。

フラグのツール選択規則はライブSessionに留まります。Profileのconfig.yamlを変えず、Gateway再起動を越えて保持されません。以前記録したアクティブ名が、現在のProfile規則に従って選択分岐から復元される場合があります。同じ包含、除外、no-tools規則が必要なら、待機時の明示的な接続を再び行います。

ツール選択は親、actor／session、配信の範囲を広げられません。保存済みスキーマ／名前一覧は履歴上の証拠であり、新規登録・再定義ハンドルに対する重複した制限ゲートではありません。

codemodeは現在Sessionの呼び出し可能ツールで生のJavaScriptを実行します。tool_searchは非アクティブなcodemode／deferredツールを見つけ、次のモデル要求用に有効化します。両方とも組み込みでは非アクティブ登録で、明示選択や適用されるMCP自動有効化で使えます。独立しているため、Codemodeを変えてもツール検索やSessionのRoleは変わりません。

Dashboard → Tools → Built-in → codemodeでProfile既定値と共有のon／onlyモードを保存します。保存すると再起動なしに次の準備へ設定を公開します。既存Sessionは再選択しません。対象Sessionを別途選び、待機中で保留入力なしのときにApply to Sessionを使います。Codemode設定で制限と両操作の違いを説明しています。

Profileのconfig.yamlを手動編集する方法もあります。例：

default_tools:
  - "+codemode"
  - "+tool_search"
codemode:
  mode: on

codemode.modeは、すでにアクティブなCodemode Sessionでのツール表示を制御し、有効化スイッチではありません。onは直接宣言を維持します。onlyは呼び出し可能な直接宣言を要求から隠しますが、Codemodeからは利用可能で、正規宣言は記録に残ります。Codemode専用のCLIフラグやRole設定はありません。

手動編集後はGateway再起動かCodemode設定ページの明示保存で、保存値を公開します。プロバイダー再読み込みではツール設定を公開しません。ページは未適用の保存値を区別します。共有モード変更は次の準備から反映し、Profileの有効化既定値を変えても既存Sessionの選択は維持します。Session Applyは現在の規則の下でCodemodeだけを変えるため、Profileの既定値で有効にしても、制限済み既存Sessionでは有効化を拒否する場合があります。

ツールの公開方式と製品グループは別です。

公開方式Sessionの動作
directアクティブ時に呼び出し可能。通常は直接宣言
codemode, deferred直接宣言を必要とせず登録一覧から呼び出し可能
model-only宣言できるがスクリプトからは呼べない
hidden宣言も呼び出しも不可

有効なMCPサーバーは、サーバーのexposureと順序付きtoolExposureに従ってネイティブツールを供給します。mcp-NAME製品ツールセットや包含リストの有効化ゲートは不要です。適用されるMCP設定でCodemodeが自動有効化される場合も、明示除外が優先します。Codemode無効時も、許可されたアクティブなツール検索は間接MCPツールを検出できます。MCPサーバーを参照してください。

サンドボックスは最初の実行時に読み込まれ、制限時間には読み込みとVM起動を含みます。コンパイル済みコードはAnyyプロセス内で再利用でき、各実行は専用のJavaScript VMとグローバルを持ちます。読み込み失敗は後の呼び出しで再試行でき、読み込み中の呼び出しをキャンセルしても別呼び出しの読み込みはキャンセルしません。このサンドボックスにNode.jsのインストールは不要です。

成功したスクリプトが保存する値は選択会話分岐に属し、DBを開き直しても読めます。タイムアウトしたスクリプトは一部出力とエラーを保持し、未確定値変更を破棄します。出力短縮時の全文パスは後からreadのoffsetとlimitで読めます。スクリプト失敗で完了済みツールの作用は戻りません。API、上限、例はCodemode、検出入力はツール検索を参照してください。

セッションとSkill​

セッションには明示的なツールセット選択を持たせられます。現在の実装では、Profile既定値を使い続けるセッションで、有効Skillが追加グループを要求できます。明示的なターン選択や意図的に絞ったセッション選択が優先します。子は親の許可範囲を広げられません。

ターンに添付がある場合、モデルが範囲付きファイルにアクセスできるよう、そのターンにartifactグループを追加できます。

ツールの利用可否

有効ツールは直接実行されます。認証情報、OS権限、バックエンドの健全性、セッション範囲が操作の利用可否を決めます。ツールセットはモデルカタログを整理するものです。

トラブルシューティング​

症状確認する項目
設定ツールが見えない対象製品グループ、公開方式、Session選択
MCP接続済みだがツールがないサーバーの有効化／公開方式と、Codemodeかツール検索が有効か
子にツールがない親カタログまたは子のツールポリシーで許可されていない
ツール呼び出し失敗結果、認証情報、OS権限、バックエンド状態