REFERENCE
開發者參考
認證、API、SDK、Flow Agent 處理節點與參數取值的完整參考。
Generate Embedding
把文字轉成向量,通常接在寫進知識庫之前。
Generate Embedding 是用於將文字內容轉換為向量表示的 processor。
基本用法
執行 Generate Embedding 時,會使用指定的 Embedding Model 將輸入文字轉換為數值向量,這些向量可用於語意搜尋、相似度計算、文件分類等需要向量化處理的場景。生成的向量會以浮點數陣列形式儲存到指定變數中供後續 processor 使用。
配置參數
節點的屬性面板:
Name
顯示在畫布上的名稱,用於在工作流程中識別此 processor。
Description
用於補充此 processor 的用途,提升工作流程的可讀性。
Properties
Embedding Model(必填)
選擇要使用的 Embedding Model 資源名稱。需要先建立 Embedding Model 資源,支援各種預訓練的 Embedding 模型,如 OpenAI text-embedding 系列等。
Input(必填)
要轉換為向量的輸入內容。支援 Literal、Expression、Template 等設定類型,詳細說明請參考:Expression 介紹 - 取值方式。
Result Field(必填)
向量化結果要儲存的變數名稱,查詢結果(浮點數陣列)會儲存到此變數名稱對應的 context payload 欄位中。
在 Workflow CRD 中的設定
- name: proc-embed
type: generate-embedding
labels:
display_name: 向量化使用者提問
configs:
- name: embeddingModel
value: em-builtin
- name: input
expression: prevMessage
- name: resultField
value: resultresultField的預設值是result,其餘兩個沒有預設值,必須自行填入。一個實際的例子
把使用者輸入轉成向量,接著拿去查知識庫。
欄位 值 Embedding Model 專案裡設定好的 Embedding Model Input Expression: prevMessageResultField query_vector執行後
query_vector是一個數字陣列(Array[Number])。變數名稱由 ResultField 決定,預設是result。注意事項
- 不同的 Embedding Model 產生的向量維度不同,換模型之後舊向量不能拿來跟新向量比對。
- 向量只有跟同一個模型產生的向量比較才有意義。
- 模型有輸入長度上限,長文要自己先切段。