本ページの調整値は .env ではなく、アプリ内の App Settings 画面(サイドバー下部の
スライダーアイコン)で設定し、app_settings.jsonc に保存されます。.env に残った値は
無視され、起動ログにキー名が 1 度だけ列挙されます。既存の設定を引き継ぐには
chatwalaau settings migrate --write を実行してください。機能の有効化ゲートと
シークレットは .env のままです。
詳細は 設定 -> アプリケーション設定。
エージェントツール
エージェントは組み込みツールを呼び出せます。どれを有効にするか、危険なものをどう ゲートするかを制御できます。
画像生成・編集
モデルオファリングカタログ(model_offerings.jsonc)に image オファリング を1つ
追加すると、Azure OpenAI Images API による生成・編集が有効になります。作成はアプリ内の
App Settings 画面、chatwalaau models add、または手動で行えます。推奨モデルは
GPT-Image-2.5-Sunburst(生成と精密な編集で最も高性能)です。model_ref には
お使いのデプロイ名を指定します:
{
"id": "image",
"provider": "azure-openai",
"operations": ["image"],
"model_ref": "gpt-image-2.5-sunburst",
"api_version": "preview"
}
- image_generate -- テキストから画像を生成(品質は
xhigh/maxまで、モデルの規則に 合う任意のサイズ、背景、1 回あたり 1〜10 枚。バリエーションか別々の絵のセット) - image_edit -- セッション内の既存画像を変更。最大 15 枚の画像を参考として、また任意で マスクを一緒に渡せます。チャットで「背景を海辺に変えて、商品の形とロゴはそのまま」の ように頼めます
- 画像編集画面 -- 画像の Edit をクリック(下記参照)
- 画像は常に PNG で、インライン表示され、再読込後も保持されます
image オファリングが無い場合、画像ツールは単に利用不可になります(アプリは通常どおり 起動)。オファリングを追加すると有効化されます。
ツール名は以前 generate_image / edit_image でした。宣言型エージェントや harness の
tools: に旧名が書かれていると、新しい名前を示す警告が表示され、修正するまで有効化され
ません。過去の会話の画像はそのまま表示されます。
バリエーションか、別々の絵のセットか(v0.223.0)
画像モデルは、1回のリクエストの画像をすべて同じ説明から描きます。そのため「1枚目、 2枚目、3枚目」を自分で描き分けることはできません。アシスタントは次のどちらかの形で 画像を頼みます。
- 1つの絵のバリエーション -- 「ダッシュボードを3案」なら、同じ画面の違う版を3枚
作ります(
n)。 - 別々の絵のセット -- 「日次ダッシュボード、例外一覧、月次報告を1枚ずつ」なら、
項目ごとに1枚作ります(
prompts)。共通のスタイル、配色、サイズは全部にかかり、 同時に作られ、画像ごとにキャプションが出ます。
1つのセットは合計10枚までです。セットの一部が失敗しても残りは表示され、どれが欠けた かをアシスタントが伝えます。依頼で絵を1つずつ挙げる(「1枚ずつ」)と、アシスタントが セットを選びやすくなります。
画像編集画面
画像の Edit をクリックすると、画像の一部または全体を変更できます。画面の大きさは App Settings と同じです。
- Mask タブ -- 変更してよい範囲を塗ります(ブラシ S/M/L、消しゴム)。同じ場所を何度 塗っても濃さは一定です。画像全体を変える場合は何も塗りません。画像の色と似ていて マスクが見づらいときは 、色を変え、不透明度(10〜90%)を調整できます。変わるのは 見た目だけで、編集される範囲は変わりません。
- Annotate タブ -- 矩形またはフリーハンドで印を描きます。印には A, B, C... の ラベルが付き、右側にメモ欄が 1 つずつ増えるので、領域ごとに何をするかを書けます。 マスクと印は 1 回の編集で一緒に使われます。
- Change / Preserve -- 「変更するもの」と「そのまま残すもの」を分けて書きます。例: Change: 背景だけ。Preserve: 商品の形・ロゴ・色。 どちらも複数行で、Enter で改行、 Ctrl+Enter で生成します。IME の変換確定で送信されることはありません。
- References -- 参考画像を 14 枚まで追加し、文章の中で Ref 1, Ref 2... と 呼べます。
- Quality / Background / Images -- この編集だけの値を選ぶか、Default (...) の ままにします。出力は元画像の形を保ちます。
Generate は画像 API を直接呼ぶので、どのエージェントやワークフローを選んでいても 動きます。送信したメッセージは、マスク付きプレビュー、注釈付き画像、参考画像の順ですぐに 表示されます。結果は通常の回答と同じく会話に保存されるので、続けてエージェントに手直しを 頼めます。
編集画面は状態を覚えています。同じ画像でもう一度 Edit を押すと、マスク・印・ 参考画像・文章が元どおりに表示されます。新しく生成された画像は新規の編集として開きます。 下書きはエクスポート / インポートとフォークでも引き継がれます。
画像出力のカスタマイズ
画像の既定値は 1 か所で設定します: App Settings -> Model Offering Catalog -> image オファリング -> Image output defaults。
| 項目 | 選択肢 | 既定値 |
|---|---|---|
| Size | 2048x1152 (16:9)、1920x1440 (4:3)、1024x1024 (1:1) | 2048x1152 |
| Quality | low、medium、high、xhigh、max | xhigh |
| Output Format | png(固定。画像編集には PNG が必要なため) | png |
| Background | opaque、transparent | opaque |
Default (...) のままの項目には、括弧内の値が使われます。ユーザーが会話の中で具体的な 値を求めた場合(「正方形にして」「背景を透明に」など)、その依頼ではモデルが渡す値が 優先されます。デプロイが拒否したと分かった値は not supported と表示され、選べません。
xhigh と max は時間と費用がかかります。2560x1440 を超えるサイズは実験的です。透過に
対応しているかはデプロイによります。一度拒否されるとアプリがそれを覚え、選択肢を無効に
します。
model_offerings.jsonc での指定:
{
"id": "image",
"provider": "azure-openai",
"operations": ["image"],
"model_ref": "gpt-image-2.5-sunburst",
"api_version": "preview",
"image_defaults": {
"size": "2048x1152", // 任意の WxH: 両辺 16 の倍数、1:3〜3:1、長辺 3840 以下
"quality": "xhigh", // low | medium | high | xhigh | max
"background": "opaque" // opaque | transparent
}
}
Built-in エージェント カードの Image output 欄はなくなり、Format / Compression
の項目と auto の値も廃止されました。format・compression・auto を含む古いファイルも
読み込めます。それらはログに通知を出して無視されます。
画像モデルが別の Images API バージョンを必要とする場合は、オファリングの api_version を
お使いの Azure デプロイが対応するバージョンに設定してください(preview は v1 の
エンドポイントを選びます)。
型付きの判定(Microsoft-Decision-1)
v0.195.0 の新機能。 Microsoft-Decision-1 は、分類・振り分け・可否判定・採点のための Microsoft Foundry のモデルです。文章は書きません。入力と型付きの質問を渡すと、確率を返します。高速かつ安価です(課金は入力トークンのみ)。
有効にするには、Foundry リソースに Microsoft-Decision-1 をデプロイし、App Settings > Model Offering
Catalog > Decision で decision offering を 1 つ追加します(chatwalaau models add --operation decision でも可)。
{
"id": "decision-1",
"provider": "azure-openai",
"model_ref": "microsoft-decision-1", // デプロイ名
"endpoint": "https://my-foundry.services.ai.azure.com", // 任意: Foundry リソース
"operations": ["decision"]
}
- decision offering は 1 つまでです。ほかの操作とは兼用できず、
azure-openaiプロバイダを使います。 認証はapi_key_envがあればそれを、なければ共通の Azure 認証を使います。 endpointを省略するとAZURE_OPENAI_ENDPOINTを使います。呼び出しが not found になる場合は、 モデルをデプロイした Foundry リソースのエ ンドポイントを設定してください。
すべてのエージェントが decision_evaluate を使えるようになります。1 回の呼び出しで、1 つの入力
(state:テキストか JSON オブジェクト)に対して 1 つ以上の質問をします。3 つの型は組み合わせられます。
| 型 | 質問 | 結果 |
|---|---|---|
noul | 正しいか?(yes / no) | true である確率 |
choice | どれに当たるか?(criteria: {ラベル: 説明}) | 選ばれたラベルと、選択肢ごとの確率 |
score | どの程度か?(criteria: 低い順の段階) | スコア、最も近い段階とそのラベル |
たとえば、サポートメールを 3 つの質問でまとめて仕分けます。
{
"urgency": {"type": "noul", "instructions": "Does the customer need urgent help?"},
"team": {"type": "choice", "instructions": "Which team should handle the request?",
"criteria": {"billing": "Payment and invoice issues",
"technical": "Software and integration issues"}},
"priority": {"type": "score", "instructions": "How high is the priority of this request?",
"criteria": ["Routine, no time pressure", "Important, some time pressure",
"Urgent, immediate attention needed"]}
}
チャットで「この 3 通のサポートメールを、担当チームと緊急度で仕分けて」のように頼みます。呼び出しは Evaluating decisions と表示され、回答はチャット内の表(質問、回答、確率、ほかの選択肢)で示されます。 確率が 60% 未満の回答には uncertain が付きます。
- 呼び出しは送信前に検証されます。規則に反する質問は問題の一覧としてエージェントに返り、課金は発生しません。
bool、boolean、yes_noはnoulとして扱います。 - 上限は App Settings > Decision で設定します:1 回の質問数(20)、choice の選択肢数(50)、 score の段階数(11)、入力の大きさ(100,000 文字)。
- 呼び出しごとに トークン使用量の記録へ Helper レコード(purpose
decision_evaluate)が 1 件追加されます。 - カスタム Prompt エージェントやハーネスでも、このツール(カテゴリー decision)を選べます。
- v0.220.0 から、同じ決定モデルで
/v1/responsesの文書相談窓口の質問を振り分けられます("route": "auto")。 choice の質問1つで業務分野を選び、その分野の文書だけを検索します。 質問の振り分け を参照してください。 この呼び出しは、呼び出し元の API キーの利用として記録されます(目的responses_route)。 - 理由は返りません(数値だけです)。確率は判断の材料として使い、質問はお手元の例で検証してください。 人に関わる判断(与信、雇用、住宅、医療、法律)の唯一の根拠にはしないでください。
天気
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 でのページングをエージェントに伝えます。
1 つのターンで複数のツールを同時に呼んだ場合、すべての結果が返ります (v0.147.0)。それ以前は、並列ツール呼び出しの結果がブラウザへ渡る途中で 1 つの メッセージにまとめられ、最後の 1 件しか残りませんでした。そのため、正常に実行された ツールが「何も返さなかった」ように見えることがありました。欠落は転送の途中で起きて おり保存内容には影響しないため、過去のチャットに修復は不要です。
受け取るファイル(v0.152.0)。エージェントがファイルを作成すると、ワークスペースに
保存し、回答内で [report.pdf](workspace:output/report.pdf) のようにリンクし ます。
チャットはこのリンクを ダウンロード(PDF と画像は 開く も)付きのファイル操作要素として
表示します。ダウンロードには File Explorer
の有効化(FILE_EXPLORER_ENABLED=true)が必要です。無効の場合は、利用できない理由が表示されます。
アシスタントが生成した画像はチャットに残ります
アシスタントに生成してもらった画像は、ワークスペースのファイルではありません。会話と一緒に
保存され、その場でチャットに表示されます。そのためアシスタントは、その画像をワークスペースへ
コピーしたり、ダウンロードリンクを付けたりしません。保存するときは、画像そのものから行って
ください(右クリック、または画像の操作メニュー)。上記の workspace: リンクが付くのは、
アシスタントがコーディングツールやスキルで作成したファイルだけです。コードが描いたグラフ
などの画像も、こちらに含まれます。v0.158.1 より前は、生成した画像もワークスペースへコピーされ、
余計なコマンド実行と不要なコピーが発生していました。
Computer Use(Windows)
自分の Windows マシンで COMPUTER_USE_ENABLED=true にすると、エージェントはデスクトップアプリを
見て操作することもできます。1 回の判断でクリックと入力をまとめて実行し、固定の待ち時間ではなく
画面が落ち着くのを待ち、Ctrl+Alt+End やマウス操作で止まります(v0.170.0)。
詳しくは Computer Use を参照してください。
CodeAct: 計算用サンドボックス
モデルは桁の多い計算、日付の差、正規表現を推測で答えがちです。App Settings > CodeAct を ON に
すると(v0.172.0)、すべてのエージェントにツール execute_code が 1 つ加わります。短い Python の
断片を隔離されたワーカープロセスで実行し、print した内容と最後の式の値を返します。
import datetime
(datetime.date(2026, 12, 25) - datetime.date(2026, 9, 26)).days # -> 90
- 用途: 正確な算術、日付と期間、単位換算、件数の集計、手元のデータの並べ替えと集約、JSON の組み替え、 正規表現。
- マシンには何も届きません。 サンドボックスにはファイルもネットワークも OS へのアクセ スも、他のツールも ありません。エージェントは他のツールをいつもどおり直接呼び、その結果をコードに書き込みます。
- Python のサブセットです。
json、re、math、datetime、collections、itertools、base64、dataclasses、random、time、hashlib、decimalが使えます。statisticsとcsvは使えず、sleep もできません。変数は呼び出しをまたいで残りません。 - 上限があります。 1 回の実行は 10 秒 または 64 MB で止まります(同じグループで調整できます: 1〜60 秒、32〜1024 MB)。同時に実行されるのは 1 件だけで、サーバー上の他のチャットを止めることは ありません。
- どこでも使えます。 どのモデルプロバイダーでも同じように動き、Core / Custom エージェント、ワークフローの Prompt ノード、Live の委任、OpenAI 互換 API、Teams、スケジュール、Harness エージェント で使えます。既定は OFF で、デモモードでは提供されません。
- モデルごと: 関数呼び出しが弱いモデルでは、offering の CodeAct 機能を Not available にします (デプロイメントの機能)。
呼び出しは 1 件ずつツールカード(Running code... / Ran code)で表示され、展開するとコードと結果を 確認できます。