サブエージェント

​

サブエージェントの仕組み

​

サブエージェントのコスト

​

サブエージェントはどのモデルを使いますか？

​

モデルの選択に影響する要素

1. 自然言語で プロファイル を指定する。 explore サブエージェントを依頼すると (「explore サブエージェントで auth の仕組みを調査して」など) 、処理は選択したモデルではなくデフォルトのサブエージェントモデルで実行されます。コード変更を依頼すると subagent_general が使われ、選択したモデルで実行されます。
2. カスタムサブエージェント の プロファイル でモデルを固定する。 定義ファイルの model: は、書き込み可能なサブエージェントを親とは異なるモデルで実行する唯一の方法です。サブエージェント内で実行される スキル でも、フロントマター に model: を設定して プロファイル のモデルを上書きできます。
3. 独自のデフォルトサブエージェントモデルを設定する。 設定ファイル で agent.subagent_model を指定すると、自分のセッションで使われるデフォルトのサブエージェントモデルを置き換えられます。この設定は、サブエージェントルーターや管理者が Team のデフォルトとして固定したモデルよりも優先されます。ただし、管理者の設定が None の場合、この設定によってサブエージェントが再び有効になることはありません。
   // ~/.config/devin/config.json
   {
     "agent": {
       "subagent_model": "swe-1-6-fast"
     }
   }
   
   この設定は、subagent_explore と、model: を固定していないカスタムサブエージェントに適用されます。subagent_general は引き続き親エージェントのモデルに従います。指定するモデルは組織で許可されているものである必要があり、許可されていない場合は設定が無視され、Team のデフォルトが使用されます。この設定は新しく開始するセッションから適用されます。

​

Enterprise Controls

​

サブエージェントの有効化と無効化

// ~/.config/devin/config.json
{
  "subagents_enabled": false
}

​

サブエージェントプロファイル

​

ツールの権限

• フォアグラウンドのサブエージェント はメインのエージェントと同様に動作し、通常どおりツール呼び出しを承認または拒否するよう求められます。プロンプトにはアクションをリクエストしたサブエージェントの名前が表示されるため、誰が要求しているかを確認できます。
• バックグラウンドのサブエージェント は、現在のセッション中にすでに付与したツールの権限を引き継ぎます。事前に承認されていないツールは自動的に拒否されます。バックグラウンドのサブエージェントが新しい権限の承認を求めることはできません。

​

サブエージェントの監視

​

サブエージェントのインジケーター

​

サブエージェントパネル

​

フォアグラウンド / バックグラウンドの切り替え

• フォアグラウンドのサブエージェントをバックグラウンドに切り替える: フォアグラウンドのサブエージェントの実行中に Ctrl+B を押します。サブエージェントはバックグラウンドで処理を続け、親エージェントが再開します。
• バックグラウンドのサブエージェントをフォアグラウンドに切り替える: サブエージェントパネルを開き、実行中のバックグラウンド サブエージェントで f を押します。サブエージェントの出力がインラインで表示されます。

​

ターンを中断する

​

サブエージェントのキャンセル

1. サブエージェントパネルから: パネルを開き、実行中のサブエージェントで x を押します。
2. フォアグラウンドのサブエージェント: 現在実行中のフォアグラウンドのサブエージェントをキャンセルするには、入力欄が空の状態で Ctrl+C を押すか、Esc を 2 回押します。入力中のドラフトがある場合は、Ctrl+C を押すと、まずドラフトがクリアされます。

​

サブエージェントの再開

• バックグラウンドで実行していたサブエージェントが、必要なツールの利用を拒否されたために失敗した場合 — フォアグラウンドで再開して、必要な権限を付与できます。
• サブエージェントは完了したものの、その結果に基づいて追加のフォローアップ作業を行わせたい場合。
• サブエージェントが途中でキャンセルされてしまい、続きを実行させたい場合。

​

ネストの深さ

Root agent (depth 0)
└── Custom subagent (depth 1) — 子エージェントを生成可能
    └── Child subagent (depth 2) — 子エージェントを生成可能
        └── Grandchild subagent (depth 3) — 生成不可（深さの上限に達した）

​

カスタムサブエージェント

​

カスタムサブエージェントの作成

• フラットファイル — agents/<name>.md (Claude Code、Cursor、その他のツールで使われているのと同じ規則です) 。ファイル名 (.md を除く) がプロファイルの識別子になります。
• ディレクトリ — agents/<name>/AGENT.md。ディレクトリ名がプロファイルの識別子になります。ファイル名には AGENTS.md、agent.md、agents.md も使用できます (複数存在する場合の優先順位は、AGENT.md、AGENTS.md、agent.md、agents.md の順です) 。

.devin/agents/
├── reviewer.md
└── researcher/
    └── AGENT.md

.agents/agents/
├── reviewer.md
└── researcher/
    └── AGENT.md

# Linux/macOS
~/.config/devin/agents/
├── reviewer.md
└── researcher/
    └── AGENT.md

# Windows
%APPDATA%\devin\agents\
├── reviewer.md
└── researcher\
    └── AGENT.md

​

定義ファイルの形式

---
name: reviewer
description: Reviews code changes for correctness and style
model: sonnet
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

You are a code review subagent. Your job is to review code changes
thoroughly and report findings back to the parent agent.

Focus on:
1. Correctness — logic errors, edge cases, off-by-one mistakes
2. Security — potential vulnerabilities
3. Style — consistency with the rest of the codebase
4. Performance — obvious inefficiencies

Always cite specific file paths and line numbers in your findings.

​

フロントマター のフィールド

​

カスタムサブエージェント の利用方法

​

使用例

​

読み取り専用調査エージェント

---
name: researcher
description: Deep codebase research and architecture analysis
model: sonnet
allowed-tools:
  - read
  - grep
  - glob
---

You are a research subagent specializing in codebase exploration.

Your job is to thoroughly investigate a topic and report back with:
- Relevant files and their purposes
- Architecture patterns and dependencies
- Code flow traces with specific line references

Be exhaustive — search broadly and follow references.

​

テスト実行エージェント

---
name: test-runner
description: Runs tests and reports results
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

You are a test runner subagent. Run the relevant test suites and report:
- Which tests passed and failed
- Failure messages and stack traces
- Suggestions for fixing failures