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