.NET 實作課程¶
以下是針對 AI Genius S5E2 — Agent HQ Demo，重點在於 GitHub Copilot SDK。這是 .NET 學習路徑：選擇 一個 學習路徑 — .NET 或 Python — 並依序完成。兩套技術堆疊可同時執行，因為 .NET 使用 5050/5051 而 Python 使用 5070.
必要條件¶
| 需求 | 注意事項 |
|---|---|
| .NET 10 SDK | dotnet --version 應回報 10.x |
| GitHub Copilot CLI | npm install -g @github/copilot，並已使用 Copilot 存取權登入 |
git, curl, jq |
jq 由選擇性的 governance-hooks 實作課程使用 |
| 終端機與編輯器 | 建議使用 VS Code — 存放庫隨附 .vscode/mcp.json |
開始前請先確認：
🎯 SDK 學習路徑¶
這是核心路徑。完整完成大約需要兩小時。
| # | 實作課程 | 您將進行的操作 | 時間 |
|---|---|---|---|
| 01 | 環境設定 | 建置並執行應用程式與 SDK 範例專案 | 約 15 分鐘 |
| 02 | 第一次對話 | 串流傳回回應；在執行階段探索模型 | 約 20 分鐘 |
| 03 | 工具 | 讓模型透過以下項目呼叫您的 C#： CopilotTool.DefineTool |
約 20 分鐘 |
| 04 | 事件 | 讀取真正的工作階段事件生命週期 | 約 20 分鐘 |
| 05 | 工作階段 | 跨重新啟動持久保存並繼續交談 | 約 20 分鐘 |
| 06 | MCP | 連接 MCP 伺服器，以使用非自行撰寫的工具 | 約 20 分鐘 |
| 07 | 總結 | 整合成果、清理環境並選擇下一步 | 約 10 分鐘 |
可執行範例¶
實作課程 03–06 由真正的主控台專案支援，每個實作課程各有一個子命令：
dotnet run --project src/AgentOrchestrator/samples/SdkLabs -- tools
dotnet run --project src/AgentOrchestrator/samples/SdkLabs -- events
dotnet run --project src/AgentOrchestrator/samples/SdkLabs -- sessions
dotnet run --project src/AgentOrchestrator/samples/SdkLabs -- mcp
這些實作課程中的每個命令，都已針對真正的 Copilot CLI 執行，輸出也依原樣貼上。
📎 額外實作課程 — 不屬於 SDK¶
這些內容很實用，但涵蓋的是 Copilot CLI 以及一般應用程式開發，而不是 SDK。此內容為選修，且與編號的學習路徑彼此獨立。
| 實作課程 | 涵蓋範圍 | 為何屬於額外內容 |
|---|---|---|
| 擴充 API | ASP.NET Core、EF Core、xUnit | 將 Copilot 作為程式設計助理；未使用任何 SDK |
| 自訂代理程式 | .agent.md 檔案、代理程式輔助檢閱 |
這是兩條學習路徑共用的 Copilot CLI 功能 — 歸類於 深入解析 |
| 治理掛鉤 | Shell 掛鉤、安全性防護閘門、稽核記錄 | 這是 Copilot CLI 功能；對應的 SDK 作法請參閱 實作課程 03 |
只有 擴充 API 是 .NET 專用內容。自訂代理程式與治理掛鉤是不受語言限制的 CLI 實作課程，因此網站將它們列在 深入解析 → 延伸實作 ，而且兩條學習路徑共用同一份內容。
慣例¶
- 命令可以 直接複製貼上執行 從存放庫根目錄
- 畫面會顯示預期輸出，方便您確認每個步驟
- ⚠️ 表示略過後會造成問題的項目
- 💡 表示選擇性的延伸練習
⚠️ 在您「修正」任何項目之前¶
此存放庫 刻意地 包含四種有缺陷的程式碼模式，供程式碼檢閱示範使用：
- 中的 N+1 查詢：
GetTransactionsWithSegmentsAsync - 中的 null 檢查缺漏：
GetTransactionAsync - 中的輸入驗證缺漏：
AddTransactionAsync - 中的硬式編碼臨界值：
PredictSegmentAsync
額外內容 — 自訂代理程式 要求您 找出 它們。請勿修復 — 檢閱練習仰賴它們繼續存在。請參閱
AGENTS.md.