エージェントツール

エージェントは組み込みツールを呼び出せます。どれを有効にするか、危険なものをどうゲートするかを制御できます。

画像生成・編集

デプロイ名を設定すると Azure OpenAI gpt-image-1.5 による生成・編集が有効になります（オプトインフラグ不要 -- 変数を設定すれば有効化）:

IMAGE_DEPLOYMENT_NAME=gpt-image-1.5

generate_image -- テキストから画像生成（サイズ・品質・形式・背景・枚数 1〜4 を設定可能）
edit_image -- セッション内の既存画像をテキストで編集
Canvas マスクエディタ -- 生成画像の Edit をクリックし、変更する領域を塗り（ブラシ S/M/L、消しゴム、取り消し/やり直し）、プロンプトを入力するとマスク部分だけを編集
画像はインライン表示され、再読込後も保持

天気

Open-Meteo（無料・API キー不要）による天気カードウィジェット。都市名をジオコーディングし、現在の天気や 7 日間予報を取得します。

コーディングツール

ワークスペースディレクトリに限定したファイル操作とシェル実行:

CODING_ENABLED=true
CODING_WORKSPACE_DIR=C:\path\to\workspace
# CODING_FILE_READ_MAX_BYTES=1048576   # 既定 1 MiB

file_read は出力を CODING_FILE_READ_MAX_BYTES で上限制御します。上限や行数制限に達すると、応答末尾に [TRUNCATED BY BYTES: ...] / [TRUNCATED BY LIMIT: ...] のマーカーが付き、offset=N でのページングをエージェントに伝えます。

ツール承認

破壊的なコーディングツールは、インラインの 承認 / 拒否 / このセッションで承認 で一時停止します。読み取り専用ツール（file_read, file_glob, file_grep）は承認不要です。

# auto（既定）  -> bash_execute + file_write をゲート
# always        -> 読み取り専用以外のすべてをゲート
# skip          -> 承認を無効化（自律実行）
TOOL_APPROVAL_MODE=auto
TOOL_APPROVAL_REQUIRE_LIST=bash_execute,file_write
TOOL_APPROVAL_TIMEOUT_SEC=300

TOOL_APPROVAL_MODE=skip の間、SPA は常時「Tool approval is DISABLED」バナーを表示します。ヘッドレスのレーン（OpenAI API、chatwalaau chat CLI、DevUI）は毎回自動承認し、承認ごとに WARNING を記録します。

会話の圧縮（compaction）

長いセッションはモデル呼び出しの前にメモリ内で圧縮され（ディスク上のセッション JSON は変更されません）、コンテキスト上限で失敗せずに応答を続けます:

# none | sliding-window（既定） | selective-tool-call | tool-result
COMPACTION_STRATEGY=sliding-window
COMPACTION_KEEP_LAST_GROUPS=4
COMPACTION_PRESERVE_SYSTEM=true

Background Responses

長時間処理（例: o3/o4-mini 推論）では BG ボタン（コンテキスト表示の左）を切り替えます。ChatInput の枠が青くなり、継続トークンがセッションに自動保存され、ページ再読込後も再開できます。環境変数は不要です。

プロンプトテンプレート

チャット画面からプロンプトを保存・再利用（JSON ファイルとして保存）:

TEMPLATES_DIR=.templates

+ メニュー -> Use template を開く、またはユーザーメッセージの FileText アイコンでテンプレート化します。Insert to Chat で入力欄に貼り付け、送信前に編集できます。

Agent Skills

Agent Skills 仕様に従う持ち運び可能なドメイン知識パッケージで、必要時にロードされます:

SKILLS_DIR=.skills

.skills/
  my-skill/
    SKILL.md       # 必須: 指示 + メタデータ
    scripts/       # 任意: 実行コード
    references/    # 任意: ドキュメント
    assets/        # 任意: テンプレート, リソース

Skills は 段階的開示（アイドル時は 1 スキルあたり約 100 トークン）でコンテキスト消費を抑えます。

画像生成・編集​

天気​

コーディングツール​

ツール承認​

会話の圧縮（compaction）​

Background Responses​

プロンプトテンプレート​

Agent Skills​