跳至主要内容

REFERENCE

開發者參考

認證、API、SDK、Flow Agent 處理節點與參數取值的完整參考。

開發整合導覽

從建立 Bot、發佈 Bot Provider，到用 SDK 接上前端的完整開發路徑

這一頁把 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 聊天機器人。

    • 建立第一個 Workflow：Hello
    • 打造簡易 AI 聊天機器人
    • 串流回應（Streaming）

  3. 設定模型​

    讓 Bot 能呼叫 LLM。

  4. 發佈為 Integration，取得 Endpoint 與 API Key​

    把設計好的 Bot 對外發佈成 Bot Provider，這一步會拿到前端 SDK 需要的 botProviderEndpoint 與 API Key。

    • 建立 Generic Integration（取得 Endpoint 與 API Key）

  5. 管理 API Key​

    取得、輪轉與安全保管金鑰，以及 rate limit 等限制。

  6. 用 SDK 接到你的應用​

    拿到 endpoint 與憑證後，接上前端或後端。

  7. 理解訊息流​

    整合後若要處理串流回應，先理解 SSE 事件序列。

  8. 設計回覆呈現​

    Bot 的回覆以訊息模板呈現，由前端渲染。

    走完這條路徑後，建議依你選定的整合模式回到對應的 Pattern 頁，深入該模式的 Auth、History、Memory & Payload 等細節。

準備好開始了嗎？

想知道 Asgard 怎麼用在你的團隊？跟我們聊聊。

聯絡我們