REFERENCE
開發者參考
認證、API、SDK、Flow Agent 處理節點與參數取值的完整參考。
版本遷移指南
Asgard SDK 與平台版本遷移指南
本文件記錄 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 整合 基本設定 增加更多設定選項 檢查 <Chatbot>的config設定升級步驟
- 更新套件版本：
npm install @asgard-js/core@latest @asgard-js/react@latest-
檢查新增的 SSE 事件類型，加入對應的處理邏輯（非必要但建議）
-
如果使用 React SDK，檢查
<Chatbot>的config設定是否需要更新
新功能
- Automation Tool 支援: 新增
asgard.tool_call.start和asgard.tool_call.complete事件 - Process 追蹤: 新增
asgard.process.start和asgard.process.complete事件 - 知識庫 2.0: 改進的 RAG 回應格式
- Data Insight 整合: 支援圖表與數據視覺化回應
API 相容性
Asgard API 遵循以下相容性原則：
- SSE 事件: 新事件類型為向後相容，舊版客戶端可忽略未知事件
- Request 格式:
customChannelId、text、action等核心欄位保持穩定 - Response 格式:
fact物件中的新欄位為向後相容
提示建議在 SSE 事件處理中加入
defaultcase，忽略未知的事件類型，以確保向後相容：switch (event.eventType) {
case 'asgard.message.delta':
// 處理串流文字
break;
case 'asgard.message.complete':
// 處理完成訊息
break;
// ... 其他已知事件
default:
// 忽略未知事件類型（向後相容）
break;
}