跳至主要内容

调用自定义代理

在 Copilot CLI 中使用自定义代理、技能和 MCP 服务器以扩展其功能。

谁可以使用此功能?

GitHub Copilot CLI 在所有 Copilot 计划中均可用。如果您通过组织获取 Copilot,则必须在组织设置中启用 Copilot CLI 策略。

使用自定义代理

自定义代理是 Copilot 的专门化版本。自定义代理帮助 Copilot 处理独特的工作流、特定的编码规范以及专业的使用场景。

Copilot CLI 包含一组默认的自定义代理,用于常见任务

智能体 描述
探索 执行快速代码库分析,使您能够在不向主要上下文添加内容的情况下询问代码相关问题。
任务 执行测试、构建等命令,在成功时提供简要摘要,失败时提供完整输出。
通用用途 处理需使用完整工具集和高质量推理的复杂多步骤任务,在单独的上下文中运行,以保持主要对话的清晰聚焦。
代码审查 审查更改,专注于仅显示真实问题,降低噪音。

CLI 使用的 AI 模型可以选择将任务委派给子代理进程,该进程使用具有特定专长的自定义代理运行,如果模型判断这样可以更有效地完成工作。模型同样也可以选择直接在主代理中处理该工作。

您可以使用 Markdown 文件(称为代理配置文件)定义自己的自定义代理,文件中指定代理应具备的专长、可使用的工具以及其应如何响应的具体指示。

您可以在用户、仓库或组织/企业层级定义自定义代理

类型位置范围
用户级自定义代理本地 ~/.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 中引导代理

© . This site is unofficial and not affiliated with GitHub, Inc.