调用自定义代理

使用 自定义代理

          自定义智能体 是 Copilot 的专用版本。 
          自定义智能体 帮助 Copilot 处理独特的工作流、特定的编码约定和专家用例。

          Copilot 命令行界面（CLI） 包括一组用于常见任务的默认 自定义代理：

代理人	说明
探究	执行快速代码库分析，让你无需添加到主上下文即可提出有关代码的问题。
任务	执行测试和构建等命令，在成功时提供简要总结，在失败时提供完整输出。
常规用途	处理复杂的多步骤任务，这些任务需要完整的工具集和高质量的推理，在单独的上下文中运行，以使主对话保持清晰焦点。
代码评审	审查更改时，专注于揭示真正的问题，尽量减少干扰。

CLI 使用的 AI 模型可以选择将任务委托给一个使用具有特定专业知识的 自定义智能体 运行的附属子代理进程，前提是它认为这样做可以更有效地完成工作。 此模型同样可以选择直接在主智能体中处理工作。

可以使用 Markdown 文件（称为自定义代理）定义自己的代理资料内容，这些文件指定代理应具备哪些专业知识、可以使用哪些工具，以及响应方式的任何特定说明。

可以在用户、存储库或组织/企业级别定义 自定义代理 ：

类型	位置	Scope
用户级别 自定义智能体	本地 ~/.copilot/agents 目录	所有项目
存储库级别 自定义智能体

          `.github/agents` 本地存储库和远程存储库中的目录 | 当前项目 |

| 组织和企业级 自定义智能体 | 组织或企业/agents 存储库中的 .github-private 目录 | 组织及企业帐户下的所有项目 |

在命名冲突的情况下，系统级代理会替代存储库级代理，存储库级代理将替代组织级代理。

          自定义智能体 可通过三种方式使用：

• 使用 CLI 交互式接口中的斜杠命令从可用 自定义代理列表中进行选择：

  /agent
  

• 在提示中直接调用自定义智能体：

  Use the refactoring agent to refactor this code block
  

          Copilot 将自动推断要使用的代理。
  

• 使用命令行选项指定要使用的 自定义智能体。 例如：

  copilot --agent=refactor-agent --prompt "Refactor this code block"
  

有关详细信息，请参阅“为Copilot云代理创建自定义代理”。

使用技能

可以创建技能，以增强 Copilot 使用说明、脚本和资源来执行专用任务的能力。

有关详细信息，请参阅“为 GitHub Copilot 命令行界面 (CLI) 添加代理技能”。

添加 MCP 服务器

          Copilot 命令行界面（CLI）附带已配置的GitHubMCP 服务器。 此 MCP 服务器允许你与资源 GitHub.com进行交互，例如，允许你合并 CLI 中的拉取请求。

若要扩展可用 Copilot 命令行界面（CLI）功能，可以添加更多 MCP 服务器：

1. 使用以下斜杠命令：

   /mcp add
   

2. 填写你想要添加的 MCP 服务器的详细信息，使用 Tab 键在各个字段之间切换。

3. 按 Ctrl+S 以保存详细信息。

你已配置的 MCP 服务器详细信息存储在 mcp-config.json 文件中，该文件默认位于 ~/.copilot 目录下。 可通过设置 COPILOT_HOME 环境变量来更改此位置。 有关服务器定义的 JSON 结构的信息，请参阅“将代理连接到外部工具”。

有关添加和管理 MCP 服务器 Copilot 命令行界面（CLI）的详细信息，请参阅 为 GitHub Copilot 命令行界面 (CLI) 添加 MCP 服务器。

后续步骤

若要了解如何在任务执行期间指导和优化代理行为，以跟踪工作，请参阅 引导 GitHub Copilot 命令行界面 (CLI) 中的智能体。