定義
開始節點是每個工作流程中必需的預設起始節點。它作為建立及配置全域變數的第一個節點,提供必要的初始資訊,確保後續工作流程節點及整體應用程式流程能正常運作。
如何配置
開始節點的設定頁面包含兩個部分:自訂變數和預設系統變數。開始節點的預設配置在『服務式工作流程』與『對話式工作流程』之間有所不同。
自訂變數:
使用者可依需求預設自訂變數,供後續流程使用。服務式與對話式工作流程的配置方法相同。
舉例來說,在文案撰寫的情境下,使用者需預先提供特定格式(如主題、風格)的需求,這些預設資訊有助於生成更符合預期的文案。
添加自訂變數:
選擇開始節點,然後點擊自訂變數右側的「+」號來設定:

- 欄位類型(必填):選擇資料類型,例如字串、數字、布林值、物件等。
- 變數名稱(必填):輸入參數的自訂名稱。
- 描述(選填):提供描述以闡明參數的用途。
- 變數約束(選填):定義輸入規則,確保資料符合特定要求。這有助於防止無效或錯誤資料影響工作流程中後續節點的正常運作。有兩種類型的約束:
- 枚舉類型:變數值限於預設的可選值列表。使用者只能從這些預定義值中選擇,確保輸入內容的一致性和標準化。
- 規則類型:
- 最小/最大長度:限制變數值的字元長度以防止內容過短或過長。
- 正則表達式:使用正則表達式定義輸入格式——例如用於驗證電子郵件地址或手機號碼——確保內容符合預設模式。
- 預設值(選填):指定將顯示在輸入欄位中的預設值。
- 私有變數:您可以將變數設為私有。當工作流程被外部呼叫時,對私有(受保護)變數的存取將受到限制——這些變數不會公開或傳遞出去。
系統變數:
系統變數是在服務式與對話式工作流程中預設的系統級參數。這些變數可在整個應用程式中被其他節點讀取。它們通常用於進階開發情境,例如建構多輪對話應用程式、收集應用程式日誌檔,以及監控或記錄不同應用程式與使用者的使用行為。
服務式與對話式工作流程的預設系統變數有所不同。請參閱下表了解詳細信息:
服務式工作流程的系統變數:
變數名稱 | 變數類型 | 描述 |
---|---|---|
UTCDate | 字串 | 當前工作流程開始執行的日期,以UTC時間表示,格式為yyyy-MM-dd。 |
UTCTime | 字串 | 當前工作流程開始執行的時間,以UTC時間表示,格式為HH:mm:ss。 |
$WorkflowID | 字串 | 工作流程ID |
$BatchID | 字串 | 工作流程的執行批次ID。 |
對話式工作流程的系統變數:
變數名稱 | 變數類型 | 描述 |
---|---|---|
Date | 字串 | 當前工作流程開始執行的日期,以UTC時間表示,格式為yyyy-MM-dd。 |
Time | 字串 | 當前工作流程開始執行的時間,以UTC時間表示,格式為HH:mm:ss。 |
TimeOffset | 數字 | 使用者的瀏覽器時區,以距離UTC的分鐘偏移量表示(例如,UTC+8時為480)。若未收集,預設為0(UTC)。 |
BrowserLang | 字串 | 使用者的瀏覽器語言,格式如zh-CN或en-US。 |
Query | 字串 | 使用者輸入的問題或文字內容。 |
$SessionID | 字串 | 當前問答會話的ID。 |
$LastAnswer | 字串 | 用於儲存前一個對話的輸出。 |
$Round | 數字 | 在自動繼續對話中,目前的對話輪次。 |
$ChatHistory | 陣列[物件] | 對話紀錄,包含歷史對話中的問題、答案,以及問題與答案的權杖數量。 |
$WorkflowID | 字串 | 工作流程ID |
$BatchID | 字串 | 工作流程的執行批次ID。 |
注意事項
- 輸入參數名稱後,請確保選擇相應的欄位類型。
- 您輸入的自訂變數必須符合格式規範。若不符合格式規範,將無法輸入。
發佈評論