工作流
每次都照同樣順序做的事,可以排成一個工作流。每一步交給一位 agent 或一個工具,需要人決定的地方會停下來問。誰開始、什麼時候開始,結果都一樣。
這是什麼
agent 是你在 Dot Agents 裡建立的 AI 同事。平常你在對話裡請它做事,它自己決定怎麼做。
工作流是把一件事的順序先排好:
- 第一步請研究 agent 篩出候選股。
- 第二步判斷有沒有新標的。
- 有的話,問投資小組要不要。
- 小組核准後,請寫手 agent 寫報告。
它像一張交辦單:每一步由誰做、做完交給誰,都寫在上面。每一次都照這張單走,所以結果穩定,也看得出走到哪一步。
工作流只有 Enterprise 方案有。
在哪裡找到它
- 對話頁:側欄「排程」下面的 工作流。
- 主控台:側欄「工作區」下面的 工作流。
- 手機 app:對話頁的抽屜裡有「工作流」。主控台在「更多」裡。
- 排程頁:最下面有「工作流的排程」,列出你看得到的工作流有哪些排程。點一列,就到那個工作流的「開始方式」。
清單上每一列是一個工作流,分成四欄:
- 名稱:名稱和說明。
- 最近一次:路徑條是最近一次走到哪。綠點做完了,會動的點正在做。黃色菱形是等人的關卡,空心的還沒到。
- 開始方式:除了手動,還可以怎麼開始。例如時鐘是排程,對話框是 agent 可以執行它。
- 狀態:最近一次做完了沒有。有關卡在等你決定時,標「等你」,那一列排在最上面。
agent 在對話裡提議、你還沒建立的工作流,也排在最上面,標「待你確認」。agent 提議修改、你還沒決定的工作流,那一列標「有修改待確認」。
清單上方可以選「全部」「我可以執行的」「我管理的」,也可以搜尋名稱。
畫布
點進一個工作流,第一個分頁是畫布。畫布上方可以切換三種模式:
- 檢視:看整張圖。點一個步驟,右邊會列出它的完整設定。
- 執行:選一次執行,圖上會標出這一次走到哪裡。走過的線變深,沒走的線變淡。正在做的步驟有一個會動的點。等人決定的關卡標著「等人決定」。
- 編輯:改草稿。只有「編輯」以上權限的人看得到這個模式。
畫布上的步驟名稱和判斷的條件一定寫完整,不會被截掉。比較長的說明只顯示一行,點那一步就看得到全文。
要移動或縮放畫布:
- 觸控板:兩指滑動來移動畫布。兩指捏合來放大或縮小。
- 滑鼠:拖曳空白的地方來移動畫布。轉滾輪會上下移動。按住 ⌘ 或 Ctrl 再轉滾輪,可以放大或縮小。
- 手機:一指拖曳來移動畫布。兩指捏合來放大或縮小。
- 左下角的按鈕也可以放大和縮小。按「看整張」,整張圖會放進畫面。
在「編輯」模式,你可以拖曳步驟,畫布會記住你排的位置。按畫布上方的 整理排版,畫布會重新排一次。分岔的線照出口由上到下的順序接,不會交叉。agent 的修改加了新步驟時,畫布也會整張重新排。
「檢視」模式下,步驟旁邊的數字是現在有幾次停在這一步。點那一步,右邊會列出是哪幾次,選一次就切到「執行」看它。
「執行」模式下,點一個由 agent 做的步驟,右邊有 打開這一步的對話。按它可以看 agent 做這一步時說了什麼、用了哪些工具:
- 在主控台:對話在右邊的對話窗打開。你可以接著問 agent。
- 在對話頁:對話在工作流頁上打開。你只能看,不能回話。
建立一個工作流
- 在清單上按 新工作流。
- 填名稱和說明。選「團隊」或「只有我」。
- 按 建立,畫布會用編輯模式打開。
- 加步驟:
- 先點一個步驟,再從左邊的步驟庫選。新的一步會接在你點的那一步後面。
- 把步驟庫的步驟拖進畫布,再從接點拉一條線接上。
- 按連線中間的「+」,新的一步會插在那條線上。
- 在右邊的面板填好這一步的設定。要用前面的結果,按欄位旁邊的「插入欄位」選一個。改動會自動存成草稿。
- 畫布上方會寫出還有幾個問題。按它可以一個一個跳過去看。
- 都改好了,按頁首的 發布。
編輯時可以用鍵盤:⌘Z 復原、⇧⌘Z 重做、⌘D 複製選著的那一步、Delete 刪除。
建立團隊工作流要有「工作流:建立」權限。個人工作流每個成員都能建,但只有你自己可以執行。
步驟有三類:
| 類別 | 步驟 | 做什麼 |
|---|---|---|
| 做事 | 請 agent 做 | agent 用自己的工具和知識做一件事,交出你指定的欄位 |
| 做事 | 直接用工具 | 不用模型,用某位 agent 的權限直接呼叫一個工具 |
| 做事 | 整理資料 | 把前面的結果整理成新的欄位,不用模型 |
| 做事 | 用另一個工作流 | 跑另一個工作流,做完帶著它的結果往下 |
| 做事 | 每一項都做 | 清單裡每一項各跑一次另一個工作流,結果照順序收在一起 |
| 問人 | 問人 | 停下來等人核准、選一個,或勾選多項 |
| 控制 | 判斷 | 依條件走不同的線 |
| 控制 | 讓 AI 分類 | agent 讀資料、挑一個類別,每個類別一條線。拿不定就走「其他情況」 |
| 控制 | 同時做 | 分成幾條路線同時做。路線接回同一步時,那一步等每條路線都做完 |
| 控制 | 等一下 | 等一段時間再往下。也可以設成等外部系統通知,見跑工作流 |
| 控制 | 結束 | 結束這一次,可以標成成功或失敗 |
要用前面某一步的結果,按欄位旁邊的「插入欄位」選一個。清單和判斷的條件不用打字,直接從選單選前面步驟交出的欄位。畫布和問題清單上,出口一律寫名字,例如「條件 1」「其他情況」「核准」。
判斷要看一個欄位是「是」還是「否」時,那個欄位的型別要是「是或否」。用文字欄位比「是」或「否」,條件永遠不成立,問題清單會列出這一項。
插入的欄位在格子裡寫成 {{步驟代號.欄位代號}}。步驟代號寫在面板的最上面。開始這一次的人的名字是 {{trigger.name}},email 是 {{trigger.email}}。
選 agent
要選 agent 的地方都用同一個選單:請 agent 做、直接用工具、讓 AI 分類,還有關卡的「先讓 agent 審核」。選單上有每位 agent 的頭像。不接受被工作流使用的 agent,名字下面會寫出來。
直接用工具
- 在「用哪個 agent 的權限」選一位 agent。
- 按 選一個工具。清單跟 agent 的工具頁長得一樣,照分組列出,也可以搜尋。
- 按 用這個。
- 下面會一格一格列出這個工具要的值。必填的會標出來,有固定選項的用下拉選單。每一格都可以用「插入欄位」帶入前面的資料。
清單只列這位 agent 在工作流裡用得到的工具。被禁止的工具不會列出。要在對話裡才能用的工具也不會列出,例如問人、改對話名稱。發布時也會再檢查一次:這位 agent 用不了那個工具,就不能發布。
同時做
「同時做」有自己的路線,預設兩條:「路線 1」和「路線 2」。
- 從每條路線右邊的出口,拉一條線到那條路線的第一步。
- 在面板可以改路線的名字,也可以加一條或刪一條。
- 每條路線的最後,都接回同一步。那一步會等每條路線都做完,才開始。
路線沒有接回同一步時,畫布上會寫出這個問題。不然先走到「結束」的那條路線會停掉整個工作流,其他路線會做到一半就停。
用另一個工作流、每一項都做
- 用另一個工作流 是一張卡。它跑一次選的工作流,做完帶著結果往下。面板會寫出它做完交出哪些欄位,後面的步驟用「插入欄位」選。
- 每一項都做 畫成疊起來的卡。在「清單從哪裡來」選前面步驟交出的一個清單。清單有幾項,選的工作流就跑幾次,最多 50 項。在給它的輸入裡,用「插入欄位」選「這一項」。做完交出「每一項的結果」、「做了幾項」和「沒做成的幾項」。
在對話裡請 agent 畫或改
你也可以直接在對話裡說,例如「幫我做一個工作流:員工請假先問主管,核准後通知人事」。
- agent 會在對話裡放一張草稿卡,上面有縮小的畫布和步驟數。
- 選「團隊」或「只有我」,再按 建立。要先改一改,就按 在畫布上調整。
- 想改哪裡,直接跟 agent 說,它會改同一張草稿卡。
- 不要這份草稿,就按 捨棄。
還沒建立的草稿不會不見:工作流清單最上面會列出它,標「待你確認」。點進去可以看畫布,再按「建立」或「捨棄」。
在主控台的對話窗按「打開工作流」,會打開主控台的工作流頁。在對話頁按,就打開對話頁的。
開始方式、設定和誰可以用,也可以一起跟 agent 說。例如「每個工作日早上 9 點跑,同時只跑一次,團隊所有人都可以用」:
- 卡片會寫出這些設定,例如「開始方式 平日 09:00 · 時區 Asia/Taipei」。
- 按 建立 時,排程、設定和名單會一起建好。
- 排程在發布之後才會開始跑。發布之前經過的時間不會補跑。
- 選「只有我」時,不會用卡片上的名單。個人工作流只有你可以用。
已經有的工作流,也可以用說的改。例如「採購核准的主管核准之後,加一步通知採購」:
- agent 先讀那個工作流,再提議修改。
- 對話裡會出現一張「修改「採購核准」」的卡。卡上寫出新增、修改、刪掉了哪幾步。縮小的畫布上,新的步驟標「新」,改過的標「改」,刪掉的變淡。
- 按 套用到草稿,修改就寫進那個工作流的草稿。要看大一點的畫布,按 在畫布上看。畫布上方有同樣的「套用到草稿」和「捨棄」。
- 套用之後還是草稿,發布之後才會生效。
也可以只改開始方式、設定或誰可以用。例如「早報改成平日早上 8 點」。卡片會寫出「開始方式」改成什麼。提議裡寫到的那一類會整份換掉,例如所有排程。沒寫到的不會動。
agent 不能自己建立或修改工作流,只能提議,由你按確認。還有兩個規則:
- 你在那個工作流要有「編輯」以上的權限,才能套用。修改裡有開始方式、設定或誰可以用時,要有「管理」權限。
- agent 讀了之後,有人又改了草稿,這份提議就不能套用。請 agent 重新讀一次再提議,才不會蓋掉別人的改動。
試跑
發布之前,可以用草稿實際跑一次:
- 切到「編輯」,按畫布上方的 試跑。
- 填好輸入,按「開始」。畫布會切到「執行」,跟著這一次走。
試跑時,關卡只問你,不會通知關卡上設定的人。直接用工具的步驟,每一步都先問你。試跑不算進執行紀錄的編號,在紀錄裡標成「試跑」。
開始方式
一個工作流可以用這幾種方式開始:
- 手動:在工作流頁按 執行,填好輸入,再按「開始」。
- 在對話裡請 agent 執行:跟 agent 說「跑一次股利選股」。agent 會依對話的內容填好輸入。短的工作流直接把結果告訴你。長的會先說「已經開始」,做完再回到同一則對話報告。對話裡會出現一張執行卡,見下面的「在對話裡看進度」。
- 寫進 agent 的技能或排程:例如在技能裡寫「收到報價單,就執行採購核准」。或在 agent 的排程「每週一整理上週的訂單」裡寫「整理好之後,執行這個工作流」。agent 做到那裡就會開始一次。排程裡用的是建立排程的人能執行的工作流。
- 排程:在「開始方式」分頁按 加排程,選頻率,填每次要用的輸入。發布之後排程才會開始。
- Webhook:在「開始方式」分頁按 建立網址。外部系統用 POST 把一個 JSON 物件送到這個網址,就會開始一次。網址只有管理這個工作流的人看得到。網址外流時,按「換一個網址」,舊的馬上失效。一個網址一小時最多開始 60 次。
- 回應是
{"ok": true, "run": 12}。run是這一次的編號,跟執行紀錄上的「第 12 次」一樣。 - 送進來的內容來自外部系統,所以這一次用對外的受眾。每一步只能用對外允許的工具。接在它後面開始的工作流也是對外。
- 回應是
- 另一個工作流結束時:在「開始方式」分頁選一個工作流,再選「做完時」或「不論結果」。那個工作流的結果裡,名稱跟輸入欄位一樣的會帶進來。
「用另一個工作流」要選已發布的工作流,而且這個工作流的擁有者要能執行它。工作流一層叫一層最多 3 層,接在別的工作流後面最多接 5 層,避免繞不停。
這些開始方式也可以在對話裡請 agent 設定,見上面的「在對話裡請 agent 畫或改」。
觸發和 agent 一律用已發布的版本。改草稿不影響正在跑的那幾次。
在對話裡看進度
agent 開始一次工作流時,對話裡會出現一張執行卡:
- 卡上寫著是哪個工作流的第幾次,和現在走到哪一步。
- 路徑條跟清單上的一樣。
- 停在等你決定的關卡時,卡片下面直接出現待處理的那一張。在這裡核准或拒絕就好。
- 做完時,卡片寫出結果。按 看這一次 打開畫布。
在 Slack 等通道裡執行
跟連上通道的 agent 說,也可以開始一次工作流。結果會回到同一個聊天室。長的工作流做完時,agent 會在那個聊天室報告。
通道裡的人不一定是團隊成員,所以:
- 這一次記成那位 agent 開始的。
{{trigger.name}}和{{trigger.email}}是空的。 - 通道可能是給客人用的(受眾是對外)。對外的通道預設叫不到任何工作流。要讓客人叫得到,做兩件事:
- 在工作流的「設定」打開 外部的人也可以透過 agent 執行。
- 在那條通道或某條規則的 工具權限,到「工作流」那一組把它打開。網站小工具也一樣。
- 工作流「設定」分頁的 在哪裡叫得到,列出所有打開它的地方。點 agent 的名字會跳到那個設定。
- 通道、規則或網站小工具的工具權限下面有 工作流的固定輸入。填了值的欄位,在那裡一律用這個值,agent 與對方都改不了。可以固定的是文字、數字與是否欄位。例如台中店的群組叫「補貨申請」時,門市一律是台中店。
讓 agent 執行工作流
- 在主控台打開一位 agent。
- 到 能力 的 工具。
- 選 工作流 分頁。
這個分頁有三個部分:
- 接受被工作流使用:關掉的話,工作流不能請它做事或審關卡。用到它的工作流也不能發布。
- 可以叫的工作流:每個工作流是一個工具。每個都可以設成「允許」「需核准」或「禁止」。設成「需核准」時,agent 開始之前會先問你。
- 沒設定時標著「工具預設」:團隊成員的對話是允許,對外的通道和網站小工具不給。
- 在這裡設的值,這位 agent 到哪裡都用,對外的通道也一樣。只想在某個通道開放,就到那個通道設。按重設回到預設。
- 用到它的工作流:列出已發布、有一步交給它的工作流。
同時好幾次
同一個工作流可以同時跑好幾次。每一次有自己的編號(第 12 次、第 13 次)和自己的資料,互相不影響。同一位 agent 也可以同時做不同次的同一步。
在「設定」分頁可以限制:
- 最多同時跑幾次:還沒做完的有這麼多次時,新的一次不會開始。例如填 1:上一次做完,下一次才能開始。空白就是不限。
- 新的一次取代還在等人的那一次:例如每天的報表,昨天那份還沒核准,今天就不用了。
沒有人在看時失敗了
排程、Webhook 或接在別的工作流後面開始的那一次,失敗時沒有人在旁邊看。所以工作流的擁有者會收到推播和通知信,寫出是哪一次、為什麼沒做完。同樣的原因一天只通知一次。
手動開始和在對話裡開始的,開始的人看得到結果,不另外通知。
「設定」分頁也列出發布過的每一版。按「還原成草稿」,可以把舊的一版拿回來改。
關卡在「待處理」
「問人」這一步會在待處理出現一張卡。卡上寫著是哪個工作流的第幾次,下面是要決定的內容:
- 核准或拒絕:跟一般的核准一樣。
- 選一個:每個選項一顆按鈕。這種關卡不能拒絕。
- 勾選多項:勾好要的項目,再按「確認」。
關卡設定了「問誰」:成員或角色。角色裡的每個人都會收到通知。「誰決定才算數」選「任一方」時,第一個人決定就往下走。選「全部」時,每一方都核准才往下走,有人拒絕就走拒絕那條線。
「問誰」也可以選 交給外部系統(API 串接)。關卡會送到那個串接的系統,例如 ERP,主管在 ERP 裡簽核就好。見 API 串接。
設了期限的關卡,到時間還沒有人決定,就走「逾時」那條線。
不一定要到待處理決定。在畫布切到「執行」,點等你決定的那個關卡,右邊的面板就有同一張卡。對話裡的執行卡下面也有。
「核准或拒絕」的關卡也可以請一位 agent 先審:
- 在「先讓 agent 審核(選填)」選一位 agent。
- 在「審核標準」寫清楚什麼情況核准、什麼情況拒絕。
- 在「agent 拿不定時交給誰」選成員或角色。
agent 會照標準核准或拒絕,也可以交給人決定。交給人時,卡上會寫出它的理由。
誰看得到什麼
每個工作流有一份授權名單,每個對象有一個等級:
| 等級 | 可以做什麼 |
|---|---|
| 執行 | 執行它。只看得到自己開始的那幾次,和最後的結果 |
| 查看 | 看每個人的每一次,包括每一步收到與交出的資料。也看得到 agent 做每一步時的對話 |
| 編輯 | 改草稿 |
| 管理 | 發布、改開始方式、改這份名單 |
新的團隊工作流預設是「所有人」和「所有 agent」都可以執行。工作流執行時用的是每一步 agent 自己的權限,跟開始的人無關。
要加對象,在「設定」分頁按 加對象。清單分成整個團隊、角色、成員和 agent,可以打字搜尋。
agent 在名單上只能執行。要改工作流時,在對話裡請 agent 提出修改就好,每一位 agent 都可以提。修改要有「編輯」以上權限的人確認,才會生效。
有些工作流會讀到每個人自己的資料,例如人事資料。這種工作流,請在步驟裡用 {{trigger.email}} 篩選。這個值由系統填,開始的人改不了。不要讓使用者自己填「要查誰」。不然,任何能執行的人都查得到別人的資料。
排程、Webhook 與通道開始的那幾次沒有「開始的人」,這個值是空的。所以這種工作流不要加排程,也不要放進通道裡的 agent 可以叫的工作流。
相關頁
本頁對應 v0.168.0