HTTP

HTTP 節點：對話流程的擴充接口

在使用 HTTP 節點之前，我們需要先在外部的「資源管理」和「變數管理」介面完成基礎配置。這就像是先準備好食材（變數）和食譜（資源），才能開始烹飪（在流程中調用）。

項目	功能說明
變數管理	在對話流程中，變數用於管理和暫存資料。它們可以是用來傳遞給 API 的參數，也可以是用來接收 API 回傳的結果。
資源管理	負責定義與外部 API 的連接方式。透過資源節點，您可以實現查詢數據、修改狀態、存取外部資料庫等業務邏輯，極大化擴展對話系統的能力。

設定變數時，有幾個關鍵欄位：

名稱： 變數的唯一識別碼，建議使用英文命名（例如 user_id, order_price）。
數據類型： 系統支援多種數據類型，請根據需求正確選擇：
- 字串 (string)：文字資訊。
- 數字 (number)：數值運算用。
- 日期時間 (datetime)：時間戳記。
- 布林 (bool)：真假值 (True/False)。
- 物件 (object)：複雜的結構化數據 (JSON)。
- 陣列 (array)：多個數值的集合。
描述： 備註該變數的用途，方便團隊協作。
別名： 可選屬性。為變數取一個易讀的中文名稱（例如將 price 取名為「價格」），在設計流程時會更直觀。

在資源管理中，您需要定義 API 的具體調用方式：

資源名稱： 使用英文命名。
請求地址 (URL)： 完整的 API URL，務必包含 https 協定。
請求型態 (Method)： 支援 GET, POST, PATCH, PUT, DELETE。
Content-Type： 指定內容類型。常用的有 URL 編碼或 JSON 格式 (application/json)。
請求頭欄位 (Headers)：
- 可選擇 constant（常數）：固定不變的 Header，如 API Key。
- 可選擇 user（使用者參數）：目前僅支援閒聊對話，表單問答暫不支援。
參數 (Parameters)： 根據 Content-Type 填寫要傳送的參數。這些參數將在流程執行時被注入。
回傳值 (Response)： 定義如何處理 API 回傳的資料。您可以指定 JSON 路徑 (JSON Path)，將提取出的值注入到指定的「變數」中。

假設有一個參數 city 代表城市：

若 Content-Type 為 URL (application/x-www-form-urlencoded)： 系統會以 &city=urlEncode(城市) 的方式串接在 URL 後面傳遞。
若 Content-Type 為 JSON (application/json)： 系統會以 {"city": "城市"} 的 JSON 格式放在 Body 中傳遞。

假設 API 回傳的 JSON 如下：

{
  "city": "Taipei",
  "obj": {
    "apple": "蘋果"
  },
  "order": ["訂單A", "訂單B"]
}

若您想提取資料注入變數：

設定好 JSON 路徑後，在「鍵」的欄位選擇對應的變數（例如變數 my_city），系統就會自動將提取出的值存入該變數，供後續流程使用。