) => {
const agentName = runtime.config?.metadata?.lc_agent_name ?? "unknown";
const ctx = runtime.context;
const maxResults =
agentName === "researcher" ? ctx?.researcherMaxDepth ?? 5 : 5;
const includeRaw = false;
return performSearch(input.query, { maxResults, includeRaw });
},
{
name: "flexible_search",
description: "Search with agent-specific settings",
schema: z.object({ query: z.string() }),
}
);
```
## 故障排除
### 子智能体未被调用
**问题**：主智能体试图自己完成工作，而不是委派。
**解决方案**：
1. **使描述更具体：**
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
// ✅ 好
{ name: "research-specialist", description: "Conducts in-depth research on specific topics using web search. Use when you need detailed information that requires multiple searches." }
// ❌ 差
{ name: "helper", description: "helps with stuff" }
```
2. **指示主智能体进行委派：**
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
const agent = createDeepAgent({
systemPrompt: `...your instructions...
IMPORTANT: For complex tasks, delegate to your subagents using the task() tool.
This keeps your context clean and improves results.`,
subagents: [...]
});
```
### 上下文仍然膨胀
**问题**：尽管使用了子智能体，上下文仍然被填满。
**解决方案**：
1. **指示子智能体返回简洁结果：**
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
systemPrompt: `...
IMPORTANT: Return only the essential summary.
Do NOT include raw data, intermediate search results, or detailed tool outputs.
Your response should be under 500 words.`
```
2. **对大量数据使用文件系统：**
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
systemPrompt: `When you gather large amounts of data:
1. Save raw data to /data/raw_results.txt
2. Process and analyze the data
3. Returnonly the analysis summary
This keeps context clean.`
```
\###选择了错误的子代理
**问题**：主代理为任务调用了不合适的子代理。
**解决方案**：在描述中清晰区分不同的子代理：
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
const subagents = [
{
name: "quick-researcher",
description: "用于简单、快速的研究问题，只需 1-2 次搜索。当你需要基本事实或定义时使用。",
},
{
name: "deep-researcher",
description: "用于复杂、深入的研究任务，需要多次搜索、综合与分析。适用于全面报告类任务。",
}
];
```
***
[Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/i18n\zh-CN\oss\deepagents\subagents.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
[Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
## 结构化输出
所有子智能体都支持[结构化输出](/oss/javascript/langchain/structured-output)，您可以使用它来验证子智能体的输出。
您可以通过将所需的结构化输出模式作为 `responseFormat` 参数传递给 `createAgent()` 来设置它。
当模型生成结构化数据时，它会被捕获和验证。结构化对象本身不会返回给父智能体。
在子智能体中使用结构化输出时，请将结构化数据包含在 `ToolMessage` 中。
有关更多信息，请参阅[响应格式](/oss/javascript/langchain/structured-output#response-format)。
## 通用子智能体
除了任何用户定义的子智能体外，深度智能体始终可以访问一个 `general-purpose` 子智能体。该子智能体：
* 具有与主智能体相同的系统提示
* 可以访问所有相同的工具
* 使用相同的模型（除非被覆盖）
* 继承主智能体的技能（当配置了技能时）
### 覆盖通用子智能体
在您的 `subagents` 列表中包含一个 `name: "general-purpose"` 的子智能体以替换默认设置。使用此方法为通用子智能体配置不同的模型、工具或系统提示：
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { createDeepAgent } from "deepagents";
// 主智能体使用 Claude；通用子智能体使用 GPT
const agent = await createDeepAgent({
model: "claude-sonnet-4-6",
tools: [internetSearch],
subagents: [
{
name: "general-purpose",
description: "General-purpose agent for research and multi-step tasks",
systemPrompt: "You are a general-purpose assistant.",
tools: [internetSearch],
model: "openai:gpt-4o", // 为委派的任务使用不同的模型
},
],
});
```
当您提供名为 general-purpose 的子智能体时，默认的通用子智能体将不会被添加。您的规范将完全替换它。
### 何时使用它
通用子智能体非常适合不需要特殊行为的上下文隔离。主智能体可以将复杂的多步骤任务委派给此子智能体，并获得简洁的结果返回，而不会因中间工具调用而导致上下文膨胀。