跳到內容

工作流

每次都照同樣順序做的事,可以排成一個工作流。每一步交給一位 agent 或一個工具,需要人決定的地方會停下來問。誰開始、什麼時候開始,結果都一樣。

這是什麼

agent 是你在 Dot Agents 裡建立的 AI 同事。平常你在對話裡請它做事,它自己決定怎麼做。

工作流是把一件事的順序先排好:

  • 第一步請研究 agent 篩出候選股。
  • 第二步判斷有沒有新標的。
  • 有的話,問投資小組要不要。
  • 小組核准後,請寫手 agent 寫報告。

它像一張交辦單:每一步由誰做、做完交給誰,都寫在上面。每一次都照這張單走,所以結果穩定,也看得出走到哪一步。

工作流只有 Enterprise 方案有。

在哪裡找到它

  • 對話頁:側欄「排程」下面的 工作流。
  • 主控台:側欄「工作區」下面的 工作流。
  • 手機 app:對話頁的抽屜裡有「工作流」。主控台在「更多」裡。
  • 排程頁:最下面有「工作流的排程」,列出你看得到的工作流有哪些排程。點一列,就到那個工作流的「開始方式」。

清單上每一列是一個工作流,分成四欄:

  • 名稱:名稱和說明。
  • 最近一次:路徑條是最近一次走到哪。綠點做完了,會動的點正在做。黃色菱形是等人的關卡,空心的還沒到。
  • 開始方式:除了手動,還可以怎麼開始。例如時鐘是排程,對話框是 agent 可以執行它。
  • 狀態:最近一次做完了沒有。有關卡在等你決定時,標「等你」,那一列排在最上面。

agent 在對話裡提議、你還沒建立的工作流,也排在最上面,標「待你確認」。agent 提議修改、你還沒決定的工作流,那一列標「有修改待確認」。

清單上方可以選「全部」「我可以執行的」「我管理的」,也可以搜尋名稱。

畫布

點進一個工作流,第一個分頁是畫布。畫布上方可以切換三種模式:

  • 檢視:看整張圖。點一個步驟,右邊會列出它的完整設定。
  • 執行:選一次執行,圖上會標出這一次走到哪裡。走過的線變深,沒走的線變淡。正在做的步驟有一個會動的點。等人決定的關卡標著「等人決定」。
  • 編輯:改草稿。只有「編輯」以上權限的人看得到這個模式。
工作流 · 畫布實際介面
「股利選股」的第 12 次。研究 agent 篩好了 3 檔,判斷走了「有」那條線,現在停在關卡等投資小組決定。切到「檢視」看整張圖,點任何一步看它的完整設定。

畫布上的步驟名稱和判斷的條件一定寫完整,不會被截掉。比較長的說明只顯示一行,點那一步就看得到全文。

要移動或縮放畫布:

  • 觸控板:兩指滑動來移動畫布。兩指捏合來放大或縮小。
  • 滑鼠:拖曳空白的地方來移動畫布。轉滾輪會上下移動。按住 ⌘ 或 Ctrl 再轉滾輪,可以放大或縮小。
  • 手機:一指拖曳來移動畫布。兩指捏合來放大或縮小。
  • 左下角的按鈕也可以放大和縮小。按「看整張」,整張圖會放進畫面。

在「編輯」模式,你可以拖曳步驟,畫布會記住你排的位置。按畫布上方的 整理排版,畫布會重新排一次。分岔的線照出口由上到下的順序接,不會交叉。agent 的修改加了新步驟時,畫布也會整張重新排。

「檢視」模式下,步驟旁邊的數字是現在有幾次停在這一步。點那一步,右邊會列出是哪幾次,選一次就切到「執行」看它。

「執行」模式下,點一個由 agent 做的步驟,右邊有 打開這一步的對話。按它可以看 agent 做這一步時說了什麼、用了哪些工具:

  • 在主控台:對話在右邊的對話窗打開。你可以接著問 agent。
  • 在對話頁:對話在工作流頁上打開。你只能看,不能回話。

建立一個工作流

  1. 在清單上按 新工作流。
  2. 填名稱和說明。選「團隊」或「只有我」。
  3. 按 建立,畫布會用編輯模式打開。
  4. 加步驟:
    • 先點一個步驟,再從左邊的步驟庫選。新的一步會接在你點的那一步後面。
    • 把步驟庫的步驟拖進畫布,再從接點拉一條線接上。
    • 按連線中間的「+」,新的一步會插在那條線上。
  5. 在右邊的面板填好這一步的設定。要用前面的結果,按欄位旁邊的「插入欄位」選一個。改動會自動存成草稿。
  6. 畫布上方會寫出還有幾個問題。按它可以一個一個跳過去看。
  7. 都改好了,按頁首的 發布。

編輯時可以用鍵盤:⌘Z 復原、⇧⌘Z 重做、⌘D 複製選著的那一步、Delete 刪除。

建立團隊工作流要有「工作流:建立」權限。個人工作流每個成員都能建,但只有你自己可以執行。

步驟有三類:

類別 步驟 做什麼
做事 請 agent 做 agent 用自己的工具和知識做一件事,交出你指定的欄位
做事 直接用工具 不用模型,用某位 agent 的權限直接呼叫一個工具
做事 整理資料 把前面的結果整理成新的欄位,不用模型
做事 用另一個工作流 跑另一個工作流,做完帶著它的結果往下
做事 每一項都做 清單裡每一項各跑一次另一個工作流,結果照順序收在一起
問人 問人 停下來等人核准、選一個,或勾選多項
控制 判斷 依條件走不同的線
控制 讓 AI 分類 agent 讀資料、挑一個類別,每個類別一條線。拿不定就走「其他情況」
控制 同時做 分成幾條路線同時做。路線接回同一步時,那一步等每條路線都做完
控制 等一下 等一段時間再往下。也可以設成等外部系統通知,見跑工作流
控制 結束 結束這一次,可以標成成功或失敗

要用前面某一步的結果,按欄位旁邊的「插入欄位」選一個。清單和判斷的條件不用打字,直接從選單選前面步驟交出的欄位。畫布和問題清單上,出口一律寫名字,例如「條件 1」「其他情況」「核准」。

判斷要看一個欄位是「是」還是「否」時,那個欄位的型別要是「是或否」。用文字欄位比「是」或「否」,條件永遠不成立,問題清單會列出這一項。

插入的欄位在格子裡寫成 {{步驟代號.欄位代號}}。步驟代號寫在面板的最上面。開始這一次的人的名字是 {{trigger.name}},email 是 {{trigger.email}}。

選 agent

要選 agent 的地方都用同一個選單:請 agent 做、直接用工具、讓 AI 分類,還有關卡的「先讓 agent 審核」。選單上有每位 agent 的頭像。不接受被工作流使用的 agent,名字下面會寫出來。

直接用工具

  1. 在「用哪個 agent 的權限」選一位 agent。
  2. 按 選一個工具。清單跟 agent 的工具頁長得一樣,照分組列出,也可以搜尋。
  3. 按 用這個。
  4. 下面會一格一格列出這個工具要的值。必填的會標出來,有固定選項的用下拉選單。每一格都可以用「插入欄位」帶入前面的資料。

清單只列這位 agent 在工作流裡用得到的工具。被禁止的工具不會列出。要在對話裡才能用的工具也不會列出,例如問人、改對話名稱。發布時也會再檢查一次:這位 agent 用不了那個工具,就不能發布。

同時做

「同時做」有自己的路線,預設兩條:「路線 1」和「路線 2」。

  1. 從每條路線右邊的出口,拉一條線到那條路線的第一步。
  2. 在面板可以改路線的名字,也可以加一條或刪一條。
  3. 每條路線的最後,都接回同一步。那一步會等每條路線都做完,才開始。

路線沒有接回同一步時,畫布上會寫出這個問題。不然先走到「結束」的那條路線會停掉整個工作流,其他路線會做到一半就停。

用另一個工作流、每一項都做

  • 用另一個工作流 是一張卡。它跑一次選的工作流,做完帶著結果往下。面板會寫出它做完交出哪些欄位,後面的步驟用「插入欄位」選。
  • 每一項都做 畫成疊起來的卡。在「清單從哪裡來」選前面步驟交出的一個清單。清單有幾項,選的工作流就跑幾次,最多 50 項。在給它的輸入裡,用「插入欄位」選「這一項」。做完交出「每一項的結果」、「做了幾項」和「沒做成的幾項」。

在對話裡請 agent 畫或改

你也可以直接在對話裡說,例如「幫我做一個工作流:員工請假先問主管,核准後通知人事」。

  1. agent 會在對話裡放一張草稿卡,上面有縮小的畫布和步驟數。
  2. 選「團隊」或「只有我」,再按 建立。要先改一改,就按 在畫布上調整。
  3. 想改哪裡,直接跟 agent 說,它會改同一張草稿卡。
  4. 不要這份草稿,就按 捨棄。

還沒建立的草稿不會不見:工作流清單最上面會列出它,標「待你確認」。點進去可以看畫布,再按「建立」或「捨棄」。

在主控台的對話窗按「打開工作流」,會打開主控台的工作流頁。在對話頁按,就打開對話頁的。

開始方式、設定和誰可以用,也可以一起跟 agent 說。例如「每個工作日早上 9 點跑,同時只跑一次,團隊所有人都可以用」:

  • 卡片會寫出這些設定,例如「開始方式 平日 09:00 · 時區 Asia/Taipei」。
  • 按 建立 時,排程、設定和名單會一起建好。
  • 排程在發布之後才會開始跑。發布之前經過的時間不會補跑。
  • 選「只有我」時,不會用卡片上的名單。個人工作流只有你可以用。

已經有的工作流,也可以用說的改。例如「採購核准的主管核准之後,加一步通知採購」:

  1. agent 先讀那個工作流,再提議修改。
  2. 對話裡會出現一張「修改「採購核准」」的卡。卡上寫出新增、修改、刪掉了哪幾步。縮小的畫布上,新的步驟標「新」,改過的標「改」,刪掉的變淡。
  3. 按 套用到草稿,修改就寫進那個工作流的草稿。要看大一點的畫布,按 在畫布上看。畫布上方有同樣的「套用到草稿」和「捨棄」。
  4. 套用之後還是草稿,發布之後才會生效。

也可以只改開始方式、設定或誰可以用。例如「早報改成平日早上 8 點」。卡片會寫出「開始方式」改成什麼。提議裡寫到的那一類會整份換掉,例如所有排程。沒寫到的不會動。

對話 · agent 提議修改工作流實際介面
agent 照對話提議改「股利選股」:加一步「通知投資小組」,篩選的指示也改了,排程改成平日 08:30。按「套用到草稿」,卡片寫出已經套用。

agent 不能自己建立或修改工作流,只能提議,由你按確認。還有兩個規則:

  • 你在那個工作流要有「編輯」以上的權限,才能套用。修改裡有開始方式、設定或誰可以用時,要有「管理」權限。
  • agent 讀了之後,有人又改了草稿,這份提議就不能套用。請 agent 重新讀一次再提議,才不會蓋掉別人的改動。

試跑

發布之前,可以用草稿實際跑一次:

  1. 切到「編輯」,按畫布上方的 試跑。
  2. 填好輸入,按「開始」。畫布會切到「執行」,跟著這一次走。

試跑時,關卡只問你,不會通知關卡上設定的人。直接用工具的步驟,每一步都先問你。試跑不算進執行紀錄的編號,在紀錄裡標成「試跑」。

開始方式

一個工作流可以用這幾種方式開始:

  • 手動:在工作流頁按 執行,填好輸入,再按「開始」。
  • 在對話裡請 agent 執行:跟 agent 說「跑一次股利選股」。agent 會依對話的內容填好輸入。短的工作流直接把結果告訴你。長的會先說「已經開始」,做完再回到同一則對話報告。對話裡會出現一張執行卡,見下面的「在對話裡看進度」。
  • 寫進 agent 的技能或排程:例如在技能裡寫「收到報價單,就執行採購核准」。或在 agent 的排程「每週一整理上週的訂單」裡寫「整理好之後,執行這個工作流」。agent 做到那裡就會開始一次。排程裡用的是建立排程的人能執行的工作流。
  • 排程:在「開始方式」分頁按 加排程,選頻率,填每次要用的輸入。發布之後排程才會開始。
  • Webhook:在「開始方式」分頁按 建立網址。外部系統用 POST 把一個 JSON 物件送到這個網址,就會開始一次。網址只有管理這個工作流的人看得到。網址外流時,按「換一個網址」,舊的馬上失效。一個網址一小時最多開始 60 次。
    • 回應是 {"ok": true, "run": 12}。run 是這一次的編號,跟執行紀錄上的「第 12 次」一樣。
    • 送進來的內容來自外部系統,所以這一次用對外的受眾。每一步只能用對外允許的工具。接在它後面開始的工作流也是對外。
  • 另一個工作流結束時:在「開始方式」分頁選一個工作流,再選「做完時」或「不論結果」。那個工作流的結果裡,名稱跟輸入欄位一樣的會帶進來。

「用另一個工作流」要選已發布的工作流,而且這個工作流的擁有者要能執行它。工作流一層叫一層最多 3 層,接在別的工作流後面最多接 5 層,避免繞不停。

這些開始方式也可以在對話裡請 agent 設定,見上面的「在對話裡請 agent 畫或改」。

觸發和 agent 一律用已發布的版本。改草稿不影響正在跑的那幾次。

在對話裡看進度

agent 開始一次工作流時,對話裡會出現一張執行卡:

  • 卡上寫著是哪個工作流的第幾次,和現在走到哪一步。
  • 路徑條跟清單上的一樣。
  • 停在等你決定的關卡時,卡片下面直接出現待處理的那一張。在這裡核准或拒絕就好。
  • 做完時,卡片寫出結果。按 看這一次 打開畫布。
對話 · 工作流的執行卡實際介面
agent 開始了「股利選股」的第 12 次,停在關卡等你。按「核准」,關卡變成做完,下一步「寫研究報告」開始做。

在 Slack 等通道裡執行

跟連上通道的 agent 說,也可以開始一次工作流。結果會回到同一個聊天室。長的工作流做完時,agent 會在那個聊天室報告。

通道裡的人不一定是團隊成員,所以:

  • 這一次記成那位 agent 開始的。{{trigger.name}} 和 {{trigger.email}} 是空的。
  • 通道可能是給客人用的(受眾是對外)。對外的通道預設叫不到任何工作流。要讓客人叫得到,做兩件事:
    1. 在工作流的「設定」打開 外部的人也可以透過 agent 執行。
    2. 在那條通道或某條規則的 工具權限,到「工作流」那一組把它打開。網站小工具也一樣。
  • 工作流「設定」分頁的 在哪裡叫得到,列出所有打開它的地方。點 agent 的名字會跳到那個設定。
  • 通道、規則或網站小工具的工具權限下面有 工作流的固定輸入。填了值的欄位,在那裡一律用這個值,agent 與對方都改不了。可以固定的是文字、數字與是否欄位。例如台中店的群組叫「補貨申請」時,門市一律是台中店。

讓 agent 執行工作流

  1. 在主控台打開一位 agent。
  2. 到 能力 的 工具。
  3. 選 工作流 分頁。

這個分頁有三個部分:

  • 接受被工作流使用:關掉的話,工作流不能請它做事或審關卡。用到它的工作流也不能發布。
  • 可以叫的工作流:每個工作流是一個工具。每個都可以設成「允許」「需核准」或「禁止」。設成「需核准」時,agent 開始之前會先問你。
    • 沒設定時標著「工具預設」:團隊成員的對話是允許,對外的通道和網站小工具不給。
    • 在這裡設的值,這位 agent 到哪裡都用,對外的通道也一樣。只想在某個通道開放,就到那個通道設。按重設回到預設。
  • 用到它的工作流:列出已發布、有一步交給它的工作流。

同時好幾次

同一個工作流可以同時跑好幾次。每一次有自己的編號(第 12 次、第 13 次)和自己的資料,互相不影響。同一位 agent 也可以同時做不同次的同一步。

在「設定」分頁可以限制:

  • 最多同時跑幾次:還沒做完的有這麼多次時,新的一次不會開始。例如填 1:上一次做完,下一次才能開始。空白就是不限。
  • 新的一次取代還在等人的那一次:例如每天的報表,昨天那份還沒核准,今天就不用了。

沒有人在看時失敗了

排程、Webhook 或接在別的工作流後面開始的那一次,失敗時沒有人在旁邊看。所以工作流的擁有者會收到推播和通知信,寫出是哪一次、為什麼沒做完。同樣的原因一天只通知一次。

手動開始和在對話裡開始的,開始的人看得到結果,不另外通知。

「設定」分頁也列出發布過的每一版。按「還原成草稿」,可以把舊的一版拿回來改。

關卡在「待處理」

「問人」這一步會在待處理出現一張卡。卡上寫著是哪個工作流的第幾次,下面是要決定的內容:

  • 核准或拒絕:跟一般的核准一樣。
  • 選一個:每個選項一顆按鈕。這種關卡不能拒絕。
  • 勾選多項:勾好要的項目,再按「確認」。
待處理 · 工作流的關卡實際介面
「股利選股」第 12 次的兩個關卡。第一張是核准或拒絕,第二張要選一種報告格式。按下去,那一張會從清單上消失。

關卡設定了「問誰」:成員或角色。角色裡的每個人都會收到通知。「誰決定才算數」選「任一方」時,第一個人決定就往下走。選「全部」時,每一方都核准才往下走,有人拒絕就走拒絕那條線。

「問誰」也可以選 交給外部系統(API 串接)。關卡會送到那個串接的系統,例如 ERP,主管在 ERP 裡簽核就好。見 API 串接。

設了期限的關卡,到時間還沒有人決定,就走「逾時」那條線。

不一定要到待處理決定。在畫布切到「執行」,點等你決定的那個關卡,右邊的面板就有同一張卡。對話裡的執行卡下面也有。

「核准或拒絕」的關卡也可以請一位 agent 先審:

  1. 在「先讓 agent 審核(選填)」選一位 agent。
  2. 在「審核標準」寫清楚什麼情況核准、什麼情況拒絕。
  3. 在「agent 拿不定時交給誰」選成員或角色。

agent 會照標準核准或拒絕,也可以交給人決定。交給人時,卡上會寫出它的理由。

誰看得到什麼

每個工作流有一份授權名單,每個對象有一個等級:

等級 可以做什麼
執行 執行它。只看得到自己開始的那幾次,和最後的結果
查看 看每個人的每一次,包括每一步收到與交出的資料。也看得到 agent 做每一步時的對話
編輯 改草稿
管理 發布、改開始方式、改這份名單

新的團隊工作流預設是「所有人」和「所有 agent」都可以執行。工作流執行時用的是每一步 agent 自己的權限,跟開始的人無關。

要加對象,在「設定」分頁按 加對象。清單分成整個團隊、角色、成員和 agent,可以打字搜尋。

agent 在名單上只能執行。要改工作流時,在對話裡請 agent 提出修改就好,每一位 agent 都可以提。修改要有「編輯」以上權限的人確認,才會生效。

相關頁

本頁對應 v0.168.0