AIエージェントの使い方

AIエージェントはCTORの中核です。チャットインターフェースを通じて、ファイルの読み書き、コードの編集、シェルコマンドの実行、プロジェクトの検索が行えます。 このページはプロジェクトセッション——単一のBRICKSアプリにスコープされたセッション——を扱います。新しいプロジェクトの作成などワークスペースレベルのワークフローについては、チャットを始めるを参照してください。

​

セッションを作成する

1. サイドバーでアプリを選択する
2. 新しいセッションをクリックする

セッションは永続的に保存され、最初のメッセージに基づいて自動的にタイトルが付けられます。各セッションは独自の会話履歴とモデル選択を保持します。

​

モデルを選択する

入力バーのモデルセレクターをクリックしてAIモデルを選択します。モデルはプロバイダー別にグループ化されています：

• Anthropic — Claude Sonnet 4.6、Claude Opus 4.6、Claude Haiku 4.5
• OpenAI — GPT-5.3 Codex、GPT-5.2 Codex、GPT-5.2、GPT-5.1 Codex Mini
• OpenAI Codex — GPT-5.3 Codex、GPT-5.2 Codex
• Google — Gemini 3 Flash、Gemini 3 Pro
• GitHub Copilot — 各プロバイダーからの複数のモデル
• OpenAI Compatible エンドポイント — エンドポイントごとのモデルリストを持つカスタムエンドポイント（Ollama、vLLM、LM Studioなど）

API キーが設定されているプロバイダーのみリストに表示されます。API キーの設定については設定を参照してください。

​

思考レベルを設定する

モデルセレクターの横にある思考セレクターをクリックして、エージェントの推論の深さを制御します：

​

メッセージを送信する

入力バーにメッセージを入力し、Ctrl+Enterを押します（または送信ボタンをクリック）。改行にはShift+Enterを使用します。 エージェントはリアルタイムでレスポンスをストリーミングします。以下が表示されます：

• テキストレスポンス — 完全なMarkdownレンダリングとシンタックスハイライト付き
• 思考ブロック — モデルの推論プロセスを表示（展開可能、思考内容を表示が必要）
• ツール呼び出し — ツール名と引数を表示する展開可能なブロック
• ツール結果 — 各ツール実行の出力を表示

実行中のレスポンスをいつでも停止するには中止をクリックします。

​

ファイルをメンション

入力バーで @ を入力して、プロジェクト内のファイルを検索します。ファイルを選択すると、そのパスがメッセージに含まれ、エージェントがどのファイルを扱うかわかります。

• フォルダー名の後に / を入力するとディレクトリを閲覧できる
• 矢印キーでナビゲートし、EnterまたはTabで選択する
• 最大20件の結果が表示される

​

スキルを使用する

入力バーで / を入力してスキルコマンドのオートコンプリートをトリガーします。スキルを選択すると、メッセージに /skill-name の参照が挿入されます。 選択したスキルは入力バーに削除可能なピルとして表示されます。参照は通常のテキストとして送信され、エージェントはスキルの説明とリクエスト内容に基づいて、スキルを読み込むかどうかを判断します。 スキルの作成と管理の詳細についてはスキルリファレンスを参照してください。

​

画像を添付する

画像添付ボタンをクリックするか、クリップボードから画像をペーストします。対応フォーマット：PNG、JPG、JPEG、WebP、GIF。 画像はbase64エンコードされたコンテンツとしてテキストメッセージと一緒にモデルに送信されます。 モデルが画像に対応していない場合は、設定でフォールバック画像認識モデルを指定してください。すると CTOR はそのモデルで各添付ファイルをテキストとして説明するため、画像非対応のモデルでも添付ボタンを引き続き使えます。

​

音声入力

メッセージを入力する代わりに音声で入力できます。まず 設定 > 詳細設定 > 実験的機能 で 音声入力 を有効にし、マイクへのアクセスを許可します。 有効にすると、入力バーにマイクボタンが表示されます：

• ボタンをクリックすると音声入力を開始し、もう一度クリックすると停止します。
• または、ボタンを長押しして音声入力し、離すと停止します。

音声はリアルタイムで入力バーに文字起こしされます。テキストを確認・編集してから、通常どおりメッセージを送信します。認識言語は設定の音声言語で選択します。変更しない場合はアプリの言語が使用されます。

​

音声エンジンを選ぶ

CTOR は次の 2 つのエンジンのいずれかで文字起こしします：

• Apple Speech — ダウンロード不要でデバイス上で動作します。macOS 26 以降が必要です。
• Whisper — macOS、Windows、Linux で動作します。同じくデバイス上で文字起こししますが、事前にランタイムとモデルをダウンロードします。

macOS 26 以降では両方を利用でき、設定の音声エンジンで選択できます。この環境でのデフォルトは Apple Speech です。それ以外のプラットフォームでは常に Whisper が使用されます。

​

Whisper をセットアップする

Whisper には 2 つのダウンロードが必要で、それぞれ 設定 > 詳細設定 > 実験的機能 に対応する項目があります：

1. Whisper ランタイム — 音声認識エンジンです。ダウンロードをクリックすると進捗バーが表示され、キャンセルで中止できます。準備が完了するとインストール済みと表示され、新しいランタイムが公開されると更新が表示されます。
2. モデルのダウンロード — Whisper モデルで選択したモデルファイルです。まずサイズを選びます：Tiny、Base、Small、Medium、Large v3 Turbo。大きいモデルほど精度は高くなりますが、動作は遅くなりディスク容量も多く必要です。デフォルトは Base です。

ダウンロードしたファイルは、インストール前に検証されます。ディスク容量を空けたい場合は、削除でどちらも削除できます。 Windows と Linux では、アクセラレーションでダウンロードする Whisper ビルドを選べます——Auto、CPU、Vulkan、CUDA。Auto はマシンが対応する最速の選択肢を検出し、選択肢に表示します。アクセラレーションビルドが正しく動作しない場合は CPU を選んでください。macOS のビルドは常に Metal を使用するため、この項目は表示されません。 ランタイムやモデルのインストール前にマイクボタンをクリックすると、CTOR がセットアップを完了するための設定を開くショートカットを表示します。 Whisper では、音声言語を**自動（検出）**に設定することもできます。特定の言語に固定せず、話している言語をその場で検出します。Apple Speech は具体的な言語を必要とするため、このオプションは Whisper の使用中のみ表示されます。

​

メッセージを確認する

設定 > 詳細設定 で メッセージボタンを表示 を有効にすると、入力バーに メッセージ ボタンが追加されます。クリックすると メッセージ詳細 パネルが開き、現在のセッションでモデルとやり取りされたメッセージが表示されます。パネルは メインエージェント タブと、アクティブなサブエージェントごとのタブに分かれています。 パネルのヘッダーにある Markdown または JSON ボタンでメッセージをエクスポートできます。CTOR がネイティブの保存ダイアログを開き、ファイルの書き込み先を選択できます。

​

ツール呼び出しと承認

エージェントには6つの組み込みツールがあります：read_file、write_file、edit_file、bash、glob、grep。 エージェントが bash コマンドを実行すると、承認プロンプトが表示されます：

• 実行をクリックするとコマンドを実行する
• 拒否をクリックすると実行を拒否する

MCPサーバーが設定されている場合、そのツールも組み込みツールとともにエージェントで利用できます。

​

TypeScript 言語サーバーツール

設定 > 詳細設定 > 実験的機能で Language Server Tools を有効にすると、プロジェクトごとに in-process の TypeScript 言語サービスがエージェントに提供されます。このトグルはデフォルトで無効です。有効にすると、エージェントは単一ファイルまたはプロジェクト全体の型・構文診断を取得したり、シンボルが定義されている場所にジャンプしたり、プロジェクト全体でその参照を一覧表示したりできます。 .ts、.tsx、.cts、.mts のソースに対して edit_file または write_file が実行されるたびに、CTOR は対象ファイルの診断も自動的に実行し、ツールブロックに結果を表示します：

• 折りたたまれたヘッダーにはエラー / 警告のカウントチップ（例：2 errors）が表示され、展開しなくても問題に気付けます
• 展開すると、差分の下に行ごとのリストとして L<line>:<col>、重大度、TS<code>、メッセージが並びます

エージェントもツール結果のテキストで同じ診断を読み取り、タスク完了を宣言する前にそれらを修正するよう指示されます。言語サービスはプロジェクト単位で、初回使用時に遅延生成され、tsconfig.json の変更時に再構築されます。トグルが無効のときは、編集と書き込みの結果は従来とバイト単位で同一です。

​

ウェブリサーチ

最新のドキュメント、ライブラリのバージョン、リリースノート、API、チャットに貼り付けたページなど、エージェントが持っている知識を超える質問に対して、エージェントはウェブを検索してページを読み取ることができます。 これは 2 つの機能で構成されます。

• ウェブ検索 — エージェントがリサーチのための質問を投げ、統合された回答とその根拠となった情報源を受け取ります。各結果には、実行された検索クエリと、引用された各ページのタイトルとドメインを含む番号付きの情報源リストが表示されます。
• URL の読み取り — エージェントは公開されている http(s) のページ（ドキュメントや PDF を含む）を最大 20 件まで読み取り、その内容から質問に回答します。検索で見つかった情報源を追跡したり、チャットに貼り付けたリンクを読み解いたりするのに使われます。ペイウォールの内側にあるページや自動読み取りをブロックするページは、呼び出し全体を失敗させるのではなく URL ごとに状態が報告されます。

リサーチは会話で使用しているモデルではなく、高速なモデルによる独立した呼び出しとして実行されます。そのため上位モデルでのセッションでも、検索ごとにそのモデルの料金を支払うことはありません。結果は読み取り専用のため承認を待つことはなく、プランモードでも利用できます。サブエージェントも両方の機能を継承します。 リクエストは BRICKS AI が処理します。会話が Vertex AI プロバイダーで実行されている場合は、お使いの Vertex AI プロジェクトが使用され、検索はそのプロジェクトに課金されます。一方の経路が利用できない場合、CTOR はもう一方にフォールバックします。どちらも設定されていない場合、これらの機能は提供されず、エージェントはそれなしで動作します。 無効にするには、設定 > 詳細設定のウェブ検索ツールを切り替えます。この設定はデフォルトで有効です。

​

Codemode

Codemode を使うと、エージェントはツールを 1 つずつ呼び出す代わりに、他のツールを呼び出す短い JavaScript プログラムを書けます。独立した呼び出しの並列実行、ある結果を次の呼び出しにつなぐ処理、大きな結果から必要な部分だけを取り出す処理に使われます。会話に届くのはスクリプトが出力した内容だけなので、大きなツール結果でコンテキストが埋まることはありません。 スクリプトは隔離されたサンドボックスで実行されます。スクリプト自体はファイルシステム、ネットワーク、タイマーを持たず、すべての操作はエージェントのツールを通じて行われます。そのため、コマンドの承認、プランモード、サンドボックスのルール、フックは、直接の呼び出しと同じように各呼び出しに適用されます。スクリプトでは次のこともできます：

• MCP サーバーのツールを呼び出す。エージェントがまだ会話に読み込んでいないツールも、検索してから呼び出せます
• 設定で構成したプロバイダーと API キーを使って、画像生成や分類器を実行する
• 小さな値を次のスクリプトのために保持する。保存した値は会話に紐づくため、セッションを巻き戻したりフォークしたりすると、値も巻き戻ります

一部のツールは、独自のターンが必要だったり別の作業を開始したりするため、スクリプトからは呼び出せません：あなたへの質問、プランの承認、サブエージェントの起動、他のセッションやスケジュールの管理です。 ツールブロックには、スクリプトと、そのスクリプトが行う呼び出しのライブリストが、それぞれのステータスと所要時間とともに表示されます。 Codemode はメインエージェント、プロジェクトのエージェント、サブエージェントで利用できます。エージェントファイルに tools リストがあるサブエージェントは、codemode がリストに含まれている場合にのみ利用できます。無効にするには、設定 > エージェントの Codemode を切り替えます。この設定はデフォルトで有効です。

​

ワークスペースプロファイル

サンドボックスモードセレクターの隣にあるピルは、エージェントが現在どのBRICKSワークスペースに対して動作しているかを示します。プロジェクトチャットではこのピルは読み取り専用で、CTORがプロジェクトの workspaceId を認証済みプロファイルのいずれかに照合し、一致するものがなければアクティブなプロファイルにフォールバックします。 別のワークスペースに対してエージェントを動かしたい場合は、プロジェクトを開く前に設定 → アカウントまたはメインチャットの入力バーからプロファイルを切り替えてください。

​

セッションをフォークする

最後のアシスタントメッセージの下部にある Fork をクリックすると、現在のセッションを新しいセッションに複製できます。CTOR は会話履歴全体をコピーし、タイトルに「 (fork)」を追加して、すぐに新しいセッションに切り替えます。 Forked from のディバイダーがコピーされた履歴と新しいメッセージの境界を示すため、サイドバーが折りたたまれていてもフォークの開始位置がわかります。 エージェントがストリーミング中またはツールの承認待ちの間は、このボタンは非表示になります——フォークは未完了のターンをキャプチャしてはなりません。 プロジェクトセッションとメインチャットセッションの両方で利用できます。

​

サブエージェント

エージェントは専門的なサブエージェントにタスクを委任できます。サブエージェントは焦点を絞ったツールセットと指示で動作するため、コードベースの探索やコードレビューなどのスコープを絞ったタスクに最適です。 サブエージェントは Plugins パネルの Agents タブから管理できます。作成と設定の詳細についてはplugins リファレンスとサブエージェントリファレンスを参照してください。

​

ローカルデバイス

入力バーのローカルデバイスボタンをクリックして、ローカルネットワーク上の BRICKS Foundation デバイスと BRICKS Buttress サーバーをスキャンします。ダイアログは両方のスキャンを並行して実行し、片方が失敗してももう片方の一覧は維持されます。 Foundation デバイス行はアドレス、バージョン、以下のバッジを表示します：

• このワークスペース — デバイスが現在のプロジェクトと同じワークスペースにバインドされている
• CDP — デバイスが Chrome DevTools Protocol をサポートしている
• Workspace 認証 — デバイスがワークスペース認証をサポートしている

CDP 対応の行には DevTools ボタンもあります。クリックすると、そのデバイスの Chrome DevTools インスペクタがパネルのタブとして開きます。デバイスのワークスペースにサインインしている場合、CTOR はワークスペース認証で自動的に DevTools を開きます。ワークスペース認証が利用できず、デバイスにパスコードが設定されている場合は、CTOR はパスコードの入力を求めます。どちらも利用できない場合、CTOR はデバイスにパスコードを設定するか、デバイスをワークスペースにサインインするよう案内します。そのデバイスが前面のプロジェクトの実行中のプレビューである場合、DevTools は代わりにシミュレータータブにドッキングされます。 Buttress サーバー行はバイオレットのアクセントカラーと専用バッジで表示されます：

• JWT required ／ open — サーバーがワークスペースにバインドされていて JWT が必要かどうか
• verified ／ UDP only — HTTP /buttress/info プローブが成功したか、UDP アナウンスのみが見えているか
• このワークスペース — サーバーが現在のプロジェクトと同じワークスペースにバインドされている

カードをクリックすると選択状態が切り替わります。複数選択をサポートしていますが、種類間は排他的です（Buttress サーバーを選ぶと Foundation の選択が解除され、その逆も同様）。 フッターの左側には常にデバイスパネルを開くボタンがあり、下部パネルにデバイスタブを開きます——このダイアログと同じワークスペースのデバイス一覧を、ダイアログを開いたままにしたり何かを選択したりせずに閲覧できます。 フッター右側のボタンは選択内容に応じて変わります：

• Foundation デバイス → 検査またはバインドで /bricks-cli プロンプトが挿入され、bricks-cli スキルが実行します。バインド は選択したデバイスにアプリを関連付け、最新のコンパイル済み設定を高速で配信します — 新しいリリースは作成しません。
• Buttress サーバー → エージェントに統合を依頼で /bricks-ctor プロンプトが挿入されます。プロンプトには選択した各サーバーの ID、ワークスペース一致状況、アナウンスされた generator 能力が含まれます。統合ルール（generator 種類ごとのモデル推奨、標準的な自動検出 buttressConnectionSettings、iOS シミュレーターでの注意点 — UDP 検出は実機でのみ機能） は bricks-ctor スキルが提供します。

​

次のステップ