在 Deep Agents Code 中使用子智能体

使用带 YAML frontmatter 的 AGENTS.md 文件定义自定义 Deep Agents Code 子智能体。涵盖项目路径与用户路径、可选的模型覆盖以及示例。

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

NOTE

目前，Deep Agents Code 中的最终用户尚无法使用异步子智能体。

每个子智能体都位于各自的文件夹中，并带有一个 AGENTS.md 文件：

.deepagents/agents/{subagent-name}/AGENTS.md   # Project-level
~/.deepagents/{agent}/agents/{subagent-name}/AGENTS.md  # User-level

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

延续父对话

内置的 general-purpose 子智能体会继承父智能体的对话和系统提示词。这一上下文使被委派的工作得以延续，而无需重复父对话中已确立的调查、决策或其他细节。

若要改为在隔离（isolated）模式下运行内置的 general-purpose 子智能体，请在你的 shell 或全局 ~/.deepagents/.env 中设置以下变量：

export DEEPAGENTS_CODE_FORKED_SUBAGENTS=false

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

NOTE

其他 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 默认启用代码解释器，因此动态子智能体开箱即用。

要触发动态子智能体，请提出一个「工作流」。智能体不会亲自完成工作，也不会通过其原生 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.

这会覆盖内置的 general-purpose 子智能体，将所有委派任务路由到更便宜的模型。更多信息参见覆盖 general-purpose 子智能体。

---