總覽與選型
什麼是 Bot Provider 整合
當你在 Odin Studio 完成一個 AI Agent 的設計後, Asgard 會把它對外發佈為一個 Bot Provider — 對外可被呼叫的 AI Agent 端點。在 Odin UI 上, 你會以建立一個 Generic Integration 的方式來開出這個端點(見 建立 Generic Integration), 兩者指同一件事 — 本系列文件 UI 操作慣用 Generic Integration, SDK 與架構文件慣用 Bot Provider。
Asgard 雲端有一組對外服務 Bot Provider 的後端, 稱為 Edge Server, 它提供一系列標準化的 API(串流訊息、檔案上傳、頻道管理…), 讓你能用各種方式把 Agent 交付到終端使用者面前。
幾個會在本文反覆出現的詞先在這裡建立共識:
| 詞 | 一句話定義 |
|---|---|
| Bot Provider | 你在 Odin 完成 Agent 後對外發布的端點, 等同「對外可呼叫的 AI Agent」 |
| Edge Server | Asgard 雲端中, 負責對外服務 Bot Provider API 的後端服務(你不需要部署它, Asgard 已托管) |
| Channel | 一段對話的識別單位, 具備自訂的 customChannelId, 同一 Channel 內 AI 才會記得前後文 |
| Payload | 隨訊息一起送出的自訂資料, Workflow 內部可透過 prevPayload 讀取以影響行為 |
這份文件幫助開發工程師理解 不同整合方案的差異, 並協助你選到最適合自己場景的方案。
Asgard 提供 4 種整合方案（Pattern） — 從「零程式碼 URL 嵌入」到「企業級後端中繼」, 涵蓋各種規模與需求。
4 種整合模式各有適用場景與能力邊界, 並無優劣之分。本指南的核心目的是讓你快速辨識自己的需求, 並對應到合理的模式。
你的場景符合哪個?
如果你已經知道大致需求, 先從這張對照表開始 — 找到接近你情境的描述, 直接前往對應的 Pattern 頁:
| 你的情境 | 推薦 Pattern |
|---|---|
| 🚀 我想 5 分鐘讓 Bot 上線給朋友或客戶試用, 不寫程式碼 | Hosted Embed |
| 🎨 我想客製化聊天 UI 嵌入官網, 但我沒有後端開發資源 | Direct Connect |
| 🔐 我已經有 SSO / OAuth 驗證系統, 想做動態驗證但不想額外建後端 | Workflow Auth |
| 🏢 我做企業內部應用, 需要稽核、權限控管、跨裝置歷史保留 | Backend Relay |
| 🧠 我希望從後端動態組裝 Memory、User Config 影響 Agent 行為 | Backend Relay |
| 📱 我想把 Bot 接到 LINE / Discord / Slack / Telegram | 第三方平台整合(另一條 Integration 路徑, 不走下方 4 個 Pattern) |
如果你還在評估、想先理解全貌再下決定, 請繼續往下看。
4 種 Pattern 一覽
以下是 4 種方案的定位與對應的訊息鏈路:
| Pattern | 一句話定位 | 架構鏈路 |
|---|---|---|
| Hosted Embed | UI 由 Asgard 托管, 嵌入 URL 即可 | User → embed.asgard-ai.com → Edge Server |
| Direct Connect | 前端 SDK 直連 Edge Server | 你的前端 → Edge Server |
| Workflow Auth | Auth 與業務邏輯放在 Workflow 內部 | 你的前端 → Edge Server → Workflow → 外部 Auth Server |
| Backend Relay | 在你的後端中繼, 最進階方案 | 你的前端 → 你的後端 → Edge Server |
能力對比表
各方案在主要能力維度上的支援狀況:
| 維度 | Hosted Embed | Direct Connect | Workflow Auth | Backend Relay |
|---|---|---|---|---|
| 開發成本 | 最低 | 低 | 中 | 高 |
| UI 客製化 | URL 參數 | ✅ 完整 | ✅ 完整 | ✅ 完整 |
| Auth 模型 | 共享 API Key | 共享 API Key | 動態 Token | 完整 Session/JWT |
| Per-user ACL | ❌ | ❌ | △ 有限 | ✅ |
| 跨裝置 History | ❌ | ❌ | △ FE 攜帶 | ✅ |
| 從 BE 注入 Payload | ❌ | ❌ | ❌ | ✅ |
| Audit Log | ❌ | ❌ | ❌ | ✅ |
| API Key 不外洩 | ❌ | ❌ | ✅ | ✅ |
| 需要建立後端服務 | ❌ | ❌ | ❌ | ✅ |
想完整理解每個層的能力範圍、為什麼某些功能在某些模式下做不到? → 架構深入解析
選型決策流程
如果還沒在場景對照中找到自己的情境, 跟著下圖逐題回答即可:
接下來怎麼讀
選定方向後, 建議依以下路徑深入:
- 先建立 Generic Integration — 4 個 Pattern 的共同前置作業, 你會在這一步取得後續會用到的 Bot Provider Endpoint 與 API Key → 建立 Generic Integration
- 進入對應的 Pattern 頁 — Hosted Embed / Direct Connect / Workflow Auth / Backend Relay
- 跨模式比較功能 — 翻閱 Auth、History、Memory & Payload、Audit Log 四個功能開發指南, 了解每種能力在你選的模式下怎麼實作
- 參考 SDK 文件 — 前端 SDK、後端 SDK
- 想理解架構為何如此設計 — 架構深入解析
想整合 LINE / Discord / Slack / Telegram? 那條路徑不走下方 4 個 Pattern, 請改看 第三方平台整合。
各 Pattern
選定方案後, 直接進入對應頁面開始整合:
📄️ Pattern 1: Hosted Embed
Asgard 托管 UI, 嵌入 URL 即可。最快上線的方式
📄️ Pattern 2: Direct Connect
前端 SDK 直連 Edge Server, 完整 UI 客製化
📄️ Pattern 3: Workflow Auth
不建後端服務也能做動態 Auth, 邏輯放在 Workflow 內
📄️ Pattern 4: Backend Relay
在你的後端中繼, 最進階、最有彈性的方案
名詞速覽
| 名詞 | 說明 |
|---|---|
| Bot Provider | 在 Odin Studio 完成 Agent 設計後對外發布的端點。一個 Bot Provider 對應一個可被外界呼叫的 AI Agent |
| Edge Server | Asgard 雲端中, 負責對外服務 Bot Provider API 的後端服務(由 Asgard 托管, 你不需要部署) |
| SSE (Server-Sent Events) | Bot Provider API 用來串流回應的協定, 讓使用者可以看到 AI 逐字回應 |
| Channel | 一段對話的識別單位, 具備 customChannelId。同一 Channel 內 AI 才會記得前後文 |
| Payload | 隨訊息一起從你的前端或後端送出的自訂資料, Workflow 內部可透過 prevPayload 讀取以影響行為 |
| Workflow | 你在 Odin Studio 設計的 Agent 工作流程, 由若干 Processor 串接而成, 於 Edge Server 內部執行 |