跳轉到內容

Python 實作課程

針對 AI Genius S5E2 — Agent HQ Demo的 GitHub Copilot SDK. 這是 Python學習路線：選擇 一個 學習路線 — Python或 .NET ——並按順序工作。由於Python使用 5070 和.NET使用 5050/5051.

必要條件

需求 備註
Python 3.11+ python3 --version 應報告 3.11 或以後
uv 安裝相依並執行Python命令
GitHub Copilot CLI 使用Copilot訪問；SDK與之交談
git, curl, jq curl 和 jq 用於API檢查和附加
終端+編輯器 推薦使用Visual Studio Code - 存放庫包含 .vscode/mcp.json

在開始之前驗證:

python3 --version   # 3.11+
uv --version
copilot --version   # 1.x

核心Python命令，從應用程式目錄執行:

cd src/AgentOrchestrator-python
uv sync
uv run uvicorn app.main:app --port 5070   # API + UI on one port
uv run pytest                             # 30 tests
uv run ruff check .

🎯 SDK路徑

核心路由。從頭到尾大約需要兩小時。

# 實作課程 你將要做的 時間
01 環境設定 安裝相依套件、執行FastAPI應用程式並進行基本驗證SDK範例 ~15分鐘
02 第一次聊天 串流回應；在執行時發現模型 ~20分鐘
03 工具 讓模型呼叫你的Python， @define_tool ~20分鐘
04 事件 閱讀真實的工作階段生命週期事件 ~20分鐘
05 工作階段 永續保存並跨重啟恢復對話 ~20分鐘
06 MCP 連線MCP伺服器以供你未寫的工具使用 ~20分鐘
07 總結 合併、清理、選擇下一步 約10分鐘

可執行範例

03-06實驗由真實Python模組支援，一個子命令對應一個實驗：

cd src/AgentOrchestrator-python
uv run python -m sdk_labs tools
uv run python -m sdk_labs events
uv run python -m sdk_labs sessions
uv run python -m sdk_labs mcp

範例命令由真實模組支援，位於 sdk_labs模型文字和/或診斷警告可能因帳戶、SDK版本和本地Copilot CLI設定而異。

📎 額外實驗 — 不是SDK

有用，但它們覆蓋了 Copilot CLI 和一般應用程式開發，而不是SDK。可選，與編號路徑無關。

實作課程 覆蓋 為什麼額外
擴充套件API FastAPI, SQLModel, pytest 作為程式碼輔助工具的Copilot CLI；不涉及SDK
自訂代理程式 .agent.md 檔案與代理程式輔助審查 Copilot CLI功能，共享於兩個學習路線——位於 延伸主題
治理掛鉤 Shell 掛鉤、安全閘門與稽核記錄 作為程式碼輔助工具的Copilot CLI；SDK等效物位於 實作課程 3

只有 擴充 API 是 Python 專屬內容。自訂代理程式與治理掛鉤是與語言無關的 CLI 實作課程，因此網站將其列在 延伸主題 → 實作延伸內容，而不在每條學習路線中重複提供。

慣例

  • 命令是 可複製貼上的 從存放庫根目錄複製，除非一個實驗說要 cd src/AgentOrchestrator-python
  • 預期輸出顯示以供您確認每個步驟
  • ⚠️ 標示略過後可能導致問題的重要事項
  • 💡 提供額外的加分項

⚠️ 在你“修復”之前

Python 實作 故意 包含四個錯誤的程式碼模式 app/services/retail_analytics.py, 用於程式碼審查示範:

  • N+1 查詢 get_transactions_with_segments
  • 缺少 null 檢查 get_transaction
  • 缺少輸入驗證 add_transaction
  • 硬編碼閾值 predict_segment

這些問題與 .NET 版本的程式碼異味完全相同，因此同一份解答適用於兩條學習路線。額外課程 — 自訂代理程式 會要求你 找到 它們。不要修復它們——審查練習相依它們仍然存在。參見 AGENTS.md.