建立 Hugging Face 連線
若要與 Hugging Face 通訊,建立連線至 Hugging Face 分析來源。在 分析 活動中心、資料載入編輯器 或 指令碼 的「建立」頁面建立連線。
從這些連線接收的資料可用於載入指令碼,可用於圖表運算式,以提升 Qlik Sense 分析應用程式。
設定和可進行的設定
以下列其中一個設定來設定 Hugging Face 分析連線。每個連線可以包括單一設定。
Hugging Face 連接器的每個可用設定對應至您想藉由可透過 Hugging Face 平台使用之模型執行的常見任務。有數千個模型可用來協助處理每個任務。
並非所有 Hugging Face 模型都可用於 Qlik Hugging Face 連接器。用於 Qlik Sense 的模型可用性部分取決於外部因素。其他模型特定限制和要求可能適用,影響您如何設定連接器和交換資料。如需任何特定模型的完整詳細資訊,請參閱官方 Hugging Face 文件。
Feature Extraction
使用此設定來處理執行特徵擷取任務的模型。一般而言,特徵擷取是具有許多實際應用的技術機器學習流程。藉由此任務,輸入資料會轉換為數字特徵。
請參閱下列 Hugging Face 資源以取得更多資訊:
-
特徵擷取任務的概述:Feature Extraction
欄位 | 描述 |
---|---|
Configuration | 選取連接器設定。對於用於特徵擷取任務的模型,選取 Feature Extraction。 |
Hugging Face Inference API endpoint | 輸入 Qlik Sense 用來存取模型的端點 URL。這通常透過 Hugging Face Inference API 進行。 |
Hugging Face API Token | 輸入您在建立帳戶後產生的 Hugging Face API Token。這會驗證帳戶認證,讓您可以使用外部服務。請參閱 產生 API Token。 |
Use Cache |
依照預設,這設定為 True。若進行兩次相同請求,選取是否要使用快取,以重複使用模型回應。根據模型,您可能會想要關閉此設定。 |
Wait For Model |
依照預設,這設定為 False。若開啟此項,您可以先等待模型準備好再做出請求,以減少對 API 進行的請求數量。 |
Association Field |
指定關聯欄位,即輸入資料表格中包含唯一識別碼的欄位。此為選用參數。 在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時,需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回,並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位,可以來自來源資料,也可以作為表格載入過程的一部分。 |
Name | 連線的名稱。如果沒有輸入名稱,則使用預設名稱。 |
Question Answering
使用此設定來處理執行問題回答任務的模型。透過問題回答,模型可根據獨立提供的內容區段,用來擷取對問題的回答。在 Qlik Sense 中,問題和內容都會在應用程式或指令碼資料中提供。
請參閱下列 Hugging Face 資源以取得更多資訊:
-
問題回答任務概述:Question Answering
欄位 | 描述 |
---|---|
Configuration | 選取連接器設定。對於用於問題回答任務的模型,選取 Question Answering。 |
Hugging Face Inference API endpoint | 輸入 Qlik Sense 用來存取模型的端點 URL。這通常透過 Hugging Face Inference API 進行。 |
Hugging Face API Token | 輸入您在建立帳戶後產生的 Hugging Face API Token。這會驗證帳戶認證,讓您可以使用外部服務。請參閱 產生 API Token。 |
Use Cache |
依照預設,這設定為 True。若進行兩次相同請求,選取是否要使用快取,以重複使用模型回應。根據模型,您可能會想要關閉此設定。 |
Wait For Model |
依照預設,這設定為 False。若開啟此項,您可以先等待模型準備好再做出請求,以減少對 API 進行的請求數量。 |
Association Field |
指定關聯欄位,即輸入資料表格中包含唯一識別碼的欄位。此為選用參數。 在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時,需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回,並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位,可以來自來源資料,也可以作為表格載入過程的一部分。 |
Name | 連線的名稱。如果沒有輸入名稱,則使用預設名稱。 |
Summarization
使用此設定來處理執行摘要任務的模型。模型取用特定輸入文字並對此文字輸出更簡短的摘要,保留重要詳細資訊,藉此執行摘要。
請參閱下列 Hugging Face 資源以取得更多資訊:
-
摘要任務概述:Summarization
欄位 | 描述 |
---|---|
Configuration | 選取連接器設定。對於用於摘要任務的模型,選取 Summarization。 |
Hugging Face Inference API endpoint | 輸入 Qlik Sense 用來存取模型的端點 URL。這通常透過 Hugging Face Inference API 進行。 |
Hugging Face API Token | 輸入您在建立帳戶後產生的 Hugging Face API Token。這會驗證帳戶認證,讓您可以使用外部服務。請參閱 產生 API Token。 |
Minimum Token Length | 設定整數值作為要用於模型輸出的最小 Token 數量。選用參數。若沒有指定任何值,輸出不會有任何最小長度。 |
Maximum Token Length | 設定整數值作為要用於模型輸出的最大 Token 數量。選用參數。若沒有指定任何值,輸出不會有任何最大長度。 |
Top K | 設定整數值作為要用於輸出的最可能 Token 的數量。選用參數。若沒有指定任何值,輸出不會有要用於輸出的最可能 Token 的最高數量。 |
Top P |
輸入數字 (特別是浮動點),就 Token 可能性控制輸出隨機性。 如需完整詳細資訊,請參閱 Hugging Face 文件。 選用參數。若沒有指定任何值,將不會根據您的選擇針對隨機性控制輸出。 |
Temperature | 指定浮動點值 (介於 0.00 和 100.0 之間),以控制輸出隨機性。較高的值通常產生更高的 Token 隨機性。預設值為 1.0。選用參數。 |
Repetition Penalty | 指定浮動點值 (介於 0.00 和 100.0 之間),以強化對重複 Token 的處罰。預設值為 1.0。選用參數。 |
Maximum Query Time | 為查詢所需的最大時間 (以秒為單位) 指定浮動點值 (介於 0 和 120.0 之間)。此為軟限制。選用參數。若沒有指定任何值,不會設定最大查詢時間。 |
Use Cache |
依照預設,這設定為 True。若進行兩次相同請求,選取是否要使用快取,以重複使用模型回應。根據模型,您可能會想要關閉此設定。 |
Wait For Model |
依照預設,這設定為 False。若開啟此項,您可以先等待模型準備好再做出請求,以減少對 API 進行的請求數量。 |
Association Field |
指定關聯欄位,即輸入資料表格中包含唯一識別碼的欄位。此為選用參數。 在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時,需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回,並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位,可以來自來源資料,也可以作為表格載入過程的一部分。 |
Name | 連線的名稱。如果沒有輸入名稱,則使用預設名稱。 |
Sentence Similarity
使用此設定來處理執行句子相似性分析的模型。在此任務類型中,模型會比較一個或多個相異句子與來源句子,產生儲存相似性相關資訊的內嵌。這些內嵌是數值。使用內嵌是進階機器學習流程。
在 Qlik Sense 中,會在連接器設定中提供來源句子,並在應用程式或指令碼資料中提供輸入句子 (模型會用來比較來源句子)。
請參閱下列 Hugging Face 資源以取得更多資訊:
-
句子相似性任務概述:Sentence Similarity
欄位 | 描述 |
---|---|
Configuration | 選取連接器設定。對於用於句子相似性分析相關任務的模型,選取 Sentence Similarity。 |
Hugging Face Inference API endpoint | 輸入 Qlik Sense 用來存取模型的端點 URL。這通常透過 Hugging Face Inference API 進行。 |
Hugging Face API Token | 輸入您在建立帳戶後產生的 Hugging Face API Token。這會驗證帳戶認證,讓您可以使用外部服務。請參閱 產生 API Token。 |
Source Sentence |
模型用來與每個輸入資料項目比較的文字字串,評估兩個字串之間的相似性。 |
Use Cache |
依照預設,這設定為 True。若進行兩次相同請求,選取是否要使用快取,以重複使用模型回應。根據模型,您可能會想要關閉此設定。 |
Wait For Model |
依照預設,這設定為 False。若開啟此項,您可以先等待模型準備好再做出請求,以減少對 API 進行的請求數量。 |
Association Field |
指定關聯欄位,即輸入資料表格中包含唯一識別碼的欄位。此為選用參數。 在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時,需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回,並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位,可以來自來源資料,也可以作為表格載入過程的一部分。 |
Name | 連線的名稱。如果沒有輸入名稱,則使用預設名稱。 |
Text Classification
使用此設定來處理執行文字分類任務的模型。文字分類是多功能任務類型,其中模型可以執行情緒分析、文法校正檢查,和其他語言處理動作。
請參閱下列 Hugging Face 資源以取得更多資訊:
-
文字分類任務概述:Text Classification
欄位 | 描述 |
---|---|
Configuration | 選取連接器設定。對於用於文字分類任務的模型,選取 Text Classification。 |
Hugging Face Inference API endpoint | 輸入 Qlik Sense 用來存取模型的端點 URL。這通常透過 Hugging Face Inference API 進行。 |
Hugging Face API Token | 輸入您在建立帳戶後產生的 Hugging Face API Token。這會驗證帳戶認證,讓您可以使用外部服務。請參閱 產生 API Token。 |
Use Cache |
依照預設,這設定為 True。若進行兩次相同請求,選取是否要使用快取,以重複使用模型回應。根據模型,您可能會想要關閉此設定。 |
Wait For Model |
依照預設,這設定為 False。若開啟此項,您可以先等待模型準備好再做出請求,以減少對 API 進行的請求數量。 |
Association Field |
指定關聯欄位,即輸入資料表格中包含唯一識別碼的欄位。此為選用參數。 在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時,需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回,並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位,可以來自來源資料,也可以作為表格載入過程的一部分。 |
Name | 連線的名稱。如果沒有輸入名稱,則使用預設名稱。 |
Text Generation
使用此設定來處理執行文字產生任務的模型。使用此任務類型的模型通常可以完成不完整的文字區段,或執行文字改述。
請參閱下列 Hugging Face 資源以取得更多資訊:
-
文字產生任務概述:Text Generation
欄位 | 描述 |
---|---|
Configuration | 選取連接器設定。對於用於文字產生任務的模型,選取 Text Generation。 |
Hugging Face Inference API endpoint | 輸入 Qlik Sense 用來存取模型的端點 URL。這通常透過 Hugging Face Inference API 進行。 |
Hugging Face API Token | 輸入您在建立帳戶後產生的 Hugging Face API Token。這會驗證帳戶認證,讓您可以使用外部服務。請參閱 產生 API Token。 |
Maximum Token Length | 設定整數值作為要用於模型輸出的最大 Token 數量。選用參數。若沒有指定任何值,輸出不會有任何最大長度。 |
Top K | 設定整數值作為要用於輸出的最可能 Token 的數量。選用參數。若沒有指定任何值,輸出不會有要用於輸出的最可能 Token 的最高數量。 |
Top P |
輸入數字 (特別是浮動點),就 Token 可能性控制輸出隨機性。 如需完整詳細資訊,請參閱 Hugging Face 文件。 選用參數。若沒有指定任何值,將不會根據您的選擇針對隨機性控制輸出。 |
Temperature | 指定浮動點值 (介於 0.00 和 100.0 之間),以控制輸出隨機性。較高的值通常產生更高的 Token 隨機性。預設值為 1.0。選用參數。 |
Repetition Penalty | 指定浮動點值 (介於 0.00 和 100.0 之間),以強化對重複 Token 的處罰。預設值為 1.0。選用參數。 |
Maximum Query Time | 為查詢所需的最大時間 (以秒為單位) 指定浮動點值 (介於 0 和 120.0 之間)。此為軟限制。選用參數。若沒有指定任何值,不會設定最大查詢時間。 |
Use Cache |
依照預設,這設定為 True。若進行兩次相同請求,選取是否要使用快取,以重複使用模型回應。根據模型,您可能會想要關閉此設定。 |
Wait For Model |
依照預設,這設定為 False。若開啟此項,您可以先等待模型準備好再做出請求,以減少對 API 進行的請求數量。 |
Association Field |
指定關聯欄位,即輸入資料表格中包含唯一識別碼的欄位。此為選用參數。 在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時,需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回,並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位,可以來自來源資料,也可以作為表格載入過程的一部分。 |
Name | 連線的名稱。如果沒有輸入名稱,則使用預設名稱。 |
Token Classification
使用此設定來處理執行 Token 分類任務的模型。透過 Token 分類,模型可以識別文字字串 (Token) 作為可分類的實體 (例如地點、人員和語音部分)。
請參閱下列 Hugging Face 資源以取得更多資訊:
-
Token 分類任務概述:Token Classification
欄位 | 描述 |
---|---|
Configuration | 選取連接器設定。對於用於 Token 分類任務的模型,選取 Token Classification。 |
Hugging Face Inference API endpoint | 輸入 Qlik Sense 用來存取模型的端點 URL。這通常透過 Hugging Face Inference API 進行。 |
Hugging Face API Token | 輸入您在建立帳戶後產生的 Hugging Face API Token。這會驗證帳戶認證,讓您可以使用外部服務。請參閱 產生 API Token。 |
Aggregation Strategy |
輸入中的實體分類可以進行彙總處理。此參數指定進行分類時套用的彙總策略類型。 從下列選項中選擇:
Simple 為預設選項。 |
Use Cache |
依照預設,這設定為 True。若進行兩次相同請求,選取是否要使用快取,以重複使用模型回應。根據模型,您可能會想要關閉此設定。 |
Wait For Model |
依照預設,這設定為 False。若開啟此項,您可以先等待模型準備好再做出請求,以減少對 API 進行的請求數量。 |
Association Field |
指定關聯欄位,即輸入資料表格中包含唯一識別碼的欄位。此為選用參數。 在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時,需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回,並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位,可以來自來源資料,也可以作為表格載入過程的一部分。 |
Name | 連線的名稱。如果沒有輸入名稱,則使用預設名稱。 |
Translation
使用此設定來處理執行翻譯任務的模型。模型可以將某種語言的輸入文字翻譯為另一種語言。
請參閱下列 Hugging Face 資源以取得更多資訊:
-
翻譯任務概述:Translation
欄位 | 描述 |
---|---|
Configuration | 選取連接器設定。對於用於翻譯任務的模型,選取 Translation。 |
Hugging Face Inference API endpoint | 輸入 Qlik Sense 用來存取模型的端點 URL。這通常透過 Hugging Face Inference API 進行。 |
Hugging Face API Token | 輸入您在建立帳戶後產生的 Hugging Face API Token。這會驗證帳戶認證,讓您可以使用外部服務。請參閱 產生 API Token。 |
Source Language |
輸入您請求翻譯的輸入文字的語言。選用參數。 資訊備註每個模型提供的語言翻譯功能各有不同。 例如,可以設計模型僅翻譯兩種特定語言之間的文字。在此情況下,讓此參數空白有其道理。
|
Target Language |
輸入您希望輸入文字翻譯成的語言。選用參數。 資訊備註每個模型提供的語言翻譯功能各有不同。 例如,可以設計模型僅翻譯兩種特定語言之間的文字。在此情況下,讓此參數空白有其道理。
|
Use Cache |
依照預設,這設定為 True。若進行兩次相同請求,選取是否要使用快取,以重複使用模型回應。根據模型,您可能會想要關閉此設定。 |
Wait For Model |
依照預設,這設定為 False。若開啟此項,您可以先等待模型準備好再做出請求,以減少對 API 進行的請求數量。 |
Association Field |
指定關聯欄位,即輸入資料表格中包含唯一識別碼的欄位。此為選用參數。 在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時,需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回,並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位,可以來自來源資料,也可以作為表格載入過程的一部分。 |
Name | 連線的名稱。如果沒有輸入名稱,則使用預設名稱。 |
建立新連線
您可以從 分析 活動中心、從現有應用程式中的 資料載入編輯器 或從現有指令碼中的 指令碼 建立連線至分析連接器。按照以下步驟建立連線。
請執行下列動作:
-
透過資料載入編輯器或 指令碼 存取連接器。
-
按一下建立新連線。
-
在空間之下,選取連線所在的空間。
-
從資料連接器清單中選取 Hugging Face。
-
填寫連線對話方塊欄位。
-
按一下建立。
資料連線儲存至建立應用程式的空間,因此可在其他 Qlik Sense 應用程式和指令碼中重複使用。這也會列於 資料載入編輯器 或 指令碼 中的資料連線之下。
建立連線後,您可以用來載入資料,連同請求和平台的回應。此外,您可以在圖表運算式中使用。如需更多資訊,請參閱 從 Hugging Face 連線中選取和載入資料 和 在視覺化運算式中使用 Hugging Face 連線。