# 自定义代理

赋予 Copilot 可重用的专家角色以定制的说明和工具。

Custom agents 是 Copilot 代理的专用版本，可针对特定任务和工作流进行定制。 定义一次角色，而不是在每次需要该专业知识时重复其说明和工具要求。

例如，可以创建遵循写作标准的文档专家，也可以创建可读取和搜索文件但无需编辑工具的审阅者。

## 关于代理资料

代理档案是带有 YAML frontmatter 的 Markdown 文件。 它描述代理的目的，提供说明，并可以限制其可用工具。 在受支持的环境中，配置文件还可以为该代理配置 MCP 服务器。

需要具有特定方法和工具集的可重用角色时，请使用自定义智能体。 如果只需要特定于任务的说明和资源，技能可以是更简单的选择。 如需比较，请参阅 [比较Copilot自定义功能](/zh/copilot/concepts/customizations/comparing-customizations)。

可以在存储库、组织和企业级别共享个人资料。
Copilot CLI 还支持个人配置文件。 配置位置、支持的属性和优先级取决于环境。 请参阅“[自定义代理配置](/zh/copilot/reference/custom-agents-configuration)”。

## 可在其中使用自定义代理

可以将自定义代理用于：

* **该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特征矩阵](/zh/copilot/reference/copilot-feature-matrix)。

在 IDE 中，直接在聊天中使用自定义代理不同于将任务委派给Copilot cloud agent。 配置对象的属性在不同环境中的表现可能不同，或者会在环境之间被忽略。 有关VS Code配置集行为，请参阅[VS Code中的自定义代理](https://code.visualstudio.com/docs/copilot/customization/custom-agents)。

## 内置代理

无需为每个专门任务定义自定义代理。
Copilot CLI 包括主代理可用于常见工作的内置代理：

* `explore` 用于代码库浏览
* `task` 用于命令执行
* `general-purpose` 用于需要单独代理上下文的工作
* `code-review` 查看更改
* `research` 用于研究
* `rubber-duck` 获取第二意见
* `security-review` 用于以安全为中心的评审

这些内容由 Copilot CLI 提供，而不是由你自己创建的配置文件。 可用工具和行为因智能体而异。 有关其功能和模型默认设置，请参阅 [内置智能体](/zh/copilot/reference/copilot-cli-reference/cli-command-reference#built-in-agents)。

## 自定义代理和子代理

自定义代理是**专家定义**。 子代理是在单独的上下文窗口中 **执行委托工作的代理** 。 主代理可以委托给内置代理，也可以使用自定义代理配置文件运行专用代理。

通过单独的上下文，子代理可以专注于其分配的任务，而无需将每个中间详细信息添加到主对话。 独立任务也可以并行运行。 这些是委派的好处，而不是需要你创建自定义配置文件的特性。

为会话选择自定义代理并将子任务委派给其中一个，是使用配置文件的不同方式。 在 Copilot CLI 中，包含了供会话代理使用的存储库说明，但默认情况下不包括自定义子代理。 有关选择加入设置和调用方法，请参阅 [为 GitHub Copilot CLI 创建和使用自定义智能体](/zh/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)。

有关在GitHub Copilot app和Copilot CLI中的更广泛委派模型，请参阅[使用代理委托和并行处理工作](/zh/copilot/concepts/agent-capabilities/choosing-and-delegating-agent-work/delegating-and-parallelizing-work-with-agents)。

## 后续步骤

选择适合你工作场所的设置指南：

* [为Copilot cloud agent创建自定义代理](/zh/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)
* [在 IDE 中使用自定义代理](/zh/copilot/how-tos/copilot-in-your-ide/use-copilot-agents/use-custom-agents)
* [自定义 GitHub Copilot 应用](/zh/copilot/how-tos/github-copilot-app/customize-github-copilot-app)