使用說明 使用說明
Workspace

節點類型一覽

「新增節點」裡的每一種節點在做什麼,以及節點的設定視窗:欄位、節點設定與資料窗格。

本頁內容 8

「新增節點」把節點分成幾組,順序是「觸發」、「流程」、「動作」與「轉換」。這一頁照這幾組,寫出每一種節點在做什麼,最後說明每一個節點都有的設定視窗。怎麼把節點加到畫布上,請看畫布。

節點的名稱,這一頁照「新增節點」裡寫的寫,包括括號裡的英文。

觸發

一次完整的執行,從一個觸發節點開始。一個工作流可以有好幾個觸發節點。

  • 「手動觸發」:按上方列的「執行」時,從這裡開始。請看手動觸發。
  • 「排程觸發」:照排好的時間啟動,例如每天早上九點。請看排程觸發。
  • 「Webhook」:外部系統用 HTTP 呼叫這個工作流的網址時啟動。請看Webhook與Webhook 觸發:用網址啟動工作流。
  • 「子工作流觸發」:另一個工作流用「執行子工作流」呼叫這一個時,從這裡開始。請看子工作流。
  • 「Agent 對話」:工作流是「啟用中」時,有人在一段「對話」模式的 AI 對話裡傳訊息給選定的 AI Agent,就會執行這個工作流,由它代替 AI Agent 回答。請看Agent 對話。
  • 「AI 工具」:讓 AI Agent 在回答到一半時,把這個工作流當成一個工具來用。請看AI 工具。

流程

  • 「編輯欄位 (Set)」:替每一筆項目新增或改寫欄位。在「欄位指派 (Assignments)」裡,每一列填「欄位名稱」、「型別」與「值」。預設只送出這裡設的欄位,項目原本的其他欄位會被丟掉;打開「保留其他欄位」,就會留下原本的全部欄位,再加上這裡設的。
  • 「條件判斷 (IF)」:一筆一筆檢查「條件」。成立的項目從 true 這條線送出,其他的從 false 送出。一條線上沒有任何項目時,接在它後面的節點會被跳過。條件怎麼寫,請看條件。
  • 「多路分流 (Switch)」:畫布上這個節點只有一個出口的點,所以只接得到它第一條規則的線。這個節點往其他方向送出的項目,不會到任何地方。要把項目分成好幾路,請串接幾個「條件判斷 (IF)」,或是用幾個「篩選 (Filter)」。
  • 「篩選 (Filter)」:留下條件成立的項目,其他的丟掉。它只有一條出口,丟掉的項目不會從別的線送出。條件的寫法和「條件判斷 (IF)」一樣。
  • 「合併 (Merge)」:把好幾條進來的線合成一條。
    • 「合併模式 (Mode)」可以選「接續合併 (Append)」、「配對合併 (Combine)」、「SQL 查詢 (SQL Query)」或「指定分支 (Choose Branch)」。
    • 選「配對合併 (Combine)」時,「配對依據 (Combine By)」可以選「比對欄位 (Matching Fields)」、「依位置 (Position)」或「全部組合 (All Possible Combinations)」。
    • 「輸入數量 (Number of Inputs)」只在「接續合併 (Append)」、依「依位置 (Position)」的「配對合併 (Combine)」、「SQL 查詢 (SQL Query)」與「指定分支 (Choose Branch)」出現。其他時候,它一律接兩條線。
    • 其中一條線沒有任何項目時,這個節點還是會執行。
    • 「SQL 查詢 (SQL Query)」讀進來的項目,和查出來的資料,都有筆數的上限。超過時,這個節點會失敗,訊息會說超過了上限。
  • 「逐批處理 (Loop Over Items)」:每一次從 loop 這條線,送出「批次大小 (Batch Size)」筆項目。把處理這些項目的節點,接回這個節點的左邊。項目都送完之後,done 這條線會一次送出迴圈裡收集到的全部結果。
  • 「程式碼 (Code)」:執行你自己寫的 JavaScript。程式碼在另一個獨立的服務裡跑,不能載入 npm 套件。「執行模式 (Mode)」可以選「所有項目執行一次」或「每個項目各執行一次」。怎麼寫,請看程式碼節點。
  • 「等待」:讓這次執行停下來,時間到了再繼續。
    • 「等待模式 (Resume Mode)」可以選「間隔時間 (Time Interval)」或「指定時間點 (Specific Time)」。選「間隔時間 (Time Interval)」時,填「間隔」和「間隔單位」(秒、分鐘、小時或天)。
    • 「指定時間點」照欄位說明的格式,寫成日期加時間,例如 2026-08-01 09:00:00。這個時間是照網站自己的時區讀的,不是「工作流設定」裡的「時區」。時間已經過了,就不會等,直接往下走。
    • 停在「等待」的執行,不算在專案同時在跑的數量裡。
    • 最長可以等 7 天。等更久時,整個執行會失敗,就算這個節點設成失敗時繼續也一樣,訊息是「等待時間太長了,最多只能等 7 天。」等待的時間也算在執行的時間上限裡:等得比執行時間上限還久時,醒來的那一刻,執行就會因為超過時間上限而失敗。
    • 這幾種執行不能有會等待的節點:「Webhook」設成「跑完再回傳資料」的執行(請看Webhook 的回應、狀態碼與上限)、Agent 對話的執行,以及 AI 工具的執行。
  • 「執行子工作流」:執行另一個「權限」加上了這個工作流,或有「所有工作流」而這個工作流在範圍裡的工作流。請看子工作流。
  • 「中止並拋出錯誤」:讓這次執行以失敗結束,並寫下你在「錯誤訊息」填的字。這段字會傳給失敗時要執行的工作流,請看錯誤工作流。這個節點自己的「這個節點失敗時」設成「繼續(一般輸出)」時,執行不會停下來。
  • 「無操作 (No Op)」:什麼都不做,把項目原樣交給下一個節點,常用來把幾條線匯成一條。
  • 「回應 Webhook」:決定呼叫 Webhook 的一方收到什麼,請看「回應 Webhook」節點。
  • 「回應 AI 工具」:決定 AI Agent 用這個工作流當工具時拿回什麼,請看AI 工具。

動作

  • 「HTTP 請求」:呼叫外部的 HTTP API,進來的每一筆項目各呼叫一次。其他的都寫在用「HTTP 請求」節點呼叫外部 API。
  • 「AI Agent」:問這個網站的一個 AI Agent,進來的每一筆項目各問一次,把回答變成項目。
    • 它只執行把這個工作流放在權限清單上的 AI Agent:AI Agent 的權限清單上有這個工作流,或有「所有工作流」而這個工作流在它的範圍裡,權限是「檢視」或「編輯」都可以,不論 AI Agent 和工作流各在哪一個專案。工作流的擁有者、按了「執行」的人看不看得到這個 AI Agent,都沒有關係。不是這樣的 AI Agent、已經刪掉的 AI Agent,或「Agent」沒有選時,節點在問任何問題之前就失敗,寫著「找不到這個 AI Agent,或它沒有開放給這個工作流。」接下來怎麼走,看這個節點的「這個節點失敗時」。
    • 要讓工作流使用一個 AI Agent,由 AI Agent 的擁有者在它的「權限」分頁加上這個工作流,請看權限分頁。
    • 這個 AI Agent 的資料表工具碰得到一個資料表,和在對話裡一樣,看的是資料表的「AI 權限設定」有沒有把那件事的權限給這個 AI Agent。技能、「工作流」和「文件」的工具也和在對話裡一樣,看的是技能、工作流或頁面的權限清單有沒有開放給這個 AI Agent,請看工具的分類。「開一張資料表」和「新增一筆資料」在沒有人登入的工作流執行裡(例如按上方列的「執行」跑整個工作流,或排程、Webhook 啟動的執行)用不了:新的資料表和資料要有一個擁有者,這種執行裡沒有這個人。「建立 / 技能」、「開文件頁面」和「建立 AI Agent」做出來的東西也要有一個人來擁有或建立,「匯入工作流」寫進工作流也要替一個人寫,所以這四個工具在這種執行裡也用不了。
    • 有兩種執行是有人登入著的,「新增一筆資料」、「建立 / 技能」、「開文件頁面」和「建立 AI Agent」在裡面用得了;「開一張資料表」也用得了,但私人工作流除外;「匯入工作流」也用得了,開新的工作流時有一個條件,寫在下面。一種是卡片上的「執行節點」和設定視窗的「儲存並執行」:它們在按下按鈕的人登入著的時候執行,所以做出來的資料表、資料、技能、最上層頁面、AI Agent 和工作流屬於按下按鈕的人,子頁面也由這個人建立,「新增一筆資料」和「修改一筆資料」留下的版本紀錄也寫著這個人,雖然沒有人在和 AI Agent 對話。另一種是「Agent 對話」或「AI 工具」觸發的執行:正在和 AI Agent 對話的人還登入著,做出來的東西屬於這個人,子頁面也由這個人建立。這兩種執行都在工作流所在的專案裡執行,所以「開一張資料表」建立的資料表,放在工作流所在的專案裡,不是按下按鈕或正在對話的人目前的專案。私人工作流沒有專案,所以在私人工作流的這兩種執行裡,「開一張資料表」會被拒絕,寫著「現在沒有指定專案,開不了資料表。資料表一定屬於某個專案,請在網頁上先切到要看的專案再問一次。」;「新增一筆資料」還是用得了,新的資料放在那個資料表自己的專案裡。「建立 / 技能」、「開文件頁面」和「建立 AI Agent」不看專案,所以在私人工作流的這兩種執行裡也用得了。「匯入工作流」在這兩種執行裡都蓋得掉把「編輯」開放給這個 AI Agent 的工作流;開一個新的工作流時,按下按鈕或正在對話的人要是工作流所在專案的成員,所以在私人工作流的這兩種執行裡開不了,寫著「開不了新的工作流:目前沒有指定專案,或和你對話的人不是目前專案的成員,而新的工作流只有目前專案的成員開得了。要蓋掉既有的工作流,請帶 workflow_id。」只執行這一個節點時用得了的「新增一筆資料」、「開一張資料表」、「建立 / 技能」、「開文件頁面」、「建立 AI Agent」和「匯入工作流」,按上方列的「執行」跑整個工作流時會被拒絕。
    • 欄位有「Agent」、「模型」、「提示詞 (Prompt)」、「輸出格式」(「純文字」或「JSON」)、「思考層級」(「快速」或「深度」)與「逾時秒數」。選「JSON」時,還有「結構來源」可以選「自己描述」或「逐欄設定」,再照選的方式填「JSON 結構」或「輸出欄位」。
    • 「Agent」只列出把「檢視」或「編輯」開放給這個工作流的 AI Agent,權限清單上的「所有工作流」也算,不論你自己看不看得到它,也不論它在哪一個專案。不在這個工作流所在專案裡的 AI Agent,排在後面,名字後面寫著它所在專案的名稱;私人 AI Agent 寫著「私人」。私人工作流上,私人 AI Agent 排在前面,只寫名字;每一個專案的 AI Agent 排在後面,寫著它所在專案的名稱。
    • 沒有任何 AI Agent 開放給這個工作流時,「Agent」的清單是空的,下面寫著「還沒有 AI Agent 開放「檢視」或「編輯」給這個工作流。」
    • 「模型」的第一個選項是「跟著 Agent 預設」,新放上的節點一開始就選它:用 AI Agent 自己的預設 AI 模型。它下面列出選的 AI Agent 允許的模型,請看允許 AI 模型。還沒有選 AI Agent,或選的 AI Agent 沒有開放給這個工作流時,清單裡只有「跟著 Agent 預設」。選了一個模型之後,按框右邊的 ×,會回到「跟著 Agent 預設」。框裡寫著「請選擇」時,也一樣用 AI Agent 自己的預設模型。這些模型用點數還是用金鑰付費,請看AI 點數與金鑰。
  • 「SSE Agent」:問一個 AI Agent,把回答一邊產生、一邊送進對話。它是給「Agent 對話」觸發的工作流用的,請看Agent 對話。在其他的執行裡,它只把整段回答當成輸出。
    • 它問的 AI Agent,規則和「AI Agent」節點一樣:要在 AI Agent 的權限清單上開放「檢視」或「編輯」給這個工作流,否則節點失敗,寫著「找不到這個 AI Agent,或它沒有開放給這個工作流。」「Agent」選「跟著對話」時,問的是這段對話本來的 AI Agent,它也一樣要開放給這個工作流。
    • 沒有對話的執行,例如在畫布上按「執行」,或「對話」欄位算出來是空的,「跟著對話」沒有 AI Agent 可以問,節點會失敗,寫著同一句話。對話本來沒有 AI Agent 時也一樣。要自己試這個節點,請在「Agent」選一個 AI Agent。
    • 「對話」欄位只讀得到一段對話:「Agent 對話」觸發的這次執行要回覆的那一段。填了別的對話編號,就算是工作流擁有者自己參加的對話,節點也會當成沒有這段對話:不帶任何對話紀錄,AI Agent 的工具也不會知道這段對話;「Agent」是「跟著對話」時沒有 AI Agent 可以問,節點會失敗,寫著同一句話。按「重試」重新跑一次失敗的對話執行時,它已經不是在回覆對話,所以也讀不到那段對話,「跟著對話」的這個節點會失敗。
    • 「Agent」在「跟著對話」下面,列出把「檢視」或「編輯」開放給這個工作流的 AI Agent,規則和「AI Agent」節點一樣。
    • 它問的 AI Agent 用資料表工具、技能、「工作流」和「文件」的工具時,規則也和「AI Agent」節點一樣:只看資料表的「AI 權限設定」,或技能、工作流、頁面的權限清單;「開一張資料表」、「新增一筆資料」、「建立 / 技能」、「匯入工作流」、「開文件頁面」和「建立 AI Agent」在沒有人登入的工作流執行裡用不了。
    • 「Agent」、「模型」與「思考層級」的第一個選項都是「跟著對話」,新放上的節點一開始就選它:用這段對話本來的 AI Agent、模型或思考層級。「Agent」與「模型」選了別的之後,按框右邊的 ×,會回到「跟著對話」。框裡寫著「請選擇」時,也一樣是跟著對話。
    • 「模型」在「Agent」選「跟著對話」時,列出現在可以選的每一個模型;選了 AI Agent 時,列出它允許的模型,它沒有開放給這個工作流時,清單裡只有「跟著對話」。
  • 「生成圖片」:進來的每一筆項目,各用 AI 生成一張圖片,存成媒體編輯的素材。私人工作流沒有專案可以存素材,所以這個節點在私人工作流裡執行失敗,寫著「這個節點不能在私人工作流裡執行:它要用到專案裡的素材。」
    • 欄位有「提示詞 (Prompt)」、「圖片模型」、「金鑰」、「長寬比」、「畫質」與「保留素材」。
    • 「畫質」是做出來的圖片有多大,每一個模型都列出一樣的選項。模型做不出選的畫質時,會做成它做得出的最小的那一個。游標指著「畫質」那一列右邊的小圖示時,會顯示:「Gemini Image Flash-Lite 3.1 只做得出 1K:選別的畫質,也會做成 1K。」畫質越高,用掉的點數通常越多,請看價格表。
    • 「金鑰」每一個模型都有,也可以不選。它只列出開放給這個工作流的 AI 模型金鑰,請看工作流用得到哪些憑證。沒有選的時候,它寫著「Cowork Style 點數」:用網站的金鑰做圖,消耗工作流擁有者的點數。選了一把那一家的金鑰,就用那把金鑰付費。要改回點數,就把「金鑰」清掉;選的金鑰在清單上找不到時,框下面會寫「這裡找不到選的憑證。」,按後面的「清掉」。請看AI 點數與金鑰。
    • 節點帶著的金鑰,就是它會用的金鑰,但要開放給這個工作流:金鑰的「權限」分頁要加上這個工作流,請看工作流用得到哪些憑證。沒有開放時,這個節點執行失敗,寫著「憑證「名稱」沒有開放給這個工作流。請憑證的擁有者在憑證的「權限」分頁加上這個工作流。」私人金鑰與別的專案的金鑰也可以開放給這個工作流,不論擁有者是誰;選的是沒有開放給這個工作流的私人金鑰時,寫著「節點「…」選的私人憑證沒有開放給這個工作流。請私人憑證的擁有者在憑證的「權限」分頁加上這個工作流。」金鑰被刪掉了,或選到別家的金鑰,這個節點也會停下來並顯示錯誤。工作流擁有者的點數用完時,這個節點執行失敗,原因就是點數用完的那一句話,請看點數用完的時候。
    • 這個節點沒有張數的上限:進來多少筆項目,就生成多少張,每一張都要付一次錢。
    • 生成的素材一開始是暫存的,過一段時間會被自動刪掉。打開「保留素材」,才會一直留著。
    • 沒有選金鑰時用點數付費。點數算在這個節點執行的那一刻、工作流的擁有者名下;生成的素材也屬於那個人。工作流在執行途中交接給別人時,從下一個節點起,由新的擁有者付費。
  • 「資料表」:讀取或寫入這個網站資料表裡的資料列,或是列出、新增、重新命名或清空資料表。這個節點現在還不能執行:它可以放上畫布、可以設定,但執行時會失敗。「資源」選「資料表」時,寫著「這個節點還不能使用:工作流還不能存取資料表。」「資源」選「資料列」時,寫著「這個節點還不能使用:工作流還不能存取資料。」節點的設定裡也寫著「這個節點還不能使用:工作流還不能存取資料表與資料。等資料表改用權限清單之後,才能在工作流裡使用。」
  • 「文件頁面」:讀取、建立或更新文檔裡的頁面,或列出一個頁面的子頁面。頁面的內容一律用 Markdown 進出。
    • 這個節點只碰得到開放給這個工作流的頁面:頁面的權限清單上要有這個工作流,或有「所有工作流」而這個工作流在範圍裡(頁面在專案裡時,是那個專案的工作流;「私人」頁面是擁有者所在的每一個專案的工作流,以及擁有者自己的私人工作流),請在頁面的「分享與權限」→「權限」加上它,請看權限。跟著父頁面的頁面,看的是它跟著的那一頁的清單。頁面在哪一個專案,或是「私人」的,都算,和這個工作流在哪裡無關;工作流的擁有者和按了「執行」的人能不能打開這一頁,都不會被問到。
    • 每一種「操作」要的權限:「讀取頁面」和「列出子頁面」要「檢視」;「更新頁面」要「編輯」,而且頁面不能是鎖定的;「建立頁面」選了「父頁面」時,父頁面要給「編輯」,父頁面鎖定了也可以。給了更後面的權限,也做得到。
    • 頁面沒有開放給這個工作流、權限不夠,或頁面不存在時,這個節點執行失敗,寫著「找不到這個文件頁面,或它沒有開放給這個工作流。」「更新頁面」碰到給了「編輯」但鎖定的頁面時,寫著「這個文件頁面已鎖定,不能更新。請先在文件裡解除鎖定。」,什麼都不改。
    • 「列出子頁面」不會列出沒有開放給這個工作流的子頁面,例如有自己的權限清單、清單上沒有這個工作流的子頁面。
    • 「頁面」選單列出開放給這個工作流、給了「檢視」以上的頁面;「父頁面」選單列出給了「編輯」以上的頁面,鎖定的也列出來。封存的頁面不會列出來。選單依名字排列,每一頁後面寫著它的專案名稱,或「(私人)」;沒有名字的頁面寫著「(未命名)」。私人工作流也列得出它的頁面。
    • 「建立頁面」沒有選「父頁面」時,做出來的是最上層的頁面:擁有者是工作流的擁有者,放在工作流的專案裡;私人工作流做出來的是「私人」頁面。不會問任何人。這時候多出兩個欄位,不能用運算式:
      • 「給這個工作流的權限」:「檢視」、「編輯」或「權限控管」,預設是「權限控管」。
      • 「給所有專案成員的權限」:「不給」、「檢視」、「編輯」或「權限控管」,預設是「不給」。私人工作流不會顯示這個欄位,也不會用到它。
    • 新頁面的權限清單,只有這兩個欄位說的:這個工作流拿到第一個欄位的權限;第二個欄位不是「不給」時,所有專案成員拿到它的權限。節點做出的每一個最上層頁面都照這兩個欄位,「父頁面」用運算式算出來是空的時候也一樣。
    • 選了「父頁面」時,新頁面跟著父頁面,放在父頁面的專案裡,擁有者是那棵頁面樹的擁有者,這兩個欄位不會顯示。
    • 「建立頁面」做出的每一個頁面,一開始有一筆版本紀錄;「更新頁面」每改一次,就多一筆。這些版本紀錄下面多一行「工作流:」和這個工作流的名字;這次執行是一個人開始的時候(例如按了「執行」),也寫著那個人,排程、Webhook、AI Agent 或另一個工作流開始的執行,不寫任何人。「更新頁面」沒有填標題也沒有填內容時,不會多一筆。工作流不能還原版本紀錄。
    • 「更新頁面」改的內容,會馬上出現在每一個打開這一頁的編輯器裡,有沒有人在這一頁打過字都一樣;上方列的頭像會多出這個工作流,它最後改到的那一段後面,會出現一條標著它名字的線,請看一起編輯。「附加 (Append)」把新內容接在這一頁現在存著的內容後面。
    • 填了內容的「更新頁面」,輸出的每一筆項目多一個 content_live:true 是內容已經進到編輯器;false 是寫入內文的服務暫時連不上,內容要等下一次有可以編輯這一頁的人打開它,才會進到編輯器。這時已經開著這一頁的分頁一打字,工作流改的內容就可能不見。
  • 「傳送訊息」:在對話 app 裡選定的一段對話送出一則文字訊息。這個節點現在還不能執行:執行時會失敗,寫著「這個節點還不能使用:工作流還不能存取對話。」節點的設定裡也寫著「這個節點還不能使用:工作流還不能存取對話。等對話改用權限清單之後,才能在工作流裡使用。訊息若送到外部對話(LINE、Messenger),會實際送達客戶且無法收回。」
  • 「Facebook Graph API」與「Instagram」:各自從開放給這個工作流的 Facebook 粉專,或這些粉專底下的 Instagram 帳號裡,選一個來用。粉專是用「+ 連結粉專」連進來的,請看連結 Facebook 粉專。
    • 「粉絲專頁」選單只列出開放給這個工作流的粉專,依名稱排列,不論粉專在哪一個專案,或是私人粉專;「Instagram 帳號」選單只列出這些粉專底下的帳號。一個都沒有時,選單下面寫著「還沒有憑證開放給這個工作流。請憑證的擁有者在憑證的「權限」分頁加上它。」看得到這個工作流的人,都看得到節點選了哪一個;要改選,要能編輯這個工作流。
    • 停用的粉專,以及它底下的帳號,在選單裡後面會寫「(已停用)」;用了它們的節點,執行時會失敗。
    • 執行時,選的粉專,或選的帳號的粉專,要開放給這個工作流,和工作流擁有者能不能用它、是誰按了「執行」都沒有關係,請看工作流用得到哪些憑證。沒有開放時,這個節點執行失敗,寫著「憑證「名稱」沒有開放給這個工作流。請憑證的擁有者在憑證的「權限」分頁加上這個工作流。」選的是 Instagram 帳號時,「名稱」是它的粉專的名稱。私人的粉專與別的專案的粉專也可以開放給這個工作流,不論擁有者是誰;選的粉專,或選的帳號的粉專,是沒有開放給這個工作流的私人粉專時,寫著「節點「…」選的私人憑證沒有開放給這個工作流。請私人憑證的擁有者在憑證的「權限」分頁加上這個工作流。」選的粉專或帳號已經被移除連結,或屬於別的專案又沒有開放給這個工作流時,寫著「找不到這個粉絲專頁。它可能已經被移除連結了。」或「找不到這個 Instagram 帳號。它可能已經被移除連結了。」
    • 「Instagram」的「操作」有「建立容器」、「查容器狀態」與「發佈」三個步驟。建立容器之後,Meta 要一點時間準備,所以請在「建立容器」和「發佈」之間,放一個「等待」節點。
    • 用它們發文,就是真的在 Facebook 或 Instagram 上發出去。

另外兩件事:

  • 不會重試的節點:目前是「AI Agent」、「SSE Agent」、「生成圖片」、「Facebook Graph API」與「Instagram」。不管「失敗時重試」怎麼設,它們失敗時都不會自動再試一次,請看節點設定分頁。「資料表」與「傳送訊息」現在還不能執行,它們執行時的失敗也只算一次,不會重試。
  • 在網站外面做事、做了就收不回來的節點,例如「Facebook Graph API」、「Instagram」,以及用 POST 或 DELETE 這類方法的「HTTP 請求」。按「執行」試跑時,它們也一樣會真的做,請看試跑與正式啟用。「AI Agent」與「SSE Agent」也可能透過它們的工具,寫入真的資料。「傳送訊息」也屬於這一類,但它現在還不能執行。

轉換

  • 「限制筆數 (Limit)」:只留下「保留筆數 (Max Items to Keep)」這麼多筆項目,其他的丟掉。「保留哪些 (Keep)」可以選「開頭幾筆 (First Items)」、「結尾幾筆 (Last Items)」或「隨機幾筆 (Random Items)」。
  • 「排序 (Sort)」:把項目排出順序。「排序方式 (Type)」可以選「依欄位 (Simple)」、「隨機 (Random)」或「程式碼 (Code)」。依欄位排時,可以加好幾個「排序欄位 (Fields To Sort By)」,每一個的「順序 (Order)」是「由小到大 (Ascending)」或「由大到小 (Descending)」。比較文字時,不分大小寫。
  • 「拆分列表 (Split Out)」:把項目裡的一個列表拆開,列表裡的每一個,各變成一筆項目。在「要拆分的欄位 (Fields To Split Out)」填那個列表的欄位。「其他欄位 (Include)」可以選「都不帶 (No Other Fields)」、「全部帶著 (All Other Fields)」或「只帶指定的 (Selected Other Fields)」。
  • 「彙整 (Aggregate)」:把好幾筆項目收成一筆。「彙整方式 (Aggregate)」可以選「逐個欄位 (Individual Fields)」或「整筆項目 (All Item Data)」。
  • 「摘要統計 (Summarize)」:把項目算成統計結果,可以用「分組欄位 (Fields To Split By)」分組,像試算表的樞紐分析。每一個「統計項目 (Fields To Summarize)」的「統計方式 (Aggregation)」可以選「收成列表 (Append)」、「平均 (Average)」、「接成文字 (Concatenate)」、「筆數 (Count)」、「不重複筆數 (Count Unique)」、「最大 (Max)」、「最小 (Min)」或「合計 (Sum)」。
  • 「移除重複 (Remove Duplicates)」:把重複的項目挑出來。留下的項目從第一條線「保留 (Kept)」送出,丟掉的從第二條線「捨棄 (Discarded)」送出。
    • 「比對方式 (Operation)」可以選「和眼前這批項目比 (Remove Items Repeated Within Current Input)」、「和先前執行過的比 (Remove Items Processed in Previous Executions)」或「清除先前的紀錄 (Clear Deduplication History)」。
    • 選「和先前執行過的比 (Remove Items Processed in Previous Executions)」,而且「判斷方式 (Keep Items Where)」是「這個值沒出現過 (Value Is New)」時,它會記住看過的值,最多記「最多記幾筆 (History Size)」這麼多個。超過時,這個節點會失敗,訊息會說超過了上限。

便利貼與未知節點

這兩種都不在「新增節點」裡。

  • 便利貼是寫在畫布上的說明,從右鍵選單的「加上便利貼」加上,請看畫布。
  • 未知節點:匯入或貼上的工作流裡,有本系統沒有的節點類型時,那個節點會變成未知節點,卡片上有一個警告的記號。它的設定會原封不動留著,但執行到它時一定會失敗,訊息是「找不到節點類型「…」。這個工作流可能是從 n8n 匯入的,請先把該節點換掉。 […]」請把它換成本系統有的節點,請看匯入。

節點設定視窗

在節點卡片上按兩下、在右鍵選單選「開啟設定」,或剛加上一個節點時,都會打開這個節點的設定視窗。視窗的標題是節點的名稱。

  • 視窗分成三個窗格:「輸入資料」、「節點」與「輸出資料」。觸發節點沒有「輸入資料」。
  • 在寬的螢幕上,可以拖窗格之間的分隔線來改寬度,按兩下分隔線就會還原。改好的寬度會記住。
  • 「節點」窗格有兩個分頁:「欄位」與「節點設定」。
  • 最下面的按鈕:
    • 「取消」:丟掉這次的變更。
    • 「儲存」:把變更放到畫布上,然後關掉視窗。
    • 「儲存並執行」:先把整個工作流存起來,再只執行這一個節點。跑的時候,按鈕寫著「執行中…」。
  • 還有沒放到畫布上的變更時,按鈕旁邊會寫著「有尚未套用的修改」。
  • 按 Esc 或 × 會關掉視窗,你的變更會留在畫布上。點視窗外面,不會關掉。
  • 視窗的「儲存」不會把工作流存起來。 變更只是放到了畫布上,還要按上方列的「儲存」,請看儲存。
  • 只能檢視的人,看得到欄位但不能改,「儲存並執行」也不能按。

「儲存並執行」給這個節點的資料,照這個順序找:前面節點釘選的資料;沒有的話,前面節點在最近一次跑完的整個執行裡送出的資料;都沒有時,就用一筆空的項目來跑。請看試跑與正式啟用。

節點設定分頁

「節點設定」分頁的欄位,從上到下:

  • 「節點名稱」:它的說明寫著「重新命名會一併更新連線與釘選資料,但其他節點裡的 $("舊名稱") 運算式不會跟著改。」
  • 「備註」。
  • 「執行開關」裡的「停用這個節點」:停用的節點不會執行,進來的項目會原樣交給下一個節點。
    • 觸發節點也可以停用,但之後每一次從它開始的執行都會失敗,訊息是「觸發節點「…」已經停用,無法從它開始執行。」
    • 停用的「排程觸發」,時間到了還是會啟動,然後以失敗結束,留下一筆失敗的執行。要讓一個觸發節點不再啟動,請刪掉它,再按「儲存」。
    • 把整個工作流切到「未啟用」,只會停下「排程觸發」、「Webhook」與「Agent 對話」,請看一個工作流,很多觸發。
  • 「錯誤重試」裡的「失敗時重試」:打開後會出現兩個框,「總嘗試次數」與「重試間隔」。兩個框的名稱後面,括號裡寫著最多可以填多少;「重試間隔」以毫秒計。不會重試的節點,不管這裡怎麼設,都不會重試。
  • 「執行次數上限」(觸發節點沒有這一格):名稱後面寫著可以填的範圍。它的說明寫著「留空表示不限,這個節點就只受專案的上限管。填了數字,就是這個節點在一次執行中最多跑幾次。專案的上限一樣有效,所以填得比專案大不會有作用。」請看執行上限。
  • 「這個節點失敗時」:預設是「停止工作流」,也可以選「繼續(一般輸出)」。選「繼續(一般輸出)」時,進到這個節點的項目,會從它的第一條出口繼續往下送,每一筆多一個 error 欄位,寫著失敗的原因;沒有項目進來時,會送出一筆只有 error 的項目。

資料面板

「輸入資料」與「輸出資料」兩個窗格,都用下面的方法看資料。

  • 窗格上方有「結構」、「表格」與「JSON」,可以換著看。你最後按的那一個,會在整個網站的同一種窗格裡記住;還沒按過時,設定視窗打開的是「結構」。
  • 放大鏡按鈕(游標指著時顯示「搜尋這些資料」)會打開一個搜尋框「搜尋欄位或內容…」。搜尋藏起了一些項目時,窗格會寫著「顯示 … / … 筆。」;一筆都找不到時,寫著「找不到符合「…」的項目。」
  • 「JSON」裡有一個複製按鈕(游標指著時顯示「複製全部 JSON」)。就算正在搜尋,它也會複製全部的內容。
  • 在「結構」裡,一個節點送出不只一筆項目時,可以用「顯示第幾筆資料」選要看哪一筆的值。

「輸入資料」窗格

  • 在「表格」和「JSON」裡,上方可以選要看前面哪一個節點的資料;那個節點跑過不只一次時,還可以選第幾次。
  • 在「結構」裡,它列出這個節點前面的每一個節點,最後還有「內建變數」這一塊,寫著「執行時才有的資料」。
  • 前面沒有接任何節點時,「結構」裡只有「內建變數」這一塊。
  • 它顯示的資料,照這個順序找:前面節點釘選的資料;沒有的話,前面節點在最近一次跑完的整個執行裡送出的資料;都沒有時,就是空的。

「輸出資料」窗格

  • 有好幾條出口時,每一條出口一個分頁,寫著名稱和筆數,例如「true (… 筆)」。
  • 這個節點跑過不只一次、而且沒有釘選時,可以選第幾次執行的資料,寫著「第 … 次 / 共 … 次」。旁邊可能有一個連結按鈕:一開始兩個窗格的次數會一起切換,游標指著時顯示「輸入與輸出會一起切換執行次數」;按下去之後,就各自切換,游標指著時改顯示「輸入與輸出各自切換執行次數」。
  • 存好的節點,在最近一次跑完的整個執行裡沒有資料時,寫著「這個節點還沒有跑出資料。先跑一次整個工作流,或按「儲存並執行」。」還沒存的節點(例如剛加上去的),在存檔之前會寫著「這個節點還沒有執行過,沒有輸出資料。」
  • 只能檢視這個工作流的人,在這個視窗裡看不到執行的資料。
  • 一個節點的資料太大時,執行面板的「輸入資料」和「輸出資料」會寫著「資料太多,只儲存了前面一部分項目。」沒有存下來的項目,在這次執行接下來的節點裡也拿不到了。
  • 圖釘按鈕與鉛筆按鈕,請看釘選資料。