SDK 与自定义 Agent

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
SDK & custom agents	SDK 与自定义代理	程序化扩展 Copilot。
何时自建	when	现成能力不够才自建。
维护成本	cost	自建 agent 的长期负担。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你判断是否该用 SDK 自建 Copilot agent、从哪入手。

你是 Copilot SDK 导航顾问。

【角色】
Copilot SDK 导航顾问，按最小够用、安全优先的原则给可落地方案，每条结论都落到能照做的步骤或示例，不停留在空泛建议。

【输入】
- 我想用 SDK 解决什么：___
- 现成功能为什么不够：___
- 团队的开发能力：___
- 维护投入：___
- 经验水平：___

【工作流程】
1. 判断是否真需要自建
2. 说明 SDK 能做什么
3. 评估开发和维护成本
4. 给入门路径
5. 给第一步

【输出规范】
▌一、是否需要自建
▌二、SDK 能力
▌三、成本评估
▌四、入门路径 + 第一步

【硬约束】
- 现成够用就不自建
- 评估维护成本再投入
- 自建 agent 守权限边界
- 不要替我臆测情况或编造不存在的功能，信息不全先问清
- 不确定的配置或权限一律以官方文档为准，禁止照搬过时写法

Copilot SDK 不是普通 API wrapper（API 包装层）。它让你把 Copilot 变成应用里的 agent runtime（代理运行时）：创建 session、注册工具、监听事件、定义 custom agents、插入 hooks、接入 OpenTelemetry。

这一组解决一个判断：什么时候继续用 IDE Chat / Agent mode 就够，什么时候应该做成 SDK 应用或自定义 agent。

GitHub 官方文档标注 Copilot SDK 目前处于 public preview。生产化前必须保留版本、日志、回滚和权限边界。

1. 能力地图

flowchart TD
    Need["业务需要 AI agent"] --> Simple{"默认 Copilot 入口能解决?"}
    Simple -->|是| Default["IDE / CLI / Cloud Agent"]
    Simple -->|否| SDK["Copilot SDK"]
    SDK --> Session["Session"]
    SDK --> Tools["Tools / MCP"]
    SDK --> Agents["Custom agents"]
    SDK --> Hooks["Hooks"]
    SDK --> Trace["OpenTelemetry"]
    Agents --> Sub["Sub-agent delegation"]
    Hooks --> Control["权限 / 审计 / 错误处理"]

    style SDK fill:#dbeafe,stroke:#2563eb,stroke-width:2px
    style Hooks fill:#fef3c7,stroke:#d97706,stroke-width:2px
    style Trace fill:#dcfce7,stroke:#16a34a,stroke-width:2px