Heddle 文件
使用 Heddle 建立 Agentic Experience
先建立可運作的對話，再只採用產品真正需要的執行環境、能力、託管與客戶端層級。
客製化深度
選擇最小且實用的執行環境邊界
託管深度
行程內、託管、遠端或產品 UI
文件狀態
支援的 SDK 邊界
Heddle 負責
- 持久對話與回合語意
- 模型與工具執行、核准、追蹤紀錄與產物
- 有序的 active run、重播、取消與終結結果
產品端負責
- 身分、租戶、授權與產品資料關係
- 領域工具、模型憑證、儲存政策與對外 schema
- Server framework、傳輸、部署、UI 與結果套用方式
看看真實產品
Heddle 已經在 SlideX 裡驅動真正的產品功能。
先了解完整產品案例，再選擇適合你的 Heddle 整合層級。
產品實際案例
SlideX
可運作的產品整合在瀏覽器中建立、編輯並匯出專業簡報的工作區。
透過對話，把想法變成投影片。
SlideX 讓製作專業簡報更容易。Heddle 驅動其中的對話式 Agent，使用者只要說出想法、透過對話一起調整，就能讓 Agent 直接在編輯器裡建立或修改投影片。
- 說出你的想法
- 建立並修改投影片
- 持續同一段對話
選擇符合產品現況的路徑
| 你想完成的事情 | 從這裡開始 | 你需要負責的部分 |
|---|---|---|
| 在 TypeScript 行程中評估 Heddle | 建立第一個 Agent | 設定與 prompts |
| 把 Heddle 加進既有 backend | 選擇整合層級 | 產品組裝與既有邊界 |
| 加入領域工具或 MCP server | 加入原生工具 或 連接 MCP | 領域行為與能力政策 |
| 在自有應用程式中呈現 Agent | 接管輸出與活動 | 呈現、UI state 與結果處理 |
| 讓一次執行超過單一 request 的生命週期 | 託管總覽 | 身分、address scope、行程生命週期與傳輸 |
| 建立瀏覽器產品 | 遠端客戶端 | 對外 schema、重新連線 UX 與產品 UI state |
| 先在本機體驗完整參考產品 | 本機快速開始 | 一個工作區與模型存取 |
從兩個維度逐步學習
Heddle 不會強迫產品採用單一技術棧。請分開決定兩件事：
- **客製化深度：**從完整 prompt loop 開始，再逐步接管能力、輸出、生命週期、政策與持久化。
- **託管深度：**留在單一行程、加入可定址 run、公開傳輸層，或連接遠端產品 UI。
整合層級選擇器會把這兩個決定對應到最小且合適的 public package surface。
建議的第一條學習路徑
第一次學習 Heddle 時，請依序閱讀 使用 SDK 建立 Agent：
- 執行一個可持久化的 conversational agent。
- 建立穩定 session，並送出第二個回合。
- 加入一個產品自有工具。
- 只有在能力已存在 MCP server 後方時，才加入 MCP。
- 把能力專屬的 system context 放在該能力旁邊。
- 用自有應用程式介面取代預設文字輸出。
- 先處理結構化結果；當 capability 需要決策時，再連接核准政策。
- 只有產品需要時，才加入 artifact 與 storage adapter。
你可以停在任何已經有用的層級；託管與瀏覽器層都是選用的。
本機 Coding Agent 是參考宿主
Heddle 的 terminal UI 與 browser control plane 使用 SDK 所公開的同一套對話、活動、核准、追蹤與 run 基礎。你可以先用它們理解 Heddle，再只採用產品需要的層級來打造自己的體驗。