メインコンテンツにスキップ

Web アプリ

IaC Code には、ターミナルと同じエージェントエンジンを REPL ではなくブラウザ上で動かすローカル Web アプリが同梱されています。グラフィカルなチャット画面を好む場合、複数の会話を並べて管理したい場合、あるいはパイプラインの進捗やツールの動作をより見やすいレイアウトで確認したい場合に便利です。

Web アプリは CLI と同じセッションストアを読み書きするため、一方で開始した会話をもう一方で再開できます。

インストール​

Web アプリは http エクストラ（Starlette と Uvicorn）に依存するオプション機能です。基本パッケージと合わせてインストールしてください：

pip install 'iac-code[http]'

エクストラを入れずに iac-code web を実行すると、iac-code[http] のインストールを促すメッセージが表示されて失敗します。リポジトリをチェックアウトして開発する場合は、uv sync --extra http で同じ依存関係をインストールできます。

Web アプリの起動​

ターミナルからサーバーを起動します：

iac-code web

デフォルトでは 127.0.0.1:8766 にバインドし、既定のブラウザで http://127.0.0.1:8766 を開きます。

オプションデフォルト説明
--host127.0.0.1HTTP サーバーのホスト。ループバックアドレスのみ受け付けます。
--port8766HTTP サーバーのポート。
--open / --no-open--open起動時にブラウザを開きます。--no-open で無効化できます。
iac-code web --port 9000 --no-open

セキュリティ​

Web サーバーはループバックインターフェース（127.0.0.1、localhost、::1）にのみバインドします。自分のマシンでの利用を想定しており、公開バインドアドレスは拒否します。ネットワークへ直接公開しないでください。リモートアクセスが必要な場合は、認証付きの独自プロキシの背後に配置してください。

画面の概要​

セッションサイドバー​

サイドバーには、選択したプロジェクトの会話が一覧表示されます。ここから次の操作ができます：

  • 新規チャットを開始する、またはプロジェクトセレクターでプロジェクトを切り替える。
  • 会話を検索する、またはコマンドパレットを開いてコマンドを実行する。
  • 会話をピン留め、名前変更、アーカイブし、アーカイブ済みの会話を閲覧する。

セッションは CLI と共有されるため、iac-code --resume で再開した会話もここに表示されます。セッションストアの仕組みはセッションを参照してください。

コンポーザー​

コンポーザーはリクエストを入力する場所です。CLI がスラッシュコマンドやフラグで提供するのと同じコントロールを備えています：

  • アクティブなセッションのモデルとプロバイダーの選択。
  • 対応モデルで拡張推論を有効・無効にする思考トグル。
  • ツール操作の承認方法を決める権限モードのコントロール。
  • マルチモーダルモデル向けの画像添付。
  • ワークスペース内のファイルを指し示すスラッシュコマンド（/ で入力）と @ ファイル参照。

通常チャットとパイプラインモード​

セッションは通常チャットとして、またはパイプラインモードで動作します。通常チャットはアシスタントの返信、ツール呼び出し、結果をインラインでストリーミング表示します。パイプラインモードでは、パイプラインの実行に合わせてステップのタイムライン、診断、図、デプロイの進捗、クリーンアップ、引き継ぎの詳細を表示するワークスペースが追加されます。パイプラインの機能はパイプラインモードを参照してください。

ツールと承認​

ツール呼び出しはトランスクリプト内にカードとして表示されます。ツールが承認を必要とする場合、承認リクエストがインラインで表示されます。コンポーザーで設定した権限モードによって、確認を求められるタイミングが決まります。

設定​

設定エリアには、CLI が管理するのと同じ構成がまとめられています：

表示言語​

Web アプリは 7 つの言語 —— English、簡体中国語、日本語、Français、Deutsch、Español、Português —— に対応しており、設定から選択できます。選択内容は保存され、以降のセッションで使われます。

CLI との関係​

Web アプリは別製品ではなく、代替のフロントエンドです。ターミナルと同じプロバイダー、認証情報、スキル、ツール、セッションストレージを使用します。CLI の /auth または Web アプリの設定でプロバイダーと認証情報を一度構成すれば、両方のインターフェースがそれを共有します。