Thanks to visit codestin.com
Credit goes to docs.github.com

Skip to main content

调用自定义代理

使用Copilot 命令行界面(CLI)中的自定义代理、技能和MCP服务器来增强其功能。

谁可以使用此功能?

GitHub Copilot 命令行界面 (CLI) 适用于所有 Copilot 计划。 如果从组织收到 Copilot,必须在组织的设置中启用 Copilot 命令行界面(CLI) 策略。

使用 自定义代理

          自定义智能体 是 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) 中的智能体