将自定义同步 subagents 定义为 markdown 文件，让 Deep Agents Code 可以将专项任务委派给它们。
Deep Agents Code 目前不提供 async subagents。
每个 subagent 都位于自己的文件夹中，并包含一个 AGENTS.md 文件： 
.deepagents/agents/{subagent-name}/AGENTS.md   # Project-level
~/.deepagents/{agent}/agents/{subagent-name}/AGENTS.md  # User-level
Project subagents 会覆盖同名 user subagents（请参阅 precedence rules）。 Frontmatter 必须包含 name 和 description（与 SubAgent dictionary spec 相同）。Markdown 正文会成为 subagent 的 system_prompt。除基础 spec 外，AGENTS.md 文件还支持可选的 model frontmatter field，用于为此 subagent 覆盖 main agent 的 model。使用 provider:model-name 格式（例如 anthropic:claude-opus-4-7、openai:gpt-5.5）。省略该字段则继承 main agent 的 model。
其他 SubAgent fields（tools、middleware、interrupt_on、skills）目前不能通过 AGENTS.md frontmatter 配置。以这种方式定义的 custom subagents 会继承 main agent 的 tools。若需要完整控制，请直接使用 SDK。

​
文件格式

Subagent AGENTS.md 文件使用 YAML frontmatter，后接 markdown 正文： 
---
name: researcher
description: Research topics on the web before writing content
model: anthropic:claude-haiku-4-5-20251001
---

You are a research assistant with access to web search.

## Your Process
1. Search for relevant information
2. Summarize findings clearly

​
示例：成本高效的 subagents

对简单委派任务使用更便宜、更快的 model，同时让 main agent 使用能力更强的 model： 
---
name: general-purpose
description: General-purpose agent for research and multi-step tasks
model: anthropic:claude-haiku-4-5-20251001
---

You are a general-purpose assistant. Complete the task efficiently and return a concise summary.
这会覆盖内置的 general-purpose subagent，将所有委派任务路由到更便宜的 model。更多信息请参阅 Override the general-purpose subagent。
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.
Edit this page on GitHub or file an issue.