github/copilot-sdk

项目概览

它已将 Copilot CLI 背后的同一套生产验证智能体运行时开放为六种语言的可编程 SDK。

项目类型

AI Agent · AI 编程

应用场景

自动化执行

部署方式

查看项目说明

License

MIT

适合谁

• 希望在现有应用中嵌入规划、工具调用和文件编辑能力，同时不愿自行开发完整智能体编排运行时的开发团队。
• 采用 Python、TypeScript、Go、.NET、Java 或 Rust，并希望通过原生语言客户端接入统一智能体能力的多技术栈团队。
• 需要扩展自定义工具，并要求应用能够批准、拒绝或定制工具调用的受控自动化场景。

核心能力

• 应用可通过 SDK 以编程方式调用经过生产验证的 Copilot CLI 智能体运行时，由运行时执行规划、工具调用、文件编辑及其他智能体行为。该能力已可用，价值在于减少应用自行实现核心编排逻辑的工作量。
• 项目为 Python、TypeScript、Go、.NET、Java 和 Rust 提供客户端库，使不同技术栈能够通过对应语言接口接入同一类智能体能力。该能力已可用，适合多语言应用或平台团队统一接入方式。
• SDK 通过 JSON-RPC 自动管理 Copilot CLI 服务进程的生命周期，降低应用自行启动、连接和维护底层进程的复杂度。该能力已可用，但 Go、Java 和 Rust 用户仍需注意 CLI 默认不随 SDK 捆绑。
• 应用可配置受支持模型提供商的自有 API 密钥，以替代标准 GitHub 认证。该能力已可用，便于复用现有密钥与模型服务账户，但不支持 Microsoft Entra ID、托管身份或第三方身份提供商。
• 开发者可定义自有智能体、技能和工具，用业务专属行为与外部能力扩展运行时。该能力已可用，适合把通用智能体执行能力嵌入具体产品流程。
• 应用可通过权限处理器批准、拒绝或定制工具调用，在运行时执行工具前施加应用侧策略。该能力已可用，可用于控制敏感操作和建立人工或规则审批边界。

限制与风险

• Go、Java 和 Rust SDK 默认不包含 Copilot CLI。选择这些语言时，应把 CLI 的获取、版本管理和运行条件纳入部署设计，不能假设仅安装 SDK 包即可具备完整运行时。
• 自带密钥模式不支持 Microsoft Entra ID、托管身份或第三方身份提供商。若组织强制使用无密钥身份或联合身份，该模式无法满足要求。
• SDK 使用会计入 Copilot 用量额度并关联计费。试点前应估算调用模式与预算，生产使用时还需持续监控额度消耗。

如何开始

• 项目可通过标准包管理器安装，对应渠道包括 npm、PyPI、NuGet、Go 引用、crates.io 和 Maven Central；首个成功路径可从安装所选语言的 SDK 开始，例如 TypeScript 使用 npm 包。
• 接入前需确定使用 GitHub Copilot 订阅还是受支持模型提供商的 API 密钥；Go、Java 和 Rust SDK 默认不捆绑 Copilot CLI，需要单独确认 CLI 条件。
• 完成 SDK 接入后，定义所需智能体行为、自定义技能或工具，并配置权限处理器对工具调用进行批准、拒绝或定制，再验证规划、调用和文件编辑的完整执行链路。

核验依据

• README: The GitHub Copilot SDK exposes the same engine behind Copilot CLI: a production-tested agent runtime you can invoke programmatically. No need to build your own orchestration—you d…
• README: The GitHub Copilot SDK is generally available and follows semantic versioning.
• README: Embed Copilot's agentic workflows in your application with the GitHub Copilot SDK for Python, TypeScript, Go, .NET, Java, and Rust.
• README: All SDKs communicate with the Copilot CLI server via JSON-RPC: ``` Your Application ↓ SDK Client ↓ JSON-RPC Copilot CLI (server mode) ``` The SDK manages the CLI process lifecycle…
• README: Yes, the GitHub Copilot SDK supports BYOK (Bring Your Own Key). You can configure the SDK to use your own API keys from supported LLM providers (e.g. OpenAI, Azure AI Foundry, Ant…

内容核验时间：