azure-hosted-copilot-sdk

原文：🇺🇸 英文

已翻译

在Azure上构建并部署GitHub Copilot SDK应用。适用场景：构建Copilot应用、创建Copilot应用、Copilot SDK、@github/copilot-sdk、搭建Copilot项目脚手架、基于Copilot的应用、部署Copilot应用、在Azure上托管、Azure模型、BYOM（自带模型）、使用自定义模型、Azure OpenAI模型、DefaultAzureCredential、自托管模型、Copilot SDK服务、集成Copilot的聊天应用、copilot-sdk-service模板、azd init copilot、CopilotClient、createSession、sendAndWait、GitHub Models API。不适用场景：使用Copilot（而非基于其构建）、Copilot扩展、未集成Copilot的Azure Functions、未使用Copilot SDK的通用Web应用、Foundry代理托管（请使用microsoft-foundry技能）、代理评估（请使用microsoft-foundry技能）。

118.9k次下载

来源microsoft/github-copilot-for-azure

添加于2026-02-24

NPX安装

npx skill4agent add microsoft/github-copilot-for-azure azure-hosted-copilot-sdk

SKILL.md 内容（中文）

查看翻译对照 →

在Azure上使用GitHub Copilot SDK

步骤1：路径选择

用户需求	操作
构建新的（空项目）	步骤2A（搭建脚手架）
向现有代码库添加新的SDK服务	步骤2B（在现有项目旁搭建脚手架）
将现有SDK应用部署到Azure	步骤2C（为现有SDK应用添加基础设施）
向现有应用代码中添加SDK	集成SDK
使用Azure/自定义模型	步骤3（BYOM配置）

步骤2A：搭建全新项目（从零开始）

azd init --template azure-samples/copilot-sdk-service

模板包含API（Express/TS）+ Web UI（React/Vite）+ 基础设施（Bicep）+ Dockerfile + 令牌脚本 — 请勿重复创建。请参阅SDK参考文档。

步骤2B：向现有代码库添加SDK服务

用户已有现有代码，希望在旁边新增一个Copilot SDK服务。将模板搭建到临时目录，将API服务+基础设施复制到用户的代码库中，调整

azure.yaml

以同时包含现有服务和新服务。请参阅现有项目部署参考文档。

步骤2C：部署现有SDK应用

用户已拥有可运行的Copilot SDK应用，需要Azure基础设施。请参阅现有项目部署参考文档。

步骤3：模型配置

三种模型路径（基于步骤2A/2B之上）：

路径	配置
GitHub默认模型	无需 `model` 参数 — SDK会自动选择默认模型
指定GitHub模型	`model: "<name>"` — 使用 `listModels()` 发现可用模型
Azure BYOM	`model` + `provider` ，并通过 `DefaultAzureCredential` 获取 `bearerToken`

请参阅模型配置参考文档。

步骤4：部署

按顺序调用azure-prepare（跳过其步骤0的路径选择——脚手架已完成）→ azure-validate → azure-deploy。

注意事项

在进行更改前，请阅读用户代码库中的
```
AGENTS.md
```
需要Docker环境（执行
```
docker info
```
检查）