别再自己写 Agent 编排层了，GitHub 官方 SDK 帮你搞定

别再自己写 Agent 编排层了，GitHub 官方 SDK 帮你搞定

构建 Agentic 应用最难的部分是什么？不是调 LLM 接口，而是编排层——如何管理会话状态、处理流式输出、定义工具调用、连接 MCP 服务器。这些基础设施每做一个项目就要重写一遍。

GitHub 刚刚放出了一个重磅工具：GitHub Copilot SDK（https://github.com/github/copilot-sdk），Star 数已经突破 20k，而且支持 Python、TypeScript、Go、.NET 四种语言。

这个 SDK 暴露的不是 Copilot 本身，而是Copilot CLI 背后的 Agent 运行时——经过生产环境验证的那种。你只需要定义 Agent 行为，剩下的规划、工具调用、文件编辑全部由 Copilot 处理。

5 分钟跑起来的例子

以 Python 为例，装好包之后三行代码就能建一个 Agent 会话：

import asyncio
from copilot import CopilotClient, PermissionHandler

client = CopilotClient()
await client.start()
session = await client.create_session({
    "model": "gpt-4.1",
    "on_permission_request": PermissionHandler.approve_all
})
response = await session.send_and_wait({"prompt": "What's 2+2?"})
print(response.data.content)

TypeScript、Go、C# 的 API 设计几乎完全对称，切换语言几乎没有学习成本。

工具调用才是核心能力

光调 LLM 不稀奇，关键是可以自定义工具让 Agent 调用。用 Pydantic 定义参数 schema，Copilot 会自动决定何时调用：

from copilot.tools import define_tool
from pydantic import BaseModel, Field

class GetWeatherParams(BaseModel):
    city: str = Field(description="城市名称")

@define_tool(description="获取城市天气")
async def get_weather(params: GetWeatherParams) -> dict:
    # 这里调用真实天气 API
    return {"temperature": "25°C", "condition": "晴天"}

session = await client.create_session({
    "model": "gpt-4.1",
    "tools": [get_weather]
})
await session.send_and_wait({
    "prompt": "北京今天天气怎么样？"
})

Agent 会自动推理出需要调用 get_weather，传入参数，拿回结果，再把结果整合进回复——整个流程不需要你写一行编排逻辑。

连接 MCP 服务器

Copilot SDK 原生支持 MCP（Model Context Protocol），一行配置就能接入 GitHub 官方 MCP Server，直接访问仓库、Issue、PR 数据：

session = await client.create_session({
    "model": "gpt-4.1",
    "mcp_servers": {
        "github": {
            "type": "http",
            "url": "https://api.githubcopilot.com/mcp/"
        }
    }
})

配合自定义工具，你可以做一个用自然语言管理 GitHub 项目的 Agent，帮团队自动化 Code Review、Issue 分类、PR 摘要——这些场景在企业内部工具链里需求巨大。

流式响应 & 会话持久化

生产级应用的两个标配能力：

• 流式输出：streaming: true 开启后，每个 token 生成都会触发 SessionEvent，前端可以实时展示打字效果。
• 会话持久化：用自定义 session ID 保存对话，支持跨进程恢复——用户关掉客户端再打开，上下文还在。

谁适合用？

这个 SDK 目前是 Technical Preview 阶段，GitHub 官方也说了可能会有 breaking changes，所以不建议直接上生产。但对于：

• 正在搭建 AI 应用基础设施的团队
• 想快速验证 Agentic 应用概念的开发者

<li需要在现有产品里嵌入 AI 助手的产品经理

这是目前最省力的起点——不用自己造轮子，Copilot 的规划引擎经过 GitHub 数亿次调用的验证。

GitHub：https://github.com/github/copilot-sdk
支持语言：Python / TypeScript / Go / .NET
Star：20,589+

GitHub: https://github.com/github/copilot-sdk