跳至主要内容

第三方平台整合

把 Asgard Agent 接到 LINE / Discord / Slack / Telegram 等第三方訊息平台, 使用者直接在原本熟悉的 App 裡跟你的 AI 對話。

第三方 Integration 與 Generic Integration 是兩條不同的路

本頁四種整合都是在 Odin UI 上建立第三方類型的 Integration(LINE / Discord / Slack / Telegram), 跟 Generic Integration(用於自己的網頁 / SDK, 在 SDK 文件中稱為 Bot Provider)並列為兩條路徑。

第三方類型由 Asgard 透過 Webhook 接收平台訊息、回送 Workflow 處理結果, 不會像 Generic Integration 那樣對外提供一個 Endpoint(Bot Provider Endpoint)讓你自己呼叫。

下方各區段以 Tab 切換平台 — 選定一個平台後, 所有區段會同步切到同一個平台的說明。

1. 前置條件​

  • Asgard 帳號
  • LINE Official Account
  • 為該 OA 啟用 Messaging API(參考 LINE Docs)
  • 在 LINE Developers Console 建立 Channel, 取得 Channel Secret 與 Channel Access Token

LINE 前置

2. 在平台側建立應用 / 取得憑證​

在 LINE Developers Console 建立 Channel, 於 Messaging API 設定頁取得 Channel Secret 與 Channel Access Token, 先複製備用 — 後面要填回 Asgard。

3. 在 Asgard 建立對應的 App​

進入 Project 左側選單 Apps, 點擊右上角 New Integration, 填入通用欄位:

欄位說明
名稱 / 描述自訂, 辨識用
環境預設 main, 有其他環境請對應選擇
工作流程集選擇要綁定的 Workflow Set
應用類型選擇對應的第三方平台(下方 Tab)
Debug Mode正式環境選 Never, 開發短期可切 Always 或 On-Demand
啟用預設啟用
Debug Mode 在正式環境一律選 Never

Always / On-Demand 會把 prompt、變數值、工具呼叫參數回傳到使用者裝置, 可能洩漏機敏資料。

接著填入該平台需要的型別專屬欄位:

應用類型選 LINE, 填入剛才取得的:

  • Channel Secret
  • Channel Access Token

儲存後 Asgard 會回傳一組 Webhook URL, 複製下來, 下一步要回填到 LINE。

LINE 整合配置

4. 驗證 / 測試​

把上一步從 Asgard 取得的 Webhook URL 貼回 LINE Developers Console:

  1. 在 Channel 設定頁找到 Webhook URL, 貼上並點 Verify
  2. 出現成功訊息後, 把 Use webhook 開關打開
  3. 加 LINE Official Account 為好友, 對它說一句話, 確認 Asgard Workflow 有收到訊息

詳細步驟見 LINE Docs: Setting webhook URL。

延伸閱讀​