技能 azure-hosted-copilot-sdk
📦

azure-hosted-copilot-sdk

安全 ⚙️ 外部命令🌐 網路存取📁 檔案系統存取🔑 環境變數

將 Copilot SDK 應用程式部署至 Azure

開發者在建構和託管 AI 驅動應用程式時,使用 GitHub Copilot SDK 常遇到困难。此技能可搭建專案架構、將 Copilot SDK 整合至現有程式碼庫、設定 Azure 模型,並部署至 Azure Container Apps。

支援: Claude Codex Code(CC)
🥉 75 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「azure-hosted-copilot-sdk」。 搭建新的 Copilot SDK 專案

預期結果:

已使用 azure-samples/copilot-sdk-service 範本建立新的專案結構。API 服務就緒於 /api,具有 Express 端點。網頁 UI 在 React/Vite 上執行。基礎架構已設定為 Azure Container Apps 部署。

正在使用「azure-hosted-copilot-sdk」。 將 /api/chat 端點新增至現有 Express 應用程式

預期結果:

已新增 @github/copilot-sdk 相依套件。建立了具有工作階段管理和串流回應的聊天路由。設定本機開發的 GitHub token 驗證。

安全審計

安全
v1 • 2/25/2026

This Microsoft skill contains only Markdown documentation files with instructional bash commands for Azure deployment workflows. All 194 static findings are false positives: backtick patterns are documentation examples (not code execution), URLs are official Microsoft/GitHub references, and environment variable access is legitimate for Azure credential management. No executable code or malicious patterns detected.

5
已掃描檔案
403
分析行數
4
發現項
1
審計總數
審計者: claude

品質評分

45
架構
100
可維護性
87
內容
50
社群
100
安全
83
規範符合性

你能建構什麼

全新 Copilot 應用程式開發

從頭開始啟動具有 Copilot SDK 整合的新專案

將 Copilot 新增至現有應用程式

將 Copilot SDK 端點整合至現有網頁應用程式,無需重寫基礎架構

企業 Azure 模型部署

使用具有受控身分驗證的 Azure AI Foundry 或 Azure OpenAI 部署 Copilot 應用程式

試試這些提示

搭建新的 Copilot SDK 專案
在 Azure 上建立新的 Copilot SDK 專案。我想從頭開始建構一個具有 React UI 和 Express API 的聊天應用程式。
將 Copilot SDK 整合至現有應用程式
將 Copilot SDK 新增至我現有的 Express.js 應用程式。我有一個 /api/routes 資料夾,想要在 /api/chat 新增一個 AI 聊天端點。
使用特定模型設定 Azure BYOM
為我的 Copilot SDK 應用程式設定 Azure BYOM。我有一個 Azure OpenAI 資源,在 https://myresource.openai.azure.com 有一個 o4-mini 部署。使用受控身分驗證。
將現有 Copilot SDK 應用程式部署至 Azure
我本機有一個運作中的 Copilot SDK 應用程式。請協助我使用 azd 將其部署至 Azure Container Apps,並設定適當的基礎架構。

最佳實務

  • 修改前請閱讀已搭建範本中的 AGENTS.md 以了解檔案用途
  • 使用 context7 MCP 工具取得最新的 Copilot SDK 文件範例和程式碼範例
  • 將 nginx proxy_read_timeout 增加至 300 秒,以避免多輪 AI 工作階段產生 504 錯誤

避免

  • 不要在現有專案內執行 azd init - 這會覆蓋檔案。請先搭建至暫存目錄。
  • 不要對 store:false 使用 wireApi 'responses' - 這會破壞多輪工具呼叫。請改用 'completions'。
  • 不要將 apiVersion 置於 Azure 提供者的頂層 - 它必須位於 azure: { apiVersion: '...' } 之下

常見問題

哪些模型可與 Copilot SDK 中的 Azure BYOM 搭配使用?
只有 o 系列(o3、o3-mini、o4-mini)和 gpt-5 系列模型支援 BYOM。gpt-4o 和 gpt-4.1 等模型無法使用,因為它們不支援 SDK 的加密內容格式。
如何修正 'gh auth token' 失敗?
執行 'gh auth login' 進行驗證,然後執行 'gh auth refresh --scopes copilot' 新增所需的 copilot scope。必須安裝 GitHub CLI。
為什麼我的 Copilot SDK 工作階段會懸掛或超時?
檢查 nginx.conf.template 並將 proxy_read_timeout 增加至 300 秒。預設 60 秒超時會導致長時間執行的 AI 工作階段出現 504 錯誤。
如何探索可用的 Azure 模型部署?
使用 'az cognitiveservices account deployment list --name <resource> --resource-group <rg>'。SDK 的 listModels() 僅回傳 GitHub 模型,而非 Azure 部署。
GitHub 預設和 Azure BYOM 之間有何差異?
GitHub 預設使用 GitHub 託管模型並具有自動驗證。Azure BYOM 讓您使用自己的 Azure OpenAI 或 AI Foundry 部署,並使用 DefaultAzureCredential 進行企業級控制。
如何處理 Azure BYOM 的 token 過期?
Bearer token 在 1 小時後過期。生產環境中,請使用 DefaultAzureCredential.getToken() 為每個請求取得新的 token。不要為長時間執行的工作階段快取 token。