将自定义的同步子智能体定义为 markdown 文件，以便 Deep Agents Code 可以将专门的任务委托给它们。

INFO

异步子智能体目前还不能提供给 Deep Agents Code 的最终用户使用。

每个子智能体都驻留在自己的文件夹中，并带有一个 AGENTS.md 文件：

.deepagents/agents/{subagent-name}/AGENTS.md   # 项目级
~/.deepagents/{agent}/agents/{subagent-name}/AGENTS.md  # 用户级

同名的项目子智能体会覆盖用户子智能体（参见优先级规则）。

frontmatter 需要 name 和 description（与 SubAgent 字典规范相同）。markdown 正文成为子智能体的 system_prompt。除了基础规范之外，AGENTS.md 文件还支持可选的 model frontmatter 字段，用于为这个子智能体覆盖主智能体的模型。使用 provider:model-name 格式（例如 anthropic:claude-opus-4-8、openai:gpt-5.5）。省略该字段则继承主智能体的模型。

INFO

SubAgent 的其他字段（tools、middleware、interrupt_on、skills）目前无法通过 AGENTS.md frontmatter 配置——以这种方式定义的自定义子智能体会继承主智能体的工具。要获得完全的控制权，请直接使用 SDK。

文件格式

子智能体 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

动态子智能体

dcode 默认启用代码解释器，因此动态子智能体开箱即用。

要触发动态子智能体，请请求一个“工作流”（workflow）。智能体不会自己做这项工作，也不会通过其原生 task 工具管理扇出，而是编写一个编排脚本，调用内置的 task() 全局函数并在代码解释器中运行它。例如：“运行一个工作流，审查 src/ 中的每个文件是否有 SQL 注入。”

随着子智能体的生成，dcode 会在动态子智能体面板中实时显示它们，并按派发顺序分组为多个阶段。

你也可以通过 ACP 在你选择的编码智能体中使用动态子智能体（例如 Zed）。

示例：低成本子智能体

对于简单的委托任务使用更便宜、更快的模型，同时让主智能体继续使用能力更强的模型：

---
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.

这会覆盖内置的通用子智能体，将所有委托任务路由到更便宜的模型。更多信息请参阅覆盖通用子智能体。