API 串接
讓你們自己的系統(例如 ERP、MES)呼叫 agent。系統可以開始工作流、跟 agent 對話、收到結果,也可以在自己的畫面上決定關卡。一個系統建一個串接,金鑰、工具權限、能開始的工作流、回呼網址都在串接上設定。
這是什麼
API 串接讓你們公司自己的系統呼叫 agent(你在 Dot Agents 裡建立的 AI 同事)。例如 ERP 收到一張採購單,就請 agent 跑「採購核准」工作流。做完時,結果會送回 ERP。關卡也可以交給 ERP 決定,主管在 ERP 裡按核准就好。用 ERP 的人不必登入 Dot Agents。
只有 Enterprise 方案有 API 串接。
在哪裡
主控台 → Agent → 點進一位 agent → 通道 分頁 → API 子分頁。它排在「通道」後面。
建立一個串接
- 按 新增 API 串接,填名稱,例如「ERP」。
- 畫面會顯示金鑰與回呼的簽章金鑰。請馬上複製,交給你們的工程師。關掉視窗後就看不到了。
- 選 受眾,再看 工具權限 要不要調整。
- 在 能開始的工作流,打開要讓系統直接開始的工作流。預設一個都不能開始。
- 填 回呼網址,按 儲存,再按 測試,確認送得到。
工程師怎麼呼叫,見開發與整合。
設定
| 設定 | 說明 |
|---|---|
| 受眾 | 對內系統(例如 ERP):工具照 agent 自己的設定。對外(例如客戶用的 App):工具照對外基準線,工作流也要打開「外部的人也可以透過 agent 執行」 |
| 工具權限 | 你們的系統跟 agent 對話時,agent 能用的工具。見下一節 |
| 工作流的固定輸入 | 在工具權限展開的清單下面。填了值的欄位,一律用這個值。agent 在對話裡叫這個工作流,或你們的系統直接開始它,都一樣 |
| 核准交給 | 外部系統:工作流步驟裡的核准與提問送到你們的系統。團隊:照舊送到待處理 |
| 轉真人交給 | 你們的客服:對話裡要找真人時,交給你們的人用 API 回覆。不提供:agent 不轉真人 |
| 回呼網址 | 執行結束、或有事要你們決定時,我們把事件送到這個網址。空白就不送 |
| 每小時上限 | 這個串接一小時最多開始幾次工作流 |
| IP 白名單 | 只接受這些位址的呼叫。空白就是不限 |
| 能開始的工作流 | 你們的系統能直接開始的工作流。預設一個都不能開始 |
| 能寫入的知識庫 | 你們的系統用知識同步把文件送進打開的知識庫。只列 agent 能編輯的 |
工具權限
工具權限跟通道、網站小工具的一樣,分兩層:
- 受眾決定基準線。對內的串接照 agent 自己的工具設定。對外的串接照對外基準線,例如列出內部文件、改 agent 自己的設定都收掉。
- 再逐個調整。按工具權限下面那顆按鈕,打開完整清單。每個工具都可以設成允許、需核准或禁止,放寬或收緊都可以。清單也列出連接器的工具和工作流。
每一列都寫出目前的值從哪一層來。按重設,就回到基準線。
有些工具只在別的地方有用,例如對話頁的詢問決策、帶看頁面,或只在群組裡用的工具。它們在這份清單上標著 這裡用不到,不能設定。
清單下面還有 工作流的固定輸入。例如這個串接是台中店的系統,就把「門市」固定成台中店。填了值的欄位,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