调用自定义代理

在 Copilot 命令行界面（CLI） 中使用自定义代理、技能和 MCP 服务器以扩展其功能。

谁可以使用此功能？

GitHub Copilot 命令行界面 (CLI) 与所有 Copilot 计划兼容。 如果从组织收到 Copilot，则必须在组织的“Settings”中启用 Copilot 命令行界面（CLI） 策略。

在本文中

使用 自定义代理

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

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

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

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

你可以使用名为 代理资料 的 Markdown 文件定义自己的 自定义代理，这些文件指定智能体应具备哪些专业知识、可使用哪些工具，及其回答方式的任何特定说明。

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

类型位置Scope
用户级别 自定义智能体本地 ~/.copilot/agents 目录所有项目
仓库级别 自定义智能体.github/agents 本地存储库和远程存储库中的目录当前项目
组织和企业层面 自定义智能体组织或企业.github-private 存储库中的 /agents 目录组织及企业帐户下的所有项目

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

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

  • 使用 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） 已预先配置好了 GitHub MCP 服务器。 通过此 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）扩展GitHub Copilot编码代理”。

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

后续步骤

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