使用自定义代理
自定义代理是 Copilot 的专门化版本。自定义代理帮助 Copilot 处理独特的工作流、特定的编码规范以及专业的使用场景。
Copilot CLI 包含一组默认的自定义代理,用于常见任务
| 智能体 | 描述 |
|---|---|
| 探索 | 执行快速代码库分析,使您能够在不向主要上下文添加内容的情况下询问代码相关问题。 |
| 任务 | 执行测试、构建等命令,在成功时提供简要摘要,失败时提供完整输出。 |
| 通用用途 | 处理需使用完整工具集和高质量推理的复杂多步骤任务,在单独的上下文中运行,以保持主要对话的清晰聚焦。 |
| 代码审查 | 审查更改,专注于仅显示真实问题,降低噪音。 |
CLI 使用的 AI 模型可以选择将任务委派给子代理进程,该进程使用具有特定专长的自定义代理运行,如果模型判断这样可以更有效地完成工作。模型同样也可以选择直接在主代理中处理该工作。
您可以使用 Markdown 文件(称为代理配置文件)定义自己的自定义代理,文件中指定代理应具备的专长、可使用的工具以及其应如何响应的具体指示。
您可以在用户、仓库或组织/企业层级定义自定义代理
| 类型 | 位置 | 范围 |
|---|---|---|
| 用户级自定义代理 | 本地 ~/.copilot/agents 目录 | 所有项目 |
| 仓库级自定义代理 | 本地和远程仓库中的 .github/agents 目录 | 当前项目 |
| 组织和企业级自定义代理 | 组织或企业的 .github-private 仓库中的 /agents 目录 | 组织和企业账户下的所有项目 |
若出现命名冲突,系统级代理会覆盖仓库级代理,仓库级代理会覆盖组织级代理。
自定义代理可通过三种方式使用
-
在 CLI 的交互界面中使用斜杠命令,从可用自定义代理列表中进行选择
/agent -
在提示中直接调用自定义代理
Use the refactoring agent to refactor this code blockCopilot 将自动推断您想使用的代理。
-
使用命令行选项指定您想使用的自定义代理。例如
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 服务器
-
使用以下斜杠命令
/mcp add -
填写要添加的 MCP 服务器详细信息,可使用 Tab 键在字段间切换。
-
按 Ctrl+S 保存详情。
已配置的 MCP 服务器详情存储在 mcp-config.json 文件中,默认位于 ~/.copilot 目录。您可以通过设置 COPILOT_HOME 环境变量更改此位置。有关服务器定义的 JSON 结构,请参阅 使用模型上下文协议(MCP)扩展 GitHub Copilot 云代理。
在 Copilot CLI 中添加和管理 MCP 服务器的详细信息,请参阅 为 GitHub Copilot CLI 添加 MCP 服务器。
后续步骤
若想了解在任务执行期间如何引导并细化代理行为以保持工作进度,请参阅 在 GitHub Copilot CLI 中引导代理。