> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.
# AIエージェントの使い方
> AIとチャットしてBRICKSアプリケーションをビルドする
AIエージェントはCTORの中核です。チャットインターフェースを通じて、ファイルの読み書き、コードの編集、シェルコマンドの実行、プロジェクトの検索が行えます。
このページは**プロジェクトセッション**——単一のBRICKSアプリにスコープされたセッション——を扱います。新しいプロジェクトの作成などワークスペースレベルのワークフローについては、[チャットを始める](/ja/ctor/guide/main-chat)を参照してください。
## セッションを作成する
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 キーの設定については[設定](/ja/ctor/reference/settings)を参照してください。
## 思考レベルを設定する
モデルセレクターの横にある**思考セレクター**をクリックして、エージェントの推論の深さを制御します：
| レベル | バジェット | ユースケース |
| --- | ---------- | ---------------------- |
| オフ | — | 素早いレスポンス、シンプルなタスク |
| 高 | \~16k トークン | ほとんどのタスク、速度と深さのバランスが良い |
| 最大 | \~32k トークン | 複雑な推論、アーキテクチャの決定 |
**最大**の思考は、拡張思考をサポートするモデルでのみ利用可能です：Claude Opus 4.6、GPT-5.3 Codex、GPT-5.2 Codex、GPT-5.2。
## メッセージを送信する
入力バーにメッセージを入力し、**Ctrl+Enter**を押します（または送信ボタンをクリック）。改行には**Shift+Enter**を使用します。
エージェントはリアルタイムでレスポンスをストリーミングします。以下が表示されます：
* **テキストレスポンス** — 完全なMarkdownレンダリングとシンタックスハイライト付き
* **思考ブロック** — モデルの推論プロセスを表示（展開可能、[思考内容を表示](/ja/ctor/reference/settings#advanced)が必要）
* **ツール呼び出し** — ツール名と引数を表示する展開可能なブロック
* **ツール結果** — 各ツール実行の出力を表示
実行中のレスポンスをいつでも停止するには**中止**をクリックします。
## ファイルをメンション
入力バーで `@` を入力して、プロジェクト内のファイルを検索します。ファイルを選択すると、そのパスがメッセージに含まれ、エージェントがどのファイルを扱うかわかります。
* フォルダー名の後に `/` を入力するとディレクトリを閲覧できる
* 矢印キーでナビゲートし、**Enter**または**Tab**で選択する
* 最大20件の結果が表示される
## スキルを使用する
入力バーで `/` を入力してスキルコマンドのオートコンプリートをトリガーします。スキルを選択すると、メッセージに `/skill-name` の参照が挿入されます。
選択したスキルは入力バーに削除可能なピルとして表示されます。参照は通常のテキストとして送信され、エージェントはスキルの説明とリクエスト内容に基づいて、スキルを読み込むかどうかを判断します。
スキルの作成と管理の詳細については[スキルリファレンス](/ja/ctor/reference/skills)を参照してください。
## 画像を添付する
画像添付ボタンをクリックするか、クリップボードから画像をペーストします。対応フォーマット：PNG、JPG、JPEG、WebP、GIF。
画像はbase64エンコードされたコンテンツとしてテキストメッセージと一緒にモデルに送信されます。
モデルが画像に対応していない場合は、設定で[フォールバック画像認識モデル](/ja/ctor/reference/settings#フォールバック画像認識モデル)を指定してください。すると CTOR はそのモデルで各添付ファイルをテキストとして説明するため、画像非対応のモデルでも添付ボタンを引き続き使えます。
## 音声入力
メッセージを入力する代わりに音声で入力できます。まず [**設定** > **詳細設定** > **実験的機能**](/ja/ctor/reference/settings#実験的機能) で **音声入力** を有効にします。この機能は Apple Speech を使用するため、macOS 26 以降とマイクへのアクセスが必要です。トグルとボタンは対応している Mac でのみ表示されます。
有効にすると、入力バーにマイクボタンが表示されます：
* ボタンを**クリック**すると音声入力を開始し、もう一度クリックすると停止します。
* または、ボタンを**長押し**して音声入力し、離すと停止します。
音声はリアルタイムで入力バーに文字起こしされます。テキストを確認・編集してから、通常どおりメッセージを送信します。認識言語は設定の**音声言語**で選択します。変更しない場合はアプリの言語が使用されます。
## メッセージを確認する
[**設定** > **詳細設定**](/ja/ctor/reference/settings#詳細設定) で **メッセージボタンを表示** を有効にすると、入力バーに **メッセージ** ボタンが追加されます。クリックすると **メッセージ詳細** パネルが開き、現在のセッションでモデルとやり取りされたメッセージが表示されます。パネルは **メインエージェント** タブと、アクティブな[サブエージェント](#サブエージェント)ごとのタブに分かれています。
パネルのヘッダーにある **Markdown** または **JSON** ボタンでメッセージをエクスポートできます。CTOR がネイティブの保存ダイアログを開き、ファイルの書き込み先を選択できます。
## ツール呼び出しと承認
エージェントには6つの組み込みツールがあります：`read_file`、`write_file`、`edit_file`、`bash`、`glob`、`grep`。
エージェントが `bash` コマンドを実行すると、承認プロンプトが表示されます：
* **実行**をクリックするとコマンドを実行する
* **拒否**をクリックすると実行を拒否する
**設定** > **エージェント**で**bashコマンドを自動承認**を有効にすると、すべてのbashコマンドの承認プロンプトをスキップできます。
[危険なパターン](/ja/ctor/reference/sandbox#危険なコマンドの検出)に一致するコマンド——`sudo`、`rm -rf`、履歴を書き換える `git`、`curl ... | sh` など——は、自動承認が有効な場合やプロジェクトがサンドボックス化されている場合でも、常に赤い枠線と**危険なコマンド**ラベル付きのプロンプトが表示されます。
[MCPサーバー](/ja/ctor/reference/mcp)が設定されている場合、そのツールも組み込みツールとともにエージェントで利用できます。
## TypeScript 言語サーバーツール
[**設定** > **詳細設定** > **実験的機能**](/ja/ctor/reference/settings#実験的機能)で **Language Server Tools** を有効にすると、プロジェクトごとに in-process の TypeScript 言語サービスがエージェントに提供されます。このトグルはデフォルトで無効です。有効にすると、エージェントは単一ファイルまたはプロジェクト全体の型・構文診断を取得したり、シンボルが定義されている場所にジャンプしたり、プロジェクト全体でその参照を一覧表示したりできます。
`.ts`、`.tsx`、`.cts`、`.mts` のソースに対して `edit_file` または `write_file` が実行されるたびに、CTOR は対象ファイルの診断も自動的に実行し、ツールブロックに結果を表示します：
* 折りたたまれたヘッダーには**エラー / 警告のカウントチップ**（例：`2 errors`）が表示され、展開しなくても問題に気付けます
* 展開すると、差分の下に**行ごとのリスト**として `L:`、重大度、`TS`、メッセージが並びます
エージェントもツール結果のテキストで同じ診断を読み取り、タスク完了を宣言する前にそれらを修正するよう指示されます。言語サービスはプロジェクト単位で、初回使用時に遅延生成され、`tsconfig.json` の変更時に再構築されます。トグルが無効のときは、編集と書き込みの結果は従来とバイト単位で同一です。
## ワークスペースプロファイル
[サンドボックスモード](/ja/ctor/reference/sandbox)セレクターの隣にあるピルは、エージェントが現在どのBRICKSワークスペースに対して動作しているかを示します。プロジェクトチャットではこのピルは読み取り専用で、CTORがプロジェクトの `workspaceId` を認証済み[プロファイル](/ja/ctor/guide/authentication#マルチプロファイルサポート)のいずれかに照合し、一致するものがなければアクティブなプロファイルにフォールバックします。
別のワークスペースに対してエージェントを動かしたい場合は、プロジェクトを開く前に**設定 → アカウント**または[メインチャット](/ja/ctor/guide/main-chat#ワークスペースプロファイルの切り替え)の入力バーからプロファイルを切り替えてください。
## セッションをフォークする
最後のアシスタントメッセージの下部にある **Fork** をクリックすると、現在のセッションを新しいセッションに複製できます。CTOR は会話履歴全体をコピーし、タイトルに「 (fork)」を追加して、すぐに新しいセッションに切り替えます。
**Forked from {title}** のディバイダーがコピーされた履歴と新しいメッセージの境界を示すため、サイドバーが折りたたまれていてもフォークの開始位置がわかります。
エージェントがストリーミング中またはツールの承認待ちの間は、このボタンは非表示になります——フォークは未完了のターンをキャプチャしてはなりません。
プロジェクトセッションとメインチャットセッションの両方で利用できます。
## サブエージェント
エージェントは専門的なサブエージェントにタスクを委任できます。サブエージェントは焦点を絞ったツールセットと指示で動作するため、コードベースの探索やコードレビューなどのスコープを絞ったタスクに最適です。
サブエージェントはサイドバーから管理できます。作成と設定の詳細については[サブエージェントリファレンス](/ja/ctor/reference/sub-agents)を参照してください。
## ローカルデバイス
入力バーの**ローカルデバイス**ボタンをクリックして、ローカルネットワーク上の [BRICKS Foundation](/ja/foundation) デバイスと [BRICKS Buttress](/ja/buttress) サーバーをスキャンします。ダイアログは両方のスキャンを並行して実行し、片方が失敗してももう片方の一覧は維持されます。
Foundation デバイス行はアドレス、バージョン、以下のバッジを表示します：
* **このワークスペース** — デバイスが現在のプロジェクトと同じワークスペースにバインドされている
* **CDP** — デバイスが Chrome DevTools Protocol をサポートしている
CDP 対応の行には **DevTools** ボタンもあります。クリックすると、そのデバイスの Chrome DevTools インスペクタが[右パネル](/ja/ctor/reference/right-panel#devtools)のタブとして開きます——プロンプトが表示されたら、まずデバイスのパスコードを入力してください。そのデバイスが前面のプロジェクトの実行中のプレビューである場合、DevTools は代わりに[プレビュータブ](/ja/ctor/reference/preview#プレビューの-devtools-をドッキング)にドッキングされます。
Buttress サーバー行はバイオレットのアクセントカラーと専用バッジで表示されます：
* **JWT required** ／ **open** — サーバーがワークスペースにバインドされていて JWT が必要かどうか
* **verified** ／ **UDP only** — HTTP `/buttress/info` プローブが成功したか、UDP アナウンスのみが見えているか
* **このワークスペース** — サーバーが現在のプロジェクトと同じワークスペースにバインドされている
カードをクリックすると選択状態が切り替わります。複数選択をサポートしていますが、種類間は排他的です（Buttress サーバーを選ぶと Foundation の選択が解除され、その逆も同様）。
フッターボタンは選択内容に応じて変わります：
* **Foundation デバイス** → **検査**または**バインド**で `/bricks-cli` プロンプトが挿入され、[bricks-cli スキル](/ja/ctor/reference/skills#bricks-cli)が実行します。**バインド** は選択したデバイスにアプリを関連付け、最新のコンパイル済み設定を高速で配信します — 新しいリリースは作成しません。
* **Buttress サーバー** → **エージェントに統合を依頼**で `/bricks-ctor` プロンプトが挿入されます。プロンプトには選択した各サーバーの ID、ワークスペース一致状況、アナウンスされた generator 能力が含まれます。統合ルール（generator 種類ごとのモデル推奨、標準的な自動検出 `buttressConnectionSettings`、iOS シミュレーターでの注意点 — UDP 検出は実機でのみ機能） は [bricks-ctor スキル](/ja/ctor-pkg/skills)が提供します。
## 次のステップ
アプリケーションをBRICKSサーバーにリリースします。