【Agents】自定义子代理进阶：后台执行

关注

原创最新推荐文章于 2026-11-01 14:41:58 发布 756 阅读 AI 写同款· GEO 优化 ›

LangChain精通-代理 (Agents) 完全指南 LangChain代理系统摘要 LangChain代理系统利用大型语言模型(LLM)作为决策引擎，动态调用工具完成复杂任务。核心组件包括：代理类型：提供多种代理实现，如ReAct推理代理、聊天代理和OpenAI函数调用代理执行引擎：AgentExecutor负责代理执行循环，包括思考-行动-观察的迭代过程工具系统：支持自定义工具和预定义工具集，如搜索引擎、计算器和代码执行器系统采用ReAct框架进行多步推理，通过提示工程指导LLM决策，支持流式执行、错误处理和记忆管理。开发者可灵活配置迭代次数、超时阅读详情

基础篇：【Agents】Claude Code 多 Agent 入门：从一问一答到并行协作
实践篇1:【Agents】Claude Code 自定义子代理：内置的不够用，就自己造
实践篇2:【Agents】自定义子代理进阶：沙盒隔离

上一篇用 isolation: worktree 解决了"改崩了怎么办"的问题。但还有一个痛点：子代理跑着的时候你只能干等，没法继续对话。

跑完整测试套件要三分钟，审查一个大 PR 要五分钟，生成一整个模块的文档要更久。这段时间你就坐在那里看转圈，明明有别的事想跟 Claude 讨论，却只能等。

background: true 解决这件事，子代理在后台跑，你该干嘛干嘛。。

一、后台执行：background: true

1.1 前台 vs 后台

前台（foreground）是默认模式。

你调用子代理后，主对话会暂停，等子代理完成才能继续交互。整个过程你能实时看到子代理的工作输出：它在读哪个文件、在跑什么命令、在写什么代码，就像坐在它旁边看它干活。适合你需要盯着过程、随时准备介入的场景，比如让子代理审查代码后你要立刻根据结果做决定。
后台（background）是异步模式。

你调用子代理后，主对话立刻恢复可用，子代理在后台默默工作。你看不到它的实时输出，但它完成后会发一条通知，你可以随时问 Claude 查看结果。适合你不需要盯着过程、结果也不急着要的场景，比如跑测试、生成文档这类"交出去等结果就行"的任务。
简单来说，就是：前台是"我看着你干"，后台是"你干完告诉我"。

在这里插入图片描述

上图直观展示了差异：前台模式下你必须等子代理跑完才能继续（总时间 = 子代理时间 + 你的工作时间），后台模式下两件事并行推进（总时间 = 两者中较长的那个）。

1.2 如何配置

在子代理的 frontmatter 中加一行 background: true。

(1) 示例

以一个测试执行子代理为例，将full-test-runner.md放到.claude/agents目录下。full-test-runner.md内容如下：

---
name: full-test-runner
description: 运行完整测试套件并生成覆盖率报告，后台执行不阻塞主对话
model: sonnet
background: true
tools:
  - Read
  - Glob
  - Grep
  - Bash
---

你是一个测试执行员。收到测试指令后：

1. 检测项目的测试框架和运行命令
2. 执行完整测试套件
3. 如果有失败的测试，分析失败原因
4. 生成测试摘要：通过/失败/跳过数量，覆盖率数据
5. 如果覆盖率低于 80%，列出未覆盖的关键路径

加上 background: true，这个子代理被调用后会立刻释放主对话，你可以继续跟 Claude 讨论其他问题。测试跑完后，你会收到一条通知和结果摘要。

(2) 注意事项

几个值得注意的设计选择：

没给 Edit 权限：这个子代理只负责跑测试和报告结果，不需要改代码。如果你想让它自动修复失败的测试，那得加 Edit，但那就是另一个子代理的职责了，职责混在一起会让排查问题变困难。
用 sonnet 而不是 opus：跑测试的核心工作是执行 Bash 命令和分析输出，不需要强推理能力。sonnet 足够且响应更快，后台任务越快完成越好。
提示词里写了"覆盖率低于 80%"的阈值：这类团队约定写死在提示词里，比每次调用时手动交代更可靠

1.3 如何使用

在对话里调用：

在这里插入图片描述

二、什么时候用前台，什么时候用后台

判断标准很简单：你接下来的操作是否依赖子代理的结果。

场景	选择	原因
审查完代码才能决定下一步改什么	前台	你需要审查结果才能继续
跑测试的同时想讨论架构方案	后台	两件事互不依赖
生成文档的同时想继续写代码	后台	写代码不需要等文档
子代理探索方案，你要对比结果再决策	前台	你在等它的方案
多个子代理并行审查不同模块	后台	多个任务互不依赖