安装和使用 Agent Apps
启用合作伙伴代理、完成个人授权,并从 GitHub 委派任务。
Agent Apps 是提供代理能力的 GitHub Apps,由合作伙伴把自己的服务、工具和流程接入 GitHub。它们基于 Copilot cloud agent 运行,当前为 public preview。
使用前提
App 必须安装到目标仓库所属的个人账号或组织,并启用其 agent features。仓库所在组织属于企业时,还需要企业 Copilot 设置开启 Agent apps 策略。
在 GitHub Marketplace 的 Agent Apps 分类查看应用,从 App 页面点击 Add,安装到相应账号或组织。安装界面会标明代理功能,并询问是否启用。
安装与授权是两步
首次使用时,还需按 GitHub 提示完成 OAuth 授权,App 才能代表你运行并访问伙伴功能。组织已经安装,不代表每位使用者的首次授权都已完成。
App 可以定义自己的 custom agent、prompt、model、tools 和 MCP servers。其伙伴 MCP 使用 GitHub 签发的 JWT assertion 识别账号和 App,不需要用户手动维护对应的额外凭据。
这套 Agent App 授权机制,不等同于仓库 MCP对任意远程 OAuth 服务器的支持。
委派任务
| 入口 | 操作 |
|---|---|
| Agents 标签页或面板 | 在提示框下选择 App 的 agent,填写任务并发送 |
| Issue | 在 Assignees 中选择对应 App |
| PR 评论 | 从自动补全选择 @AGENT-NAME,并说明任务 |
| GitHub Mobile | 使用相应 Agents、Issue 或 PR 入口 |
例如可以要求某个具备相关能力的 App 为新的结账流程增加 feature flag;具体任务仍应匹配伙伴提供的服务和权限,不能把示例当作每个 App 都支持的功能。
模型和费用
默认模型范围由安装位置的组织或个人账号启用的模型决定。若企业采用按团队管理模型访问的模式,Agent Apps 的可用模型由企业层控制。
AI 使用量计入 Copilot 订阅,会话与 cloud agent 一样消耗 AI credits。这说明 Copilot 推理费用归属,不能据此断言伙伴的全部外部服务也免费。
排查不可用
依次确认安装目标是否正确、App 的 agent features 是否启用、企业 Agent apps 策略是否允许,以及首次 OAuth 是否完成。普通 GitHub App 能访问仓库,不代表它已经作为代理出现在选择菜单中。