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 はそのモデルで各添付ファイルをテキストとして説明するため、画像非対応のモデルでも添付ボタンを引き続き使えます。

​

音声入力

メッセージを入力する代わりに音声で入力できます。まず 設定 > 詳細設定 > 実験的機能 で 音声入力 を有効にします。この機能は Apple Speech を使用するため、macOS 26 以降とマイクへのアクセスが必要です。トグルとボタンは対応している Mac でのみ表示されます。 有効にすると、入力バーにマイクボタンが表示されます：

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

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

​

メッセージを確認する

設定 > 詳細設定 で メッセージボタンを表示 を有効にすると、入力バーに メッセージ ボタンが追加されます。クリックすると メッセージ詳細 パネルが開き、現在のセッションでモデルとやり取りされたメッセージが表示されます。パネルは メインエージェント タブと、アクティブなサブエージェントごとのタブに分かれています。 パネルのヘッダーにある 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 の変更時に再構築されます。トグルが無効のときは、編集と書き込みの結果は従来とバイト単位で同一です。

​

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

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

​

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

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

​

サブエージェント

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

​

ローカルデバイス

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

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

CDP 対応の行には DevTools ボタンもあります。クリックすると、そのデバイスの Chrome DevTools インスペクタが右パネルのタブとして開きます——プロンプトが表示されたら、まずデバイスのパスコードを入力してください。そのデバイスが前面のプロジェクトの実行中のプレビューである場合、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 スキルが提供します。

​

次のステップ