開發整合導覽
這一頁把 Asgard 既有的文件串成一條從 0 到上線的開發路徑:在 Odin 設計 Bot、 發佈成 Bot Provider、取得憑證,再用 SDK 接到你的應用。每一步都連到對應的詳細文件, 照著走就能完成第一個整合。
前端開發者
偏前端、想直接看可互動的元件範例?可搭配 SDK Demo 站的
整合總覽(@asgard-js/react 視角)一起看。
1. 了解概念、選擇整合模式
先決定應用要用哪種方式接 Asgard,這會影響後面所有步驟。
- 整合總覽與選型 — 名詞、四種 Pattern 的對比與決策流程
- 四種模式:Hosted Embed、 Direct Connect、 Workflow Auth、 Backend Relay
2. 在 Odin 建立 Bot 與 Workflow
設計對話邏輯,從最簡單的 Hello 到接上 LLM 的 AI 聊天機器人。
3. 設定模型
讓 Bot 能呼叫 LLM。
4. 發佈為 Integration,取得 Endpoint 與 API Key
把設計好的 Bot 對外發佈成 Bot Provider,這一步會拿到前端 SDK 需要的 botProviderEndpoint
與 API Key。
5. 管理 API Key
取得、輪轉與安全保管金鑰,以及 rate limit 等限制。
6. 用 SDK 接到你的應用
拿到 endpoint 與憑證後,接上前端或後端。
- SDK 總覽
- 前端 SDK 使用指南、 後端 SDK 使用指南
- 互動範例(SDK Demo 站):整合總覽、 快速開始
7. 理解訊息流
整合後若要處理串流回應,先理解 SSE 事件序列。
8. 設計回覆呈現
Bot 的回覆以訊息模板呈現,由前端渲染。
- Message Template(與其餘模板頁)
走完這條路徑後,建議依你選定的整合模式回到對應的 Pattern 頁,深入該模式的 Auth、History、Memory & Payload 等細節。