連接器
把公司在用的外部服務接給 agent:新增連線、登入授權或填金鑰、測試、啟用。金鑰 agent 看不到;它手上的外部檔案有一份清單。
連接器是把外部服務接給 agent(你在 Dot Agents 裡建立的 AI 同事)的方式:接上訂單系統,它就能查訂單;接上 Notion,它就能讀寫你的頁面。
要讓它用得到公司的系統,中間有三層,各做各的事:
| 層 | 是什麼 | 誰負責 |
|---|---|---|
| 你的系統開的門 | 系統對外開放的查詢接口與草稿接口。沒有門,誰都進不去 | 你的 IT 或系統廠商 |
| 連接器 | 標準的插座。系統的門照標準包好一次,哪位 agent 要用就替它接上。帶來的工具出現在工具分頁,可以逐個設允許、需核准或禁止;金鑰 agent 看不到 | IT 或整合商 |
| 技能 | 公司的作業手冊:進得去之後,怎麼做才對 | 業務單位主導,IT 協助 |
連接器用的標準叫 MCP。只要服務支援這個標準,就能用同一種方式接上,換哪位 agent 都一樣。每位 agent 的連接器是它自己的,接給誰就誰用得到。
在哪裡找到它
主控台 → Agents → 某位 agent → 連接器分頁。接好的服務帶來的工具,會出現在同一位 agent 的工具分頁裡。
記憶
mem_save對話頁基準線mem_search工具預設mem_timeline工具預設團隊資料庫
db_list工具預設db_query工具預設db_aggregate工具預設db_insert工具預設db_update工具預設db_delete工具預設db_view_save工具預設db_row_read工具預設db_row_write工具預設db_automation_save工具預設db_row_move工具預設db_trash工具預設db_column_trash工具預設db_undo工具預設db_activity工具預設db_alter_columns對話頁空間頁面
page_list工具預設page_read工具預設page_search工具預設page_create工具預設page_update工具預設page_move工具預設page_copy工具預設page_delete工具預設知識庫
kb_search工具預設kb_read工具預設kb_list工具預設kb_add_files工具預設kb_write工具預設kb_delete工具預設kb_organize工具預設kb_merge工具預設對話附件
attachment_read工具預設audio_transcribe工具預設file_save工具預設file_list工具預設file_read工具預設file_move工具預設file_delete工具預設文件產生
document_create工具預設Discord
discord_messagediscord_readdiscord_inventorydiscord_channel_managediscord_role_managediscord_message_manageSlack
slack_messageslack_readslack_inventoryslack_channel_manageTelegram
telegram_messagetelegram_inventorytelegram_chat_managetelegram_member_rightsLINE
line_messageline_inventory網路
http_fetch工具預設http_requestweb_search對話頁程式執行
code_run插件
plugin_search工具預設plugin_install工具預設plugin_update工具預設連接器
mcp_list工具預設mcp_connect對話頁基準線mcp_files工具預設mcp_file_remember工具預設排程
schedule_list工具預設schedule_create工具預設schedule_update工具預設schedule_delete工具預設團隊總覽
overview_get工具預設overview_update對話頁基準線通知
mail_send對話頁互動
ask_user工具預設conversation_rename工具預設todo_write工具預設ui_show_page工具預設request_human工具預設image_generate工具預設技能
skill_read工具預設skill_list工具預設skill_create對話頁基準線skill_update對話頁基準線skill_delete對話頁基準線自我設定
soul_update對話頁基準線avatar_update對話頁基準線協作
ask_colleague工具預設group_history工具預設agent_directory工具預設管理 agent
agent_create_team工具預設agent_update工具預設agent_plugin_install工具預設group_manage工具預設其他
spawn_subagent工具預設新增一條連線
- 在連接器分頁按新增連線。
- 填下表的欄位,存檔。
- 驗證方式是「授權登入」的,會把你帶去那個服務自己的登入頁,登入後回來。
- 按測試連線。成功會回報抓到幾個工具。
- 啟用。它從下一句話開始就用得到這些工具。
| 欄位 | 怎麼填 |
|---|---|
| 顯示名稱 | 你看的名字,例如「訂單系統」 |
| 代號 | 技能裡引用它用的短名,建好後不能改 |
| 服務位址 | 服務提供的連線網址 |
| 驗證方式 | 免驗證、授權登入、API 金鑰、自訂標頭四選一 |
| 金鑰 | 選 API 金鑰時填。agent 看不到 |
狀態與測試
連線會顯示目前的狀態。還差一步的會寫明差什麼(待授權、待補憑證、待測試、連線異常),照字面補上即可。
連接器帶來的工具
接好的服務會帶來一組工具,出現在這位 agent 的工具分頁,分成三組:搜尋與閱讀、建立與編輯、搬移與結構變更。每組可以整組設成允許、需核准或禁止。
外部檔案
agent 沒辦法搜尋你整個雲端硬碟。它碰得到的外部檔案只有一份清單:它自己建的,加上你交給它的。連接器分頁的檔案就是這份清單,可以從 Google 雲端硬碟挑檔案交給它,或對某個檔案按不再使用。
從對話裡接
agent 的回覆裡出現「連接 {服務}」按鈕時,點下去、貼上金鑰、按儲存並測試就接好了。金鑰只有你看得到,agent 看不到。
老系統沒有接口怎麼辦
很多公司的 ERP 是多年前客製的,沒有現成的接口。不用等換系統,依優先順序有四條路:
| 順序 | 做法 | 在 Dot Agents 裡怎麼做 |
|---|---|---|
| 1 | 唯讀資料視圖:IT 開一個只能讀的資料視圖 | 由你的 IT 把它包成連接器接上,agent 只能查、不能改。最常用,風險最低 |
| 2 | 既有整合平台:已經有介接程式或整合平台 | 把它包成連接器接上,不必重做 |
| 3 | 檔案交換:系統定期匯出檔案 | 把檔案上傳到工作區,或把 CSV 匯入資料庫讓它查。它要寫回去的內容先產成匯入檔,由人匯進系統。最簡單,但不即時 |
| 4 | 畫面操作:模擬人去點系統畫面 | 不支援。這條路脆弱、畫面一改就壞、也難稽核,我們不做 |
原則只有一條:寫入一律走正式接口或人工匯入,不讓 agent 直接改你系統的資料庫。這樣系統自己的檢核才會照常把關。
什麼樣的接口好用
請 IT 開接口時,四件事先講好,agent 用起來才順:
- 一個接口做一件事:「查報價歷史」「建報價草稿」分開開,不要一個萬能接口。
- 重送不會重複:它有時會重試,同一張草稿送兩次不能變成兩張。
- 錯誤訊息寫清楚:它看得懂錯在哪,才能自己修正再試。
- 每次呼叫都查得到是誰:事後追得到是哪位成員交辦的。
會遇到的狀況
先檢查服務位址與金鑰有沒有填對、授權有沒有過期。改好後再按一次「測試連線」。
「不再使用」只是把那個檔案從 agent 的清單移除。要完全收回 Google 那端的授權,請到你 Google 帳號的權限頁移除整條連線。
新增、編輯、授權、移除連接器需要「安裝與移除擴充」這把權限鍵;看一律開放。
相關頁
本頁對應 v0.111.1