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

エージェントツール

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

画像生成・編集

デプロイ名を設定すると 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 トークン)でコンテキスト 消費を抑えます。