关于自定义代理

          自定义智能体 是专用版本的 Copilot 代理，可针对独特的工作流、编码约定和用例进行定制。 他们的行为就像定制团队成员一样，遵循你的标准，使用正确的工具，并实施团队特定的做法。 定义这些代理一次，而不是重复提供相同的指令和上下文。

使用名为自定义代理的 Markdown 文件进行定义代理资料。这些文件指定提示、工具和 MCP 服务器。这样，就可以将约定、框架和所需结果直接编码为 Copilot。

          代理资料定义自定义智能体的行为。 将代理分配到任务或问题时，它会实例化自定义智能体。

除了你自己定义的任何自定义代理之外，Copilot还包括一组预构建的自定义代理。请参阅内置代理。

          代理简介 格式

          代理概况 是带有 YAML frontmatter 的 Markdown 文件。 在最简单的形式中，它们包括：

* 名称（可选）：用于自定义智能体的显示名称。如果省略，代理的文件名将用作其标识符和默认显示名称。 * 说明：说明代理的用途和功能。 * 提示：定义代理的行为和专业知识的自定义说明。 * 工具（可选）：代理可以访问的特定工具。默认情况下，代理可以访问所有可用的工具，包括内置工具和 MCP 服务器工具。

          代理概况 还可以使用 `mcp-servers` 属性包含 MCP 服务器配置。

示例代理资料

此示例是一个配置了名称、说明和提示的基础代理资料。

---
name: readme-creator
description: Agent specializing in creating and improving README files
---

You are a documentation specialist focused on README files. Your scope is limited to README files or other related documentation files only - do not modify or analyze code files.

Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images

您可以在其中配置自定义代理

可以在不同级别定义代理资料：

        **存储库级别**：在存储库中创建项目特定的代理`.github/agents/CUSTOM-AGENT-NAME.md`。

        **组织或企业级**：在`/agents/CUSTOM-AGENT-NAME.md`存储库中创建`.github-private`，以实现更广泛的可用性。

有关详细信息，请参阅准备在组织中使用自定义代理和准备在企业中使用自定义代理。

内置代理

除了在提交提示时处理请求的主 Copilot 代理外，还包括以下内置代理， Copilot 命令行界面（CLI）主代理可以作为子代理运行，以帮助执行常见的开发任务。这些代理针对效率和准确性进行了优化，利用基础语言模型和工具的功能，在其各自的域中提供高质量的帮助。

          Copilot 将根据提示和当前上下文自动使用适当的内置代理。 例如，提示 `How does authentication work in this codebase?` 通常会触发 Explore 代理，使用 `/research` 斜杠命令将触发 Research 代理。

* 浏览 - 快速轻型代码库探索代理。它使用代码智能、grep、glob、视图和 shell 工具来搜索文件和了解代码结构。它不会更改任何文件，因此可以并行调用主 Copilot 代理运行的其他子代理。它具有对 GitHub MCP 服务器工具的只读访问权限。

        **任务** - 执行开发命令（测试、构建、代码检查工具、格式化工具、依赖项安装）并高效报告结果的命令执行代理。 成功时返回简要摘要，失败时返回完整输出，以保持主要上下文的整洁。 它有权访问父代理可以使用的所有工具（不包括子代理上下文中不适合的某些工具），同时授予或拒绝了相同的权限。

        **常规用途** - 此代理实质上具有与主 Copilot 代理相同的所有功能。 主代理可以将常规用途代理作为子代理运行，以帮助执行任何需要单独上下文窗口的任务，或者在适当时并行运行。

        **代码评审** - 评审代码更改，信噪比极高。 此代理分析暂存/未标记的更改和分支差异，仅显示真正重要的问题：bug、安全漏洞、争用条件、内存泄漏和逻辑错误。 它永远不会对样式或格式进行批注。 它不会对文件进行任何更改。

        **研究** - 此代理充当员工级软件工程师和研究专家。 它提供了关于基本代码、API、库和软件体系结构的详尽、精心研究的答案。 它使用 GitHub 搜索/浏览工具、Web 提取/搜索和本地工具。 与其他代理不同，只能使用 `/research` 斜杠命令调用研究代理。 主代理无法自动触发它。

以子代理身份运行代理

使用自己定义的自定义代理（或内置代理）的好处之一是，主 Copilot 代理可以使用单独的上下文窗口将它们作为子代理运行。这意味着自定义代理或内置代理可以专注于特定的子任务，而不会使主代理的上下文窗口混乱。

在适当情况下，子代理执行的任务可以并行运行，从而更快地完成整个任务。

有关详细信息，请参阅“比较 GitHub Copilot CLI 自定义功能”。

后续步骤

若要创建自己的自定义代理帐户，请参阅：

        [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)

        [AUTOTITLE](/copilot/reference/customization-cheat-sheet)

关于自定义代理

在本文中