詞彙表¶

本詞彙表定義 Headquarter.ai 文件中使用的關鍵術語和概念。各詞條以中文為主，技術詞於括號內附原文英文以便對照。

核心概念¶

工作流程 (Workflow)¶

由連接的任務 (Action) 組成的有向圖，定義一個自動化流程。工作流程接受輸入，透過一系列任務處理，並產生輸出。每個工作流程都有一個起始 (Start) 節點（進入點）和一個結束 (End) 節點（離開點）。

任務 (Action)¶

工作流程中的單一工作單元。任務執行特定操作，例如呼叫 LLM、查詢資料庫或轉換資料。每個任務都有設定選項，並透過下一個狀態 (Next State) 連接到其他任務。

狀態 (State)¶

在執行期間流經工作流程的資料上下文。每個任務都可以讀取和寫入狀態。狀態資料可透過 JSONPath 運算式存取（例如 $.fieldName）。

資源 (Resource)¶

外部服務或功能的可重用設定。資源只需定義一次，可在多個工作流程中使用。例如 LLM 連線、資料庫連結器 (Connector) 和檢索器 (Retriever)。

工作流程元件¶

起始節點 (Start)¶

工作流程的進入點。定義輸入結構 (Input Schema)——工作流程被呼叫時接受的資料結構。

結束節點 (End)¶

工作流程的離開點。定義輸出結構 (Output Schema)——工作流程完成時回傳的資料結構。

輸入結構 (Input Schema)¶

定義工作流程或任務接受的輸入欄位和資料類型。結構支援 String、Number、Boolean、Array 和 Object 等類型。

輸出結構 (Output Schema)¶

定義工作流程或任務回傳的輸出欄位和資料類型。用於過濾和結構化最終結果。

下一個狀態 (Next State)¶

決定當前任務完成後執行哪個任務的設定，畫面上顯示為「下一個狀態」。可以指向單一任務或多個任務（用於平行執行）。

執行設定 (Execution Settings)¶

節點設定面板「設定」分頁中的一個可展開區塊（與「進階任務設定」並列），不是頂部分頁。實際包含「上傳輸出至外部記憶體」、「在任務開始階段開啟即時輸出串流」、「在任務結束階段開啟即時輸出串流」（兩個分開的勾選框）、「錯誤時中止」等選項，不含逾時欄位，也不含重試設定（重試在「錯誤處理」分頁，見重試）。

資料處理¶

JSONPath¶

用於瀏覽 JSON 資料結構的查詢語言。在 Headquarter.ai 中用於引用工作流程狀態中的值。語法：$.path.to.field。

常見模式：

• $.question - 存取頂層欄位
• $.action_name.result - 存取任務的輸出
• $.items[0] - 存取陣列的第一個元素
• $.user.profile.name - 存取巢狀欄位

外部記憶體 (External Memory)¶

處理超過正常狀態限制的大型資料的機制。資料儲存在外部並透過 URI 引用。適用於處理大型文件或 API 回應。

狀態記憶體輸出選擇器 (State Memory Output Selector)¶

指定任務輸出中應保留在工作流程狀態中哪些欄位的設定，有助於管理狀態大小並減少資料傳輸（最佳實踐頁中亦簡稱為「輸出選擇器 (Output Selector)」）。它對應工作流程定義 JSON 中的 state_memory_output_selector 欄位；目前節點設定面板沒有一個字面叫此名稱的欄位，主要透過工作流程定義來指定。

任務類型¶

LLM 任務 (LLM Action)¶

呼叫大型語言模型，根據設定的訊息（提示詞）產生文字。支援 system、user 和 assistant 訊息角色。

結構化 LLM 任務 (Structured LLM Action)¶

回傳符合定義的輸出結構 (Output Schema) 的結構化資料的 LLM 任務。使用 JSON 模式或 function calling 確保一致的輸出格式。

Lambda 任務 (Lambda Action)¶

在工作流程中執行自訂 Python 程式碼。用於資料轉換、條件邏輯和自訂處理。

檢索器任務 (Retriever Action)¶

根據搜尋查詢在知識庫中尋找相關文件。回傳排序後的文件區塊，用於 RAG 工作流程。

MCP 任務 (MCP Action)¶

呼叫 MCP（Model Context Protocol）伺服器公開的工具。實現與外部工具和服務的整合。

傳遞任務 (Pass Action)¶

不修改狀態直接傳遞的控制流任務。適用於彙整平行分支或明確路由。

資源類型¶

大型語言模型資源 (LLM Resource)¶

連接大型語言模型供應商的設定。包括供應商選擇、模型名稱、API 憑證和預設參數。

連結器資源 (Connector Resource)¶

連接外部資料來源（如資料庫 MySQL、OpenSearch）或 API 的設定。儲存連線字串和驗證資訊。

檢索器資源 (Retriever Resource)¶

文件檢索的設定，包括搜尋策略、嵌入模型 (Embedding Model) 和連接的知識庫。

知識庫資源 (Knowledge Base Resource)¶

可使用檢索器搜尋的索引文件集合。支援各種文件格式和分塊策略。

嵌入模型資源 (Embedding Model Resource)¶

將文字轉換為向量嵌入的模型設定。由檢索器用於語意搜尋。

MCP 伺服器資源 (MCP Server Resource)¶

連接提供外部工具和功能的 MCP 伺服器的設定。

樣板資源 (Template Resource)¶

具有變數佔位符的可重用文字範本。用於標準化工作流程中的提示詞和訊息。

RAG（檢索增強生成）¶

RAG¶

一種透過先從知識庫檢索相關資訊，然後將該資訊作為 LLM 上下文來增強 LLM 回應的技術。

檢索 (Retrieval)¶

根據查詢從知識庫尋找並回傳相關文件的過程。

接地 (Grounding)¶

確保 LLM 回應基於檢索到的事實資訊而非生成的知識的做法。

文件 (Document)¶

在知識庫中索引的內容片段。文件通常被分割成較小的區塊 (Chunk) 以實現更精確的檢索。

區塊 (Chunk)¶

文件的片段，通常是幾個段落或一個章節。區塊是檢索操作回傳的單位。

排序器 (Ranker)¶

根據與查詢的相關性重新排序檢索到的文件的元件。透過優先顯示最相關的結果來提高檢索品質。

執行¶

工作流程執行 (Workflow Execution)¶

使用特定輸入的單次工作流程執行。每次執行都有唯一的 ID 並追蹤狀態、時間和結果。

同步執行 (Synchronous Execution)¶

等待完成後才回傳的工作流程呼叫。呼叫者會阻塞直到結果可用。

非同步執行 (Asynchronous Execution)¶

立即回傳執行 ID 的工作流程呼叫。結果可以稍後使用查看工作流程執行 (Describe Workflow Execution) 檢索。

執行狀態 (Execution Status)¶

工作流程執行的當前狀態。平台介面上的「狀態」值以中文顯示，對照如下：

• 執行中（RUNNING）- 執行中
• 成功（SUCCEEDED）- 成功完成
• 失敗（FAILED）- 執行失敗
• 逾時（TIMED_OUT）- 超過時間限制

重試 (Retry)¶

失敗任務的自動重新執行。設定位置在節點設定面板的「錯誤處理」分頁 →「重試」→「新增重試器」（不在「執行設定」），包括重試次數（Max Retry Count）、間隔（Retry Interval）和退避率（Backoff Rate）選項。

逾時 (Timeout)¶

任務或工作流程完成的最大允許時間。超過此限制會導致 TIMED_OUT 狀態。

整合¶

MCP（Model Context Protocol）¶

將 AI 模型連接到外部工具、資料來源和服務的協定。提供工具發現和執行的標準化介面。

工具 (Tool)¶

MCP 伺服器公開的功能，可從工作流程呼叫。工具有定義的輸入和輸出。

API¶

應用程式介面。在 Headquarter.ai 中，通常指透過 HTTPS API 任務呼叫的外部 HTTP 服務。

Webhook¶

由外部事件觸發的 HTTP 回呼。可用於從外部系統啟動工作流程執行。

UI 術語¶

畫布 (Canvas)¶

透過放置和連接任務節點來設計工作流程的視覺化編輯器，畫面上稱為「畫布」。

設定面板 (Configuration Panel)¶

選取節點時自右側出現的面板，顯示該任務的所有可設定選項（內部無障礙名稱為 Workflow State Form）。面板上方有「設定／輸入與輸出／錯誤處理」三個分頁。（「執行設定」不是分頁，而是「設定」分頁裡的一個可展開區塊，見執行設定。）

測試任務 (Test Action)¶

允許單獨測試單一任務而無需執行整個工作流程的功能。位於設定面板右上角，此按鈕在平台上維持英文「Test Action」顯示。

執行應用程式 (Run Application)¶

手動執行工作流程並使用自訂輸入、查看結果的功能。它不是一個獨立介面，而是工作流程「動作」選單中的項目／詳細頁上的按鈕，畫面上顯示為中文「執行應用程式」（點擊後會在新分頁開啟執行畫面）。

動作（Actions 選單）¶

工作流程編輯器右上角的選單按鈕，顯示為「動作」。展開後包含「更新」「執行應用程式」「下載定義」「設定排程」等項目（請勿與工作流程中的工作單元任務 (Action) 混淆）。

更新 / 草稿已儲存¶

「更新」是「動作」選單中的項目，把目前編輯內容正式儲存生效。編輯過程中畫面會自動顯示「草稿已儲存」，但那只是暫存草稿，與正式「更新」是兩件不同的事。

錯誤處理 (Error Handling)¶

節點設定面板中的分頁，內含「重試」（Retry）與「捕捉」（Catch）兩種錯誤處理機制。重試與其欄位（Max Retry Count 等）即在此分頁設定。

捕捉 (Catch)¶

「錯誤處理」分頁中的機制，用來在某個任務失敗時，把流程導向另一條處理路徑（例如改走備援步驟），而非讓整個工作流程直接失敗。

InputPath / ResultSelector / ResultPath / OutputPath¶

節點設定面板「輸入與輸出」分頁中，控制資料在該步驟進出方式的四個欄位：

• InputPath：挑選傳進這個任務的輸入資料範圍。
• ResultSelector：從這個任務的原始結果中，挑選／重組要保留的欄位。
• ResultPath：決定把結果寫回狀態的哪個位置（例如 $.LLMActionResult）。注意：改任務名稱後 ResultPath 不會自動更新，需手動調整。
• OutputPath：挑選最後要往下一步傳出的資料範圍。

多數情境用預設即可，新手通常不需修改。

附註 (Note)¶

節點設定中的純文字多行輸入欄位，用來替該步驟寫備忘說明（外觀看似程式碼框，但只是純文字，可忽略行號）。

進階任務設定¶

設定面板中可展開的進階區塊，收納較少用到的選項（例如 LLM 的 Guardrail 版本等），新手通常維持預設即可。

依賴資源 / 被依賴資源¶

「依賴資源」指這個項目用到的其他資源；「被依賴資源」指有哪些其他項目反過來用到它。用於了解修改或刪除某資源時的影響範圍。