跳到內容

工具與權限

agent 能做什麼、哪些要先問你、哪些永遠不准。每個工具三種狀態,在 agent 的工具分頁設預設值,通道與網站小工具可以各自覆蓋。

這是什麼

agent 是你在 Dot Agents 裡建立的 AI 同事。它做事靠 工具:查知識庫、建頁面、寄信、查外部系統、跑程式,每一樣都是一個工具。 工具分頁就像它的授權單:哪些事它可以直接做,哪些要先拿來問你,哪些完全不准碰。例如「寄 email」設成需核准,它寫好的信就會先變成一張卡,有人按核准才寄出。

在哪裡找到它

主控台 → Agents → 點一位 agent → 工具 分頁,需要「設定 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 發送與互動 discord_message
工具預設
Discord 讀訊息 discord_read
對話頁基準線
Discord 查資訊 discord_inventory
工具預設
Discord 頻道管理 discord_channel_manage
對話頁基準線
Discord 身分組管理 discord_role_manage
對話頁基準線
Discord 訊息管理 discord_message_manage
對話頁基準線

Slack

Slack 發送與互動 slack_message
工具預設
Slack 讀訊息 slack_read
對話頁基準線
Slack 查資訊 slack_inventory
工具預設
Slack 頻道管理 slack_channel_manage
對話頁基準線

Telegram

Telegram 發送與互動 telegram_message
工具預設
Telegram 查資訊 telegram_inventory
工具預設
Telegram 群組管理 telegram_chat_manage
對話頁基準線
Telegram 成員權限 telegram_member_rights
對話頁基準線

LINE

LINE 發送與卡片 line_message
工具預設
LINE 查資訊 line_inventory
工具預設

網路

讀取網頁 http_fetch工具預設
呼叫外部 API http_request
工具預設
網路搜尋 web_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對話頁基準線

通知

寄 email 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 團隊 agent_create_team工具預設
修改其他 agent agent_update工具預設
幫 agent 裝插件 agent_plugin_install工具預設
管理常設群組 group_manage工具預設

其他

子代理 spawn_subagent工具預設
工具分頁:每一列一個工具,右邊切允許、需核准或禁止;徽章顯示目前生效值來自哪一層。可以展開看一個工具涵蓋哪些動作。

三種狀態

狀態 結果
允許 它直接做
需核准 先變成一張核准卡,有人核准才做
禁止 它根本看不到這個工具,不會嘗試

有些工具只能允許或禁止:問你問題這類互動工具,核准它們本身沒有意義。

動作分級

導入時最值得花時間討論的,是替它的動作分級:哪些可以自動、哪些一定要人。四級由低風險到高風險,對到工具的三種狀態:

動作四級與工具三態示意圖
分級例子在 Dot Agents 裡
01自動執行查歷史報價、庫存、產能;比對檢驗數據;產生摘要工具設「允許」
02做完通知建報價草稿、工單草稿;內部提醒;更新預計到貨日「允許」,加上執行紀錄與通知
03需人核准正式開立工單;寄信給客戶或供應商;調整排班工具設「需核准」,變成核准卡
04禁止改價格主檔、物料表;刪資料、付款;對設備下指令工具設「禁止」:它根本看不到
風險由上到下遞增;分級表由業務、資訊與稽核一起訂,隨信任度逐步調整。
動作四級對到工具三態:自動執行與做完通知都設允許,差別在你要不要看紀錄與通知;需人核准設需核准;禁止設禁止。
分級 例子 工具設成
自動執行 查歷史、查庫存、比對、算摘要 允許
做完通知 建草稿、內部提醒 允許,再看執行紀錄與通知
需人核准 正式寫入、寄信給客戶或供應商 需核准
禁止 刪資料、付款、改價格主檔 禁止

分級表不是 IT 自己訂的,由業務、IT、稽核一起訂,再隨信任度逐步調整:例如草稿的準確度驗證一段時間後,把它從需核准改成允許。怎麼訂見動作分級,拿什麼數據決定見可信度。

生效值怎麼決定

  • 每個工具有出廠預設:多數是允許,寄信、改靈魂文件這類是需核准。
  • 你在 agent 工具分頁設的值會蓋過預設。
  • 通道或網站小工具設定裡的值再蓋過 agent 設定,只對那一個通道生效。
  • 對外(客人)的通道會自動收掉會洩漏團隊內部資訊的工具,要放寬時逐項打開。

清單上每一列的徽章告訴你目前生效值來自哪一層,按重設就回到上一層的值;把一個工具改回原本的值,也等於沒有改。通道設定裡的「放寬 N・收緊 M」摘要就是拿你改的值跟原本的值比。

怎麼改一個工具

  1. 在工具分頁用搜尋框找到那個工具,或切「只看已調整」只看改過的。
  2. 點工具名展開,看它涵蓋哪些動作,確認是你要的那一個。
  3. 在右邊切成允許、需核准或禁止。改動立即生效。
  4. 要讓某個通道例外,到那個通道的設定裡再改一次。

對話裡看起來像什麼

它每用一次工具,對話裡就多一步,收在可展開的群組裡;設成需核准的那一步會停下來變成卡片。

對話 · 工具步驟實際介面
查知識庫:退貨政策搜尋頁面:客服回饋查資料:本週工單 42 筆建立頁面:客服回饋週報
工具步驟群組:每一步有對應工具的圖示,還在跑的那一步有脈動的點。

會遇到的狀況

我設了允許,它在某個通道還是會問

看那一列的徽章。可能是那個通道自己有覆蓋,或發話者的角色沒有這個權限;前者到通道設定改,後者到「團隊 → 角色」改。

相關頁

本頁對應 v0.111.1