简介：本文面向开发者、技术负责人及企业用户，系统讲解智能体编程助手场景下代理与子代理的创建、配置、调用与调试方法。文章围绕代理命名、能力描述、使用场景规划、触发边界设置及结果验证等核心环节展开，帮助读者将复杂任务拆解为可复用、可管理的专用代理，提升自动化工作流的稳定性与可维护性。
本教程旨在帮助读者掌握在智能体编程助手或同类AI协作工具中，创建和管理专用子代理的完整方法。完成学习后，你将能够：
本教程假设读者已具备基础的命令行操作经验，并正在使用支持代理能力的智能体编程工具。文中不涉及特定商业产品的独有接口，所有操作均以业界通用的交互模式进行说明。
在智能体编程工具中，代理通常指能够根据用户指令自主完成一系列操作的执行单元。它具备理解任务、调用工具、读写文件、执行命令等能力。而子代理则是代理体系中的一种轻量级、职责单一的代理单元，通常被主代理在需要时调用，用于处理边界清晰、重复性高的任务。
举个例子，如果你经常需要让AI助手帮你“审查代码中的安全漏洞”，与其每次都在主对话中重复描述审查标准和输出格式，不如创建一个名为“安全审查代理”的子代理，将审查规范、关注点和输出模板固化到代理的配置中。之后只需一句话“调用安全审查代理检查当前目录”，即可获得格式一致、标准统一的审查结果。
子代理的核心价值可以概括为三点：
创建子代理适合以下典型场景：
场景一：高频重复任务
当你发现自己反复向AI助手输入相同或相似的指令时，例如每日生成测试报告、定期整理提交记录、批量重命名文件等，这些任务适合沉淀为子代理。
场景二：需要特定领域知识的任务
某些任务需要模型遵循特定的领域规范，例如数据库变更审查、前端可访问性检查、API文档风格校验等。将这些规范写入子代理的描述中，可以避免每次重复说明。
场景三：多步骤但流程固定的任务
有些任务虽然步骤较多，但执行顺序基本固定。例如代码发布前的检查流程：先运行格式检查，再执行静态扫描，最后运行单元测试。将整个流程封装为子代理后，可以确保每次执行不会遗漏步骤。
场景四：需要隔离上下文的任务
当某些操作涉及大量中间信息，不希望污染主对话上下文时，将其交给子代理独立处理是更优选择。
在开始创建子代理之前，请确认以下条件已满足：
工具版本支持：你使用的智能体编程工具需支持代理或子代理功能。可以通过在对话界面输入代理相关指令（如斜杠命令）查看是否出现创建入口来判断。
明确的任务定义：在创建之前，先用一两句话写清楚“这个代理要解决什么问题”。如果自己都说不清楚，往往意味着任务边界还不够明确，需要进一步拆解。
权限与环境确认：如果子代理需要执行文件读写、命令运行或网络请求等操作，请确认当前环境已具备相应的访问权限，避免代理在执行时因权限不足而中断。
命名规范约定：如果是在团队中共享使用，建议提前约定命名规则，例如使用“动词+对象”的格式（如“检查依赖”“生成报告”“清理缓存”），确保团队成员都能通过名称直观理解代理的用途。
在智能体编程工具的对话交互界面中，输入用于打开代理管理面板的指令。常见形式为斜杠命令，例如输入 /agents 后按提示操作。如果你的工具版本使用不同的交互入口，也可以通过帮助文档或命令列表查找“代理”“子代理”“Agent”等关键词定位。
进入管理面板后，你通常会看到已有代理的列表。如果此前从未创建过，列表可能为空或仅包含系统预设的默认代理。此时选择“创建新代理”或等效选项，进入创建流程。
注意：不同版本的交互界面可能存在差异。如果找不到创建入口，建议先查看工具的更新说明或帮助中心，确认当前版本是否已开放代理创建能力。
这是整个创建流程中最关键的一步。系统通常会要求你填写两个核心信息：代理名称和能力描述。
关于代理名称：
代理名称是后续调用该代理时使用的唯一标识符。一个好的名称应满足以下要求：
以“依赖安全检查”为例，这个名称直接说明了代理关注的是“依赖安全”领域，执行的是“检查”动作，调用者无需查看详细描述即可理解其用途。
关于能力描述：
能力描述是对代理职责和适用场景的自然语言说明。多数工具会将这段描述作为系统提示词的一部分注入到代理的执行上下文中，因此描述的准确性和完整性直接影响代理的表现。
建议在描述中覆盖以下要素：
以下是一个能力描述的通用示例：
你是一名专门负责依赖安全审查的子代理。你的核心任务是读取项目中的依赖声明文件，检查其中引用的第三方库是否存在已知安全漏洞。你可以读取项目根目录下的依赖清单文件，并与本地缓存的漏洞信息进行比对。请将检查结果按严重程度分为高、中、低三级，逐一列出问题项及对应版本，并给出通用的修复建议。你不得修改任何依赖文件，也不得执行安装或升级操作。如果依赖清单无法读取，请直接说明原因并停止执行。
通过这样结构化、边界清晰的能力描述，代理在后续执行时能更好地理解自身职责，减少越权操作和输出偏差。
部分工具允许你为子代理配置触发方式。常见的触发方式有两种：
无论工具是否支持自动触发，建议在创建完成后的初次测试中，都采用手动显式调用的方式，以便准确观察代理的输出是否符合预期，避免自动匹配机制干扰判断。
完成名称和描述填写后，保存配置。此时你通常会被带回代理列表页面，可以看到刚才创建的代理已出现在列表中，状态为可用。
保存不代表结束，接下来需要进入验证环节。
验证是确保子代理按预期工作的必要环节。建议按以下顺序进行测试：
验证一：基础调用测试
在对话中明确输入调用该代理的指令，并附带一个简单的测试任务。例如：“请调用‘依赖安全检查’代理，检查当前项目的依赖安全状况。” 观察代理是否能被正确触发，并在预期范围内开始执行。
验证二：边界测试
给代理一个超出其职责范围的任务，观察是否会明确拒绝或给出边界说明。例如让“依赖安全检查”代理去“修改主页文案”。一个经过良好配置的代理应当识别出这不是自己的职责范围，并给出清晰提示，而不是尝试执行。
验证三：输出格式测试
检查代理返回的结果格式是否与你在能力描述中设定的输出要求一致。如果偏差较大，说明能力描述中关于输出格式的约束不够明确，需要返回修改描述内容。
验证四：组合调用测试
如果你计划在主工作流中使用该子代理，建议在真实的主对话流程中测试一次完整调用，确认子代理的输出能被后续步骤正确使用。
问题一：创建后无法通过名称调用代理
可能原因：工具对代理名称的匹配存在大小写或空格敏感。排查思路：确认调用时输入的名称与创建时完全一致；查看代理列表中该代理是否处于启用状态；如果支持拼音或模糊匹配，确认是否开启了相关选项。
问题二：代理执行时频繁越权操作
可能原因：能力描述中的边界限制不够明确，或描述位置不够靠前，模型未能充分关注。排查思路：回到代理编辑页面，将边界限制的描述放在能力描述的后半部分，并使用否定句式强化约束，例如“你不得……”“禁止执行……”。
问题三：输出结果格式不稳定
可能原因：输出要求描述不够具体，缺少结构性说明。排查思路：在能力描述中用列表或分段形式明确输出结构，例如“请严格按以下格式输出：第一段为总览，第二段为逐项说明”。如工具支持，可以在描述中给出一个简短的输出样例。
问题四：代理执行到一半因权限不足中断
可能原因：当前运行环境对某些操作有权限限制。排查思路：确认代理执行所需的文件读写路径和命令范围是否在当前权限内；如果代理需要网络访问，确认环境是否允许。根据排查结果调整代理的操作范围，或在运行时提供必要的授权。
问题五：多个代理职责重叠导致选择困难
可能原因：创建代理时职责边界划分不够清晰。排查思路：重新审视各代理的能力描述，合并职责高度重叠的代理，或在描述中明确各代理的适用条件和优先级，避免调用时的随机性。
1. 控制代理数量，保持职责清晰
子代理并非越多越好。当一个代理的描述超过一段话仍无法说清职责时，说明它可能承担了过多任务，应考虑拆分。反之，如果两个代理的职责高度相似，则应合并。一个实用的判断标准是：每个代理的能力描述能否在三句话内说清楚。
2. 定期回顾代理描述
项目演进过程中，代理的职责可能需要调整。建议定期检查代理列表，对于长期未被调用的代理，考虑更新描述或直接删除，避免列表膨胀影响选择效率。
3. 为代理输出建立统一约定
如果团队中多个代理的输出需要被后续流程消费，建议约定统一的输出格式，例如都使用结构化列表或都输出特定标记分隔的内容，减少后续解析成本。
4. 记录代理的使用反馈
在实际使用中，留意代理输出的不足之处，及时将改进点补充到能力描述中。代理的优化是一个持续迭代的过程，每一次边界修正和输出校准都会让后续使用更加顺畅。
子代理的创建与配置，本质上是对重复性技术任务的一次“工程化封装”。通过规范化的命名、清晰的能力描述、明确的边界设定以及系统的验证流程，可以将零散的AI辅助操作转化为稳定可复用的工程能力。
本教程围绕代理创建的核心步骤展开，重点讨论了名称定义、能力描述编写、触发方式选择、结果验证以及常见问题的排查思路。掌握这些方法后，建议从团队中最高频、最明确的一类任务开始实践，逐步建立项目或团队专属的代理库，让AI辅助开发从“对话驱动”走向“能力沉淀”。