架构概览
每个Copilot SDK 集成都遵循相同的核心模式：应用程序与 SDK 通信，该 SDK 通过 JSON-RPC 与 Copilot CLI 通信。 在设置中， CLI 的运行方式、 用户身份验证方式以及 会话的管理方式等都发生了哪些更改。
以下设置指南可帮助你为方案配置每个层。
你是谁？
🧑 💻 爱好者
你正在构建个人助理、侧项目或实验应用。 你希望以最简单的方式在代码中获得 Copilot。
首先：
- ** 默认设置（随附的 CLI）**—SDK 会自动包含 CLI，安装即可使用
- ** 本地 CLI 设置**—使用你自己的 CLI 二进制文件或正在运行的实例（高级）
🏢 内部应用开发人员
你正在为团队或公司构建工具。 用户是需要对其企业GitHub帐户或组织成员身份进行身份验证的员工。
首先：
- ** GitHub OAuth 设置** - 让员工使用其GitHub帐户登录
- ** 后端服务设置** - 在内部服务中运行 SDK
如果扩展超出单个服务器：
🚀 应用开发人员（ISV）
你要为客户构建产品。 你需要为用户处理身份验证——要么通过 GitHub，要么自行管理用户身份。
首先：
- ** GitHub OAuth 设置** - 让客户使用 GitHub 登录
- ** BYOK （自带密钥）** - 使用自己的模型密钥自行管理标识
- ** 后端服务设置** - 通过服务器端代码为产品提供支持
用于生产：
🏗️ 平台开发人员
你正在将 Copilot 嵌入到平台（API、开发人员工具或其他开发人员所构建的基础结构）中。 您需要对会话、扩展性和多租户进行精细控制。
首先：
根据身份验证模型：
- ** GitHub OAuth 设置** - 对于经过GitHub身份验证的用户
- ** BYOK （自带密钥）**—用于自主管理的标识和模型访问
决策矩阵
使用此表根据需要执行的操作查找正确的指南：
| 所需内容 | 指南 |
|---|---|
| 快速入门 | |
| 默认设置（随附的 CLI） | |
| 使用自己的 CLI 二进制文件或服务器 | |
| 本地 CLI 设置 | |
| 用户使用 GitHub 登录 | |
| GitHub OAuth 设置 | |
| 使用自己的模型密钥（OpenAI、Azure 等） | |
| BYOK （自带密钥） | |
| 具有托管标识的 Azure BYOK （无 API 密钥） | |
| 支持 BYOK（自带密钥）的 Azure 托管标识 | |
| 在服务器上运行 SDK | |
| 后端服务设置 | |
| 为并发用户配置 SDK 选项 | |
| 多租户与服务器部署 | |
| 服务多个用户 / 水平扩展 | |
| 可扩展性和多租户 |
配置比较
先决条件
所有指南都假定你有：
- 已安装以下 SDK 之一（Node.js、Python 和 .NET SDK 会自动包含 CLI）：
- Node.js：
npm install @github/copilot-sdk - Python：
pip install github-copilot-sdk - Go：
go get github.com/github/copilot-sdk/go（需要单独安装命令行界面） - .NET：
dotnet add package GitHub.Copilot.SDK
- Node.js：
如果你是全新的，请先从 构建你的第一个由 Copilot 提供支持的应用 开始，然后返回此处进行生产配置。
后续步骤
从上面的 决策矩阵 中选择与情况匹配的指南，或从最接近角色的角色描述开始。