企业级自定义代理发布前，先在 .github-private 仓库的 .github/agents 目录中进行私测，确认效果后再移到 agents 根目录发布给全组织。审计日志中用 actor:Copilot 过滤可以监控代理的使用记录。

GitHub Copilot 自定义代理测试与发布：企业级代理上线流程

前提条件

组织或企业已为自定义代理功能进行基础配置（Copilot Custom Agents 已启用）。

第一步：创建测试代理

在 .github-private 仓库中：

1. 创建目录 .github/agents/
2. 在该目录下创建代理文件（如 my-test-agent.agent.md）
3. 合并到默认分支

.github-private/
└── .github/
    └── agents/
        └── my-test-agent.agent.md    ← 测试阶段放这里

第二步：测试代理效果

1. 访问 https://github.com/copilot/agents
2. 在下拉框中选择 .github-private 仓库
3. 选择你的测试代理
4. 发送提示词进行测试
5. 在 Recent sessions 中查看 Session 详情，检查代理行为是否符合预期
6. 根据测试结果调整代理配置，重复测试

第三步：发布到组织

测试满意后，将代理文件移动到 .github-private 仓库的根级 agents/ 目录：

.github-private/
└── agents/
    └── my-agent.agent.md    ← 发布后移到这里，组织所有用户可用

合并到默认分支后，代理立即对组织所有成员可用。

监控代理使用

在企业审计日志中过滤：

actor:Copilot

查看 Copilot 代理（包括自定义代理）的所有活动记录。

测试阶段的配置技巧

缩小测试范围：测试期间可以在代理 frontmatter 中设置：

---
target: vscode    # 只在 VS Code 中可见，不在 GitHub Web 上暴露
---

保持快速迭代：代理配置文件修改后需要合并到默认分支才生效，测试时可以用 PR 快速合并到默认分支来加速迭代。

常见问题

Q: 测试阶段的代理会被组织其他成员看到吗？

A: 放在 .github-private/.github/agents/ 下的代理（测试位置）只对有权限访问该仓库的人可见。放到根级 agents/ 目录后才对全组织开放。

Q: 如何快速回滚发布的代理？

A: 把代理文件从 agents/ 目录移走或删除，合并到默认分支，代理立即对用户不可见。已在进行的会话不受影响。

Q: 自定义代理目前是正式功能吗？

A: 自定义代理目前处于**公开预览（Public Preview）**阶段，功能可能会有变化。建议关注 GitHub 的更新通知后再大规模推广。