跳至主要内容

整合總覽

這一頁是用 Asgard 開發第一個功能的路線圖。本站（SDK Demo）聚焦在前端 @asgard-js/react 的用法；而「如何建立 Bot、設定對話邏輯、取得憑證」屬於平台 端，文件在 Asgard 開發者文件。下面把整條路徑 串起來，每一步都指向該看的頁面。

一句話總結

先在 Odin 把 Bot 做好並發佈成 Bot Provider（拿到 endpoint 與憑證）→ 再用本站 的 @asgard-js/react 把它接到你的前端。

整條開發旅程​

1. 了解概念，選擇整合模式​

先決定你的應用要用哪種方式接 Asgard，這會影響後面所有步驟：

模式適合情境文件
Direct Connect前端直接連 Bot Provider，最快上線Direct Connect
Backend Relay需要在你自己的後端中繼、隱藏金鑰、加業務邏輯Backend Relay
Hosted Embed用官方 iframe 直接嵌入，免寫前端Hosted Embed

延伸閱讀：整合總論。 本站的 demo 預設示範 Direct Connect。

2. 在 Odin 建立 Bot、發佈成 Bot Provider​

這是開發者最常卡住的一步——前端要的 botProviderEndpoint 是從這裡來的。 在 Odin Studio 裡：

  1. 建立 Project 與 Workflow，設計對話邏輯（HTTP 呼叫、SQL 查詢、知識庫檢索…）。

  2. 發佈成 Bot Provider，取得 endpoint 與憑證：

    https://api.asgard-ai.com/ns/{namespace}/bot-provider/{botProviderId}

實作教學：

3. 用 @asgard-js/react 接到前端​

拿到 endpoint 後，回到本站：

4. 設計訊息與回覆呈現​

Bot 回覆會以訊息模板呈現，前端負責渲染：

5. 認證與私有 Bot​

如果你的 Bot 需要驗證：

接下來​