专题资料¶
与技术路线无关的资料：包括用于查阅信息的参考页面，以及两个同时适用于 .NET 和 Python 的 Copilot CLI 实验。
参考资料¶
| 文档 | 适用场景 |
|---|---|
| 架构 | 需要查看系统图、请求时序或数据模型 |
| 系统地图 | 希望以交互方式探索该架构 |
| 自定义代理 | 需要编写或调用 .agent.md |
| 钩子与治理 | 正在配置 preToolUse 门禁或查看审计跟踪 |
| 技能 | 希望了解五项技能的作用以及 Copilot 选择它们的时机 |
| 故障排除 | 出现故障 ——从这里开始 |
扩展实践¶
这些可选实验介绍 Copilot CLI 而不是 SDK。它们与编程语言无关，因此位于此处而非某个技术路线中——可以从 .NET 或 Python 路线开始。
| 实验 | 内容 | 用时 |
|---|---|---|
| 自定义代理 | .agent.md 文件，以及借助代理审查有意保留的代码异味 |
约 20 分钟 |
| 治理钩子 | Shell 钩子、安全门禁和审计日志 | 约 20 分钟 |
在 SDK 中，与钩子式控制对应的机制是工具定义——请参阅 .NET 实验 03 或 Python 实验 03。
常见问题速查¶
| 症状 | 请参阅 |
|---|---|
MSB3923 ——无法下载 Copilot CLI |
故障排除 |
| CodeQL 作业显示“已跳过” | 故障排除 ——私有仓库中的预期行为 |
Model "..." is not available |
故障排除 |
| 端口 5050/5051 已被占用 | 故障排除 |
MSB1003 ——未找到项目或解决方案 |
解决方案位于 src/AgentOrchestrator/AgentHQDemo.slnx |
| 某个钩子似乎没有运行 | 钩子与治理 |