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

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エージェントは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 キーの設定については設定を参照してください。

​
思考レベルを設定する

モデルセレクターの横にある思考セレクターをクリックして、エージェントの推論の深さを制御します：
レベルバジェットユースケース
オフ—素早いレスポンス、シンプルなタスク
高~16k トークンほとんどのタスク、速度と深さのバランスが良い
最大~32k トークン複雑な推論、アーキテクチャの決定
最大の思考は、拡張思考をサポートするモデルでのみ利用可能です：Claude Opus 4.6、GPT-5.3 Codex、GPT-5.2 Codex、GPT-5.2。

​
メッセージを送信する

入力バーにメッセージを入力し、Ctrl+Enterを押します（または送信ボタンをクリック）。改行にはShift+Enterを使用します。 エージェントはリアルタイムでレスポンスをストリーミングします。以下が表示されます：
  • テキストレスポンス — 完全なMarkdownレンダリングとシンタックスハイライト付き
  • 思考ブロック — モデルの推論プロセスを表示（展開可能、思考内容を表示が必要）
  • ツール呼び出し — ツール名と引数を表示する展開可能なブロック
  • ツール結果 — 各ツール実行の出力を表示
実行中のレスポンスをいつでも停止するには中止をクリックします。

​
ファイルをメンション

入力バーで @ を入力して、プロジェクト内のファイルを検索します。ファイルを選択すると、そのパスがメッセージに含まれ、エージェントがどのファイルを扱うかわかります。
  • フォルダー名の後に / を入力するとディレクトリを閲覧できる
  • 矢印キーでナビゲートし、EnterまたはTabで選択する
  • 最大20件の結果が表示される

​
スキルを使用する

入力バーで / を入力してスキルコマンドのオートコンプリートをトリガーします。スキルを選択すると、その指示がエージェントのコンテキストとして注入されます。 選択したスキルは入力バーに削除可能なピルとして表示されます。エージェントはメッセージとともにスキルの内容を受け取ります。 スキルの作成と管理の詳細についてはスキルリファレンスを参照してください。

​
画像を添付する

画像添付ボタンをクリックするか、クリップボードから画像をペーストします。対応フォーマット：PNG、JPG、JPEG、WebP、GIF。 画像はbase64エンコードされたコンテンツとしてテキストメッセージと一緒にモデルに送信されます。

​
ツール呼び出しと承認

エージェントには6つの組み込みツールがあります：read_file、write_file、edit_file、bash、glob、grep。 エージェントが bash コマンドを実行すると、承認プロンプトが表示されます：
  • 実行をクリックするとコマンドを実行する
  • 拒否をクリックすると実行を拒否する
設定 > エージェントでbashコマンドを自動承認を有効にすると、すべてのbashコマンドの承認プロンプトをスキップできます。
危険なパターンに一致するコマンド——sudo、rm -rf、履歴を書き換える git、curl ... | sh など——は、自動承認が有効な場合やプロジェクトがサンドボックス化されている場合でも、常に赤い枠線と危険なコマンドラベル付きのプロンプトが表示されます。
MCPサーバーが設定されている場合、そのツールも組み込みツールとともにエージェントで利用できます。

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

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

​
サブエージェント

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

​
ローカルデバイス

入力バーのローカルデバイスボタンをクリックして、ローカルネットワーク上の BRICKS Foundation デバイスと BRICKS Buttress サーバーをスキャンします。ダイアログは両方のスキャンを並行して実行し、片方が失敗してももう片方の一覧は維持されます。 Foundation デバイス行はアドレス、バージョン、以下のバッジを表示します：
  • このワークスペース — デバイスが現在のプロジェクトと同じワークスペースにバインドされている
  • CDP — デバイスが Chrome DevTools Protocol をサポートしている
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 スキルが提供します。

​
次のステップ

アプリをデプロイする

アプリケーションをBRICKSサーバーにリリースします。