延伸主題¶
不受技術路線限制的內容：包含供查閱的參考頁面，以及同時適用於 .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 作業顯示「skipped」 | 疑難排解 — 在私人儲存庫中屬於預期情況 |
Model "..." is not available |
疑難排解 |
| 連接埠 5050/5051 已在使用中 | 疑難排解 |
MSB1003 — 找不到專案或解決方案 |
解決方案位於 src/AgentOrchestrator/AgentHQDemo.slnx |
| 掛鉤似乎未執行 | 掛鉤與治理 |
相關資源¶
- .NET 實作練習 · .NET 示範
- Python 實作練習 · Python 示範
- 根目錄 README — 快速入門與端點參考
AGENTS.md— AI 代理程式的儲存庫規則