microsoft/copilot-sdk
开发工具把 Copilot 代理运行时及其规划、工具调用和文件编辑能力嵌入自有应用的多语言 SDK。
项目介绍
Microsoft Copilot SDK 把 Copilot CLI 背后的代理运行时以 Python、TypeScript/Node.js、Go、.NET、Java 和 Rust 包的形式开放出来,应用不必自己实现编排,就能把规划、工具调用、文件编辑等代理行为交给 Copilot 处理。它面向把代理集成进产品或服务的开发者,而不是寻找聊天应用的普通用户。项目正从 GitHub Copilot SDK 分阶段更名为 Microsoft Copilot SDK,已有包名和命名空间短期内可能仍用旧名,现有用户无需立即迁移(见更名公告)。
架构
各语言 SDK 都通过 protocol-4 JSON-RPC 驱动同一个代理运行时。默认情况下,SDK v2 通过 C ABI 把原生 Rust 运行时加载进应用进程,不嵌入 Node.js,也不另起运行时进程;运行时在整个应用生命周期内保持加载,进程内托管既没有崩溃隔离,也不是沙箱(见进程内运行时说明)。需要崩溃隔离或按客户端配置时,SDK 可以通过 stdio 或 TCP 把运行时作为子进程启动;也可以自行运行多租户的独立运行时服务 copilot-runtime --server,再通过 TCP 接入(见连接独立运行时服务)。
快速使用
- 按语言安装 SDK,例如
npm install @microsoft/copilot-sdk、pip install microsoft-copilot-sdk、go get github.com/microsoft/copilot-sdk/go/v2、dotnet add package Microsoft.Copilot.SDK或cargo add copilot-sdk。Java 使用 Maven 坐标com.microsoft:copilot-sdk,并分别参考 Maven 与 Gradle 说明。 - 确认兼容的运行时可用:Node.js 与 .NET 自带平台产物,Python 会自动下载,Rust 默认特性已捆绑;Go 应用需要运行打包器或提供兼容运行时包,Java 应用需要添加对应平台的运行时 classifier。创建客户端前先按各语言 README 操作。
- 选择认证方式:已登录的 Copilot CLI 会话、GitHub OAuth App 用户令牌、
COPILOT_GITHUB_TOKEN/GH_TOKEN/GITHUB_TOKEN环境变量,或使用自有提供商密钥的 BYOK(见认证文档)。 - 按入门指南和对应语言的 cookbook 创建客户端并完成第一次代理调用。
使用约束
- 标准用法需要 GitHub Copilot 订阅,每个提示都计入 Copilot 用量额度,计费方式与 Copilot CLI 相同(见计费说明)。
- BYOK 不需要 GitHub 认证,但只支持密钥认证,不支持 Microsoft Entra ID、托管身份和第三方身份提供商(见 BYOK 文档)。
- 默认开放 Copilot CLI 的第一方工具,效果类似
--allow-all;工具调用仍要由各 SDK 的权限处理器批准、拒绝或定制。 - 表单征询 schema 应只依赖建模的
properties和required字段。Node.js 和 Rust 会保留额外的线上元数据和属性顺序,Python、Go、.NET、Java 会重建 schema,不保证同样的保留行为。 - 项目已正式可用,遵循语义化版本,采用 MIT 许可证。
HotRepo 点评
在 2026-11-18 的 Java 日榜上,该项目以当日新增 10 Star 排到第 6 名,当时累计 10,686 Star、1,530 Fork。单次快照只说明它在该榜上有稳定表现,不足以判断更大范围的趋势。更值得关注的是覆盖面:六个官方支持语言共用同一套运行时协议,并给出进程内、子进程和独立服务三种托管方式,这对实际选型比当天的 Star 数更有参考价值。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- github/copilot-sdk把 GitHub Copilot 的智能体循环嵌入自己的应用,省去编排开发,适合已有 Copilot 或自带模型密钥的团队。
- github/copilot-cli把 Copilot 编程智能体放进终端的 AI 编码助手,能结合 GitHub 上下文规划、编辑和调试代码。
- github/awesome-copilot一个 Copilot 智能体、指令文件、技能与插件的社区目录,配套可搜索网站,帮你找到并安装现成配置。
- microsoft/power-platform-skills让 Copilot CLI 与 Claude Code 通过可安装插件构建并部署 Power Platform 应用。
- google-gemini/gemini-skills为编程助手提供关于 Gemini API、SDK 和实时接口的上下文技能,帮助生成更准确的调用代码。