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

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には1つの組み込みサブエージェントが含まれています：
名前説明ツール
explore読み取り専用のコードベース検索と探索read_file、glob、grep
組み込みサブエージェントは編集や削除ができません。

​
サブエージェントの管理

サイドバーツールバーのサブエージェントボタンをクリックして管理パネルを開きます。

​
スコープ

サブエージェントは2つのスコープに整理されます：
  • グローバル — すべての開いているプロジェクトで利用可能。~/.bricks-project-desktop/agents/ に保存されます。
  • プロジェクト — 特定のプロジェクト内でのみ利用可能。プロジェクトの .bricks/agents/ ディレクトリに保存されます。
同名のプロジェクトスコープのエージェントはグローバルエージェントより優先されます。カスタムグローバルエージェントは同名の組み込みエージェントより優先されます。

​
サブエージェントの作成

  1. サブエージェントパネルを開きます
  2. グローバルスコープを選択します
  3. 新規エージェントをクリックします
  4. エディターでエージェントのfrontmatterと指示を編集します
  5. 保存をクリックします

​
エージェントファイルフォーマット

サブエージェントはYAML frontmatterを持つmarkdownファイルです： 
---
name: my-agent
description: Describe when to use this agent
thinking_level: low
tools:
  - read_file
  - glob
  - grep
---

You are a specialized agent. Describe your purpose and instructions here.
Frontmatterフィールド：
フィールド必須説明
nameはいエージェントの一意の識別子
descriptionいいえこのエージェントをいつ使用するか（エージェントカードに表示）
modelいいえAIモデルの上書き（例：anthropic/claude-haiku-4-5-20251001）。モデル解決を参照
thinking_levelいいえ思考レベルの上書き（off、minimal、low、medium、high、xhigh）。思考レベル解決を参照
toolsいいえエージェントが使用できるツールのリスト
利用可能なツール： read_file、glob、grep

​
サブエージェントの編集

エージェントカードの編集ボタンをクリックしてエディターを開きます。frontmatterまたは指示を変更して、保存をクリックします。

​
サブエージェントの削除

エージェントカードの削除ボタンをクリックし、もう一度クリックして確認します。エージェントファイルは永久に削除されます。
ディスク上のエージェントファイルの変更は自動的に検出されます。外部エディターでエージェントファイルを編集した場合、パネルはリアルタイムで更新されます。

​
モデル解決

サブエージェントが実行されると、モデルは次の順序で解決されます：
  1. エージェントファイルの model フィールド — エージェントファイルにモデルが指定されている場合、それが使用されます
  2. 設定のデフォルト — 設定で構成されたデフォルトのサブエージェントモデル
  3. プロバイダー固有のデフォルト — 現在のプロバイダーのコスト効率の良いモデル：Anthropicでは claude-haiku-4-5-20251001、OpenAI CodexとGitHub Copilotでは gpt-5.4-mini、Googleでは gemini-3-flash-preview、OpenCode Zenでは minimax-m2.5、OpenCode Goでは minimax-m2.7
  4. セッションモデル — 現在のセッションで選択されたモデル
これにより、サブエージェントはエージェントごとの設定なしに、アクティブなプロバイダーのコスト効率の良いモデルを自動的に使用します。

​
思考レベル解決

サブエージェントが実行されると、思考レベルは次の順序で解決されます：
  1. エージェントファイルの thinking_level フィールド — エージェントファイルに思考レベルが指定されている場合、それが使用されます
  2. 設定のデフォルト — 設定で構成されたデフォルトのサブエージェント思考レベル
  3. モデル固有のフォールバック — OpenAI Responses API上の推論モデルの場合、デフォルトは low