版本遷移指南
本文件記錄 Asgard SDK 各版本間的重大變更與遷移步驟。
SDK 版本遷移
0.1.x → 0.2.x
SDK 0.2.x 版本引入了多項重大改進：
Breaking Changes
| 變更項目 | 0.1.x | 0.2.x | 遷移方式 |
|---|---|---|---|
| 套件名稱 | @asgard-js/core | @asgard-js/core (不變) | 升級版本即可 |
| SSE 事件格式 | 基本事件 | 新增 asgard.process.start/complete、asgard.tool_call.start/complete | 新增事件處理器 |
| React Provider | 基本設定 | 增加更多設定選項 | 檢查 Provider 設定 |
升級步驟
- 更新套件版本：
npm install @asgard-js/core@latest @asgard-js/react@latest
-
檢查新增的 SSE 事件類型，加入對應的處理邏輯（非必要但建議）
-
如果使用 React SDK，檢查
AsgardProvider的設定是否需要更新
新功能
- Automation Tool 支援: 新增
asgard.tool_call.start和asgard.tool_call.complete事件 - Process 追蹤: 新增
asgard.process.start和asgard.process.complete事件 - 知識庫 2.0: 改進的 RAG 回應格式
- Data Insight 整合: 支援圖表與數據視覺化回應
平台版本更新紀錄
完整的平台更新紀錄請參考 版本資訊。
重要里程碑
| 日期 | 版本 | 重點 |
|---|---|---|
| 2024-07 | 1.0 | Asgard LLM Application SaaS Platform 正式上線 |
| 2024-11 | 1.1 | Automation Tools 效率提升 |
| 2025-01 | 1.2 | RAG Enhancement、知識庫增強 |
| 2025-05 | 2.0 | Knowledge Base 2.0、新分段設定 |
| 2025-07 | 2.1 | Billing Portal (Fehu) 上線 |
| 2025-09 | 2.2 | Data Insight (Mimir) 上線 |
| 2025-11 | 2.3 | Integration Tool 上線 |
API 相容性
Asgard API 遵循以下相容性原則：
- SSE 事件: 新事件類型為向後相容，舊版客戶端可忽略未知事件
- Request 格式:
customChannelId、text、action等核心欄位保持穩定 - Response 格式:
fact物件中的新欄位為向後相容
提示
建議在 SSE 事件處理中加入 default case，忽略未知的事件類型，以確保向後相容：
switch (event.eventType) {
case 'asgard.message.delta':
// 處理串流文字
break;
case 'asgard.message.complete':
// 處理完成訊息
break;
// ... 其他已知事件
default:
// 忽略未知事件類型（向後相容）
break;
}
取得協助
如果在遷移過程中遇到問題：
- 查看 FAQ 常見問題
- 聯繫技術支援：service@asgard-ai.com
- 參考 Yggdrasil 社群 開源資源