Custom agents 是 Copilot 代理的专用版本，可针对特定任务和工作流进行定制。 定义一次角色，而不是在每次需要该专业知识时重复其说明和工具要求。
例如，可以创建遵循写作标准的文档专家，也可以创建可读取和搜索文件但无需编辑工具的审阅者。
关于代理资料
代理档案是带有 YAML frontmatter 的 Markdown 文件。 它描述代理的目的，提供说明，并可以限制其可用工具。 在受支持的环境中，配置文件还可以为该代理配置 MCP 服务器。
需要具有特定方法和工具集的可重用角色时，请使用自定义智能体。 如果只需要特定于任务的说明和资源，技能可以是更简单的选择。 如需比较，请参阅 比较Copilot自定义功能。
可以在存储库、组织和企业级别共享个人资料。 Copilot CLI 还支持个人配置文件。 配置位置、支持的属性和优先级取决于环境。 请参阅“自定义代理配置”。
可在其中使用自定义代理
可以将自定义代理用于：
- 该GitHub Copilot app.
- GitHub Copilot CLI。
- Copilot cloud agent on GitHub.com，包括“智能体”选项卡和面板、问题分配和拉取请求（PR）。
- 支持的 IDE，包括 Visual Studio Code、 Visual Studio、 JetBrains IDE系列Eclipse 和 Xcode。
JetBrains IDE系列 和 Xcode 中的自定义代理位于 公开预览。 有关特定于 IDE 的版本支持和发布状态，请参阅 Copilot特征矩阵。
在 IDE 中，直接在聊天中使用自定义代理不同于将任务委派给Copilot cloud agent。 配置对象的属性在不同环境中的表现可能不同，或者会在环境之间被忽略。 有关VS Code配置集行为，请参阅VS Code中的自定义代理。
内置代理
无需为每个专门任务定义自定义代理。 Copilot CLI 包括主代理可用于常见工作的内置代理：
explore用于代码库浏览task用于命令执行general-purpose用于需要单独代理上下文的工作code-review查看更改research用于研究rubber-duck获取第二意见security-review用于以安全为中心的评审
这些内容由 Copilot CLI 提供，而不是由你自己创建的配置文件。 可用工具和行为因智能体而异。 有关其功能和模型默认设置，请参阅 内置智能体。
自定义代理和子代理
自定义代理是专家定义。 子代理是在单独的上下文窗口中 执行委托工作的代理 。 主代理可以委托给内置代理，也可以使用自定义代理配置文件运行专用代理。
通过单独的上下文，子代理可以专注于其分配的任务，而无需将每个中间详细信息添加到主对话。 独立任务也可以并行运行。 这些是委派的好处，而不是需要你创建自定义配置文件的特性。
为会话选择自定义代理并将子任务委派给其中一个，是使用配置文件的不同方式。 在 Copilot CLI 中，包含了供会话代理使用的存储库说明，但默认情况下不包括自定义子代理。 有关选择加入设置和调用方法，请参阅 为 GitHub Copilot CLI 创建和使用自定义智能体。
有关在GitHub Copilot app和Copilot CLI中的更广泛委派模型，请参阅使用代理委托和并行处理工作。
后续步骤
选择适合你工作场所的设置指南：