) => {
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. Return only the analysis summary
This keeps context clean.`;
```
### 选择了错误的子代理
**问题**：主代理为任务调用了不合适的子代理。
**解决方案**：在描述中清晰区分子代理：
```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
const subagents = [
{
name: "quick-researcher",
description:
"For simple, quick research questions that need 1-2 searches. Use when you need basic facts or definitions.",
},
{
name: "deep-researcher",
description:
"For complex, in-depth research requiring multiple searches, synthesis, and analysis. Use for comprehensive reports.",
},
];
```
:::
***
[将这些文档](/use-these-docs)通过 MCP 连接到 Claude、VSCode
等，以获得实时答案。
[在 GitHub
上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/deepagents/subagents.mdx)
或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
## 结构化输出
子代理支持[结构化输出](/oss/javascript/langchain/structured-output)，因此父代理接收可预测、可解析的 JSON，而不是自由格式文本。