跳到內容

API 串接

讓你們自己的系統(例如 ERP、MES)呼叫 agent。系統可以開始工作流、跟 agent 對話、收到結果,也可以在自己的畫面上決定關卡。一個系統建一個串接,金鑰、工具權限、能開始的工作流、回呼網址都在串接上設定。

這是什麼

API 串接讓你們公司自己的系統呼叫 agent(你在 Dot Agents 裡建立的 AI 同事)。例如 ERP 收到一張採購單,就請 agent 跑「採購核准」工作流。做完時,結果會送回 ERP。關卡也可以交給 ERP 決定,主管在 ERP 裡按核准就好。用 ERP 的人不必登入 Dot Agents。

只有 Enterprise 方案有 API 串接。

在哪裡

主控台 → Agent → 點進一位 agent → 通道 分頁 → API 子分頁。它排在「通道」後面。

API 串接在哪裡、上面有什麼示意圖
一個系統建一個 API 串接。上面有金鑰、工具權限、能開始的工作流、回呼網址,以及核准交給誰。

建立一個串接

  1. 按 新增 API 串接,填名稱,例如「ERP」。
  2. 畫面會顯示金鑰與回呼的簽章金鑰。請馬上複製,交給你們的工程師。關掉視窗後就看不到了。
  3. 選 受眾,再看 工具權限 要不要調整。
  4. 在 能開始的工作流,打開要讓系統直接開始的工作流。預設一個都不能開始。
  5. 填 回呼網址,按 儲存,再按 測試,確認送得到。

工程師怎麼呼叫,見開發與整合。

設定

設定 說明
受眾 對內系統(例如 ERP):工具照 agent 自己的設定。對外(例如客戶用的 App):工具照對外基準線,工作流也要打開「外部的人也可以透過 agent 執行」
工具權限 你們的系統跟 agent 對話時,agent 能用的工具。見下一節
工作流的固定輸入 在工具權限展開的清單下面。填了值的欄位,一律用這個值。agent 在對話裡叫這個工作流,或你們的系統直接開始它,都一樣
核准交給 外部系統:工作流步驟裡的核准與提問送到你們的系統。團隊:照舊送到待處理
轉真人交給 你們的客服:對話裡要找真人時,交給你們的人用 API 回覆。不提供:agent 不轉真人
回呼網址 執行結束、或有事要你們決定時,我們把事件送到這個網址。空白就不送
每小時上限 這個串接一小時最多開始幾次工作流
IP 白名單 只接受這些位址的呼叫。空白就是不限
能開始的工作流 你們的系統能直接開始的工作流。預設一個都不能開始
能寫入的知識庫 你們的系統用知識同步把文件送進打開的知識庫。只列 agent 能編輯的

工具權限

工具權限跟通道、網站小工具的一樣,分兩層:

  1. 受眾決定基準線。對內的串接照 agent 自己的工具設定。對外的串接照對外基準線,例如列出內部文件、改 agent 自己的設定都收掉。
  2. 再逐個調整。按工具權限下面那顆按鈕,打開完整清單。每個工具都可以設成允許、需核准或禁止,放寬或收緊都可以。清單也列出連接器的工具和工作流。

每一列都寫出目前的值從哪一層來。按重設,就回到基準線。

有些工具只在別的地方有用,例如對話頁的詢問決策、帶看頁面,或只在群組裡用的工具。它們在這份清單上標著 這裡用不到,不能設定。

清單下面還有 工作流的固定輸入。例如這個串接是台中店的系統,就把「門市」固定成台中店。填了值的欄位,agent 看不到也改不了。你們的系統直接開始工作流時,送來的值也會換成固定值。空白的欄位照常填。

這份設定只管你們的系統跟 agent 對話。工作流裡的步驟照受眾和 agent 自己的設定,跟從通道開始的一樣。

能開始的工作流 是另一份清單,跟工具權限分開。它管你們的系統能不能直接開始某個工作流,預設一個都不行。對內的串接,agent 在對話裡預設叫得到工作流。但系統要直接開始某個工作流,一定要在這份清單打開它。

誰可以改

建串接、換金鑰、選受眾、能開始的工作流,要「通道:掛載與切換」權限。工具權限和工作流的固定輸入,還要「設定 Agent 的思考方式」權限,跟網站小工具一樣。沒有這個權限的人,看不到這兩項。

跟 agent 說也可以

在主控台跟這位 agent 對話,直接講你要什麼,它會照做。例如:

  • 「幫 ERP 建一個 API 串接,讓它能開始採購核准」
  • 「ERP 那個串接改成對外,回呼網址改成 https://erp.example.com/hooks/dot」
  • 「ERP 開始補貨申請時,門市一律填台中店」
  • 「客戶 App 那個串接不要用寄信工具」

每一次修改前,對話裡會先出現一張確認卡,寫著這次要改哪些設定。你按 核准,它才會存。

金鑰和簽章金鑰不會出現在對話裡。它建好串接之後,會請你到 API 子分頁按 產生新金鑰。要驗證回呼的簽章,再按 換一把簽章金鑰。

它能做的事,跟你自己在這一頁能做的一樣,權限也一樣。只有 Enterprise 方案有這項功能。改過的內容會記在團隊的稽核紀錄裡,寫著是哪一位 agent 替誰改的。

關卡交給外部系統

在工作流的關卡,問誰 下面有 交給外部系統(API 串接)。選一個串接之後,走到這個關卡就會送到那個系統。不管這一次是怎麼開始的,都會送到那裡。

  • 這種關卡會出現在待處理的「等其他人」,團隊不會收到通知。
  • 期限到了還沒決定,就走「逾時」那條線。
  • 串接關掉時,用到它的工作流不能發布。

金鑰

  • 最多同時兩把。換新時先產生新的,你們的系統換好後再撤銷舊的。
  • 撤銷之後,用那把金鑰的呼叫會馬上失敗。
  • 簽章金鑰讓你們的系統確認回呼是我們送的。換一把之後,舊的馬上停用。

送出紀錄

串接最下面列出最近 20 筆回呼,以及送達了沒有。送不到時我們會重送,最多重送 24 小時。還是送不到,建立這個串接的人會收到通知。

相關頁

本頁對應 v0.168.0