Copilot SDK

将 Copilot 会话、流式输出与工具调用接入应用，并选择运行与认证方式。

Copilot SDK 将会话、事件、工具和 Hooks 提供给应用代码。常见方式是 SDK 通过 JSON-RPC 与 Copilot runtime 通信；runtime 可以由 SDK 管理为 CLI 子进程，也可以作为独立服务运行。实验性的进程内模式保留 JSON-RPC 协议，但不启动 CLI 子进程。

先选择运行方式

场景	文档
首次调用、接收流式响应、定义工具	快速开始
随应用分发匹配 runtime	自动管理 CLI
固定本机 CLI 路径或使用 Go 等 SDK	本地 CLI
在宿主进程加载原生库	进程内 runtime
长期运行的后端或多个客户端共用服务	后端服务
多个用户、工作区或租户	多租户配置、扩展与存储

再选择身份来源

本机个人工具可以使用已登录 CLI 的凭据。面向用户的应用通常通过GitHub OAuth接入；服务自动化可以使用组织安装令牌。

使用自有模型时采用BYOK，Azure 部署还可用Managed Identity。令牌优先级见认证，短期用户令牌的回调刷新见会话令牌轮换。

不把 SDK 选项当作应用授权

SDK 提供会话状态和会话级身份机制，但请求路由、用户登录、会话归属和业务工具授权由应用负责。共享服务器必须显式设置可用工具与身份，不能用个人 CLI 默认配置直接承接所有用户。

会话与交互

代理循环：模型轮次、idle 与任务完成。
持久化与恢复模型配置：继续工作、清理资源与 Auto tier。
事件流与工具交互事件：渲染进度、归属和用户请求。
上下文清除：在工具中启动新的模型上下文。
会话软上限：处理 AI Credits 预算。
Steering 与排队：处理中接收新的输入。

扩展与输入输出

MCP 与 Skills：提供工具和领域指令。
插件目录：按进程、会话或宿主范围组合扩展。
自定义代理与 Fleet：限定职责、委派与并行协作。
图片输入与来源引用：处理附件及最终答案的来源位置。
客户端身份元数据：为连接标记遥测归属。

Hooks

SDK Hooks涵盖工具执行前后、输入转换、会话生命周期、停止前验证和错误恢复。SDK 回调与 CLI/云端的配置文件 Hooks 分开说明。

远程运行与维护

云端会话与本地会话远程访问：区分执行位置和同步访问。
权限处理：配置实际授权与目录范围。
用量与配额及OpenTelemetry：观察运行和计费信号。
Agent Framework：接入跨提供商工作流。
CLI 兼容性、运行排障与MCP 排障：核对协议和故障阶段。