Skip to main content
Asgard SDK 與平台版本遷移指南

版本遷移指南

本文件記錄 Asgard SDK 各版本間的重大變更與遷移步驟。

SDK 版本遷移​

0.1.x → 0.2.x​

SDK 0.2.x 版本引入了多項重大改進：

Breaking Changes​

變更項目0.1.x0.2.x遷移方式
套件名稱@asgard-js/core@asgard-js/core (不變)升級版本即可
SSE 事件格式基本事件新增 asgard.process.start/complete、asgard.tool_call.start/complete新增事件處理器
React Provider基本設定增加更多設定選項檢查 Provider 設定

升級步驟​

  1. 更新套件版本：
npm install @asgard-js/core@latest @asgard-js/react@latest

  1. 檢查新增的 SSE 事件類型，加入對應的處理邏輯（非必要但建議）

  2. 如果使用 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-071.0Asgard LLM Application SaaS Platform 正式上線
2024-111.1Automation Tools 效率提升
2025-011.2RAG Enhancement、知識庫增強
2025-052.0Knowledge Base 2.0、新分段設定
2025-072.1Billing Portal (Fehu) 上線
2025-092.2Data Insight (Mimir) 上線
2025-112.3Integration Tool 上線

API 相容性​

Asgard API 遵循以下相容性原則：

  • SSE 事件: 新事件類型為向後相容，舊版客戶端可忽略未知事件
  • Request 格式: customChannelId、text、action 等核心欄位保持穩定
  • Response 格式: fact 物件中的新欄位為向後相容
tip

建議在 SSE 事件處理中加入 default case，忽略未知的事件類型，以確保向後相容：

switch (event.eventType) {
  case 'asgard.message.delta':
    // 處理串流文字
    break;
  case 'asgard.message.complete':
    // 處理完成訊息
    break;
  // ... 其他已知事件
  default:
    // 忽略未知事件類型（向後相容）
    break;
}

取得協助​

如果在遷移過程中遇到問題：