Start here
開發資源
Integration path
從 0 到上線的開發路徑
依 DevDocs「開發整合導覽」
- 01
選擇整合模式
先決定應用怎麼接 Asgard：Hosted Embed、Direct Connect、Workflow Auth 或 Backend Relay。 - 02
在 Odin 建立 Bot
設計對話邏輯，從最簡單的 Hello 到接上 LLM 的聊天機器人，再設定要用的模型。 - 03
發布並取得憑證
把 Bot 發布成 Bot Provider，拿到 Endpoint 與 API Key。API Key 要保管在伺服器端，不要放進前端程式碼。 - 04
用 SDK 接上應用
拿到 Endpoint 與憑證後，用 @asgard-js/core 或 @asgard-js/react 接上前端或後端。 - 05
處理串流回應
回覆以 SSE 事件傳回。先讀懂事件序列，再決定畫面怎麼呈現。 - 06
設計回覆呈現
Bot 的回覆以訊息模板呈現：文字、按鈕、輪播、圖表等，由前端渲染。
npm install @asgard-js/core @asgard-js/react- @asgard-js/core
- 封裝 REST 請求，統一管理驗證與端點設定。自動處理 SSE 串流，內建頻道的 session 保存，支援多輪對話。
- @asgard-js/react
- 現成的 Chatbot 元件與 Hook。可以調整主題、語系、尺寸、頁首與訊息呈現，也能完全自訂介面。
- 互動範例
- 範例站把每個功能做成可以操作的 demo：嵌入、主題、檔案上傳、工具呼叫、思考過程、停止生成等。
X-API-KEY: your-api-key-here- 啟動・重置
- 建立或重置一個對話頻道。
- 發送訊息
- 送出使用者訊息，以 SSE 接收 Agent 的回覆與系統事件。
- 上傳檔案
- 上傳檔案，或附加檔案並發送訊息。
- 範例
- 發送訊息、串流回應、知識庫查詢、Webhook 整合，每個範例都有 cURL、JavaScript 與 Python 版本。
API Key 在 Asgard 平台的專案設定裡建立。API Key 等同存取憑證，只能放在伺服器端。
Open source
Yggdrasil 開源 PlugIn
MIT 授權的 MCP Server 與 SKILL
- MCP Servers
- 讓 Agent 連到外部系統與資料的標準介面。Odin 可以直接接入第三方 MCP 伺服器。
- SKILLs
- 可以重複使用的技能，交給 Agent 完成特定任務。
- 產業方案包
- PlugIn 組成產業方案包，例如 Smart Manufacturing、Hospitality Operations、Brand Media & PR。
- 範例
- Heimdall MCP Server。