跳到主要內容 跳至補充內容

範例 2:「OpenAI 完成 API (GPT-3) - JSON 表格」設定

此範例教導您如何透過「OpenAI 完成 API (GPT-3) - JSON 表格」設定使用 OpenAI 分析連接器。這會透過如何在資料模型中納入功能的基本練習引導您。

您也可以使用 Azure OpenAI 連接器完成此範例。使用該連接器時,您會透過 Microsoft Azure 平台與模型互動,而非透過 OpenAI 平台。

開始之前

您需要先完成下列步驟,才能完成此範例。

  • 建立 OpenAI 平台帳戶

  • 取得 OpenAI API 金鑰

  • 啟用分析連線功能於 Qlik Cloud

  • 以適用的連接器設定建立連線

在載入指令碼中使用 OpenAI 連接器

建立新的 Qlik Sense 應用程式,您將會對此新增載入指令碼,以與 OpenAI 平台通訊。將可在應用程式的資料模型中存取您透過此指令碼載入的表格。

資訊備註若您用來完成此區段的應用程式與範例 1 的載入指令碼區段相同,必須先取消註解或刪除範例 1 中的指令碼,再載入以下指令碼。若您沒有這麼做,資料模型將會有問題,您甚至可能會在載入資料時遇到錯誤。

按照以下步驟。如需其他詳細資訊,請參閱 從 OpenAI 連線中選取和載入資料

建立要傳送至 OpenAI 的資料表格

第一步是建立表格,其中包含您正傳送至 OpenAI 的請求。請求中的資料列稱為「完成」。表格的單一欄位 (欄) 中必須包含每個項目的文字作為列。此欄的每列呈現要透過 OpenAI API 完成的文字。

對於關聯欄位可以有附加的次要欄位,但這需要符合設定中指定的欄位名稱。此為特殊欄位,不會傳送至 OpenAI,但附加至回應,以用於產生 Qlik 資料模型。

在應用程式中,開啟資料載入編輯器並在新的指令碼區段中貼上下列代碼:

SourceTable2:
NoConcatenate
LOAD
RowNo() as RowId,
Text
Inline
[Text
top 5 countries by population extract as JSON list];				

 

此表格包含稱為 Text 的欄位,這包含我們向 OpenAI 詢問的單一問題。RowId 欄位是關聯欄位,這將用於下一步,以將回應連結至應用程式的資料模型。

建立 OpenAI LOAD 陳述式

下一步是建立另一個載入陳述式,以與 OpenAI 通訊。您透過此陳述式載入的表格指向您正用來傳送請求資料的表格和欄位名稱。簡言之,正在透過指令碼載入第二表格,以向請求提供 OpenAI 的回應。

若要產生此指令碼部分,您可以為正在使用的連線使用選取資料精靈。這會產生包括您提供之屬性名稱的範本指令碼。或者,您可以在指令碼編輯器中手動新增此表格,而不使用精靈。

在資料載入編輯器的資料來源面板中找到您正在使用的連線,並按一下 選取資料。這會開啟選取資料精靈

資料載入編輯器中用於分析連線的選取資料按鈕

資料載入編輯器的「新增資料」索引標籤,具有醒目提示「選取資料」的圖示

使用選取資料精靈時,您需要提供兩個屬性:

  • 駐留表格的名稱。此表格具有正傳送至 OpenAI 的問題。在此案例中,這是 SourceTable2

  • 資料欄位的名稱。此欄位包含正傳送至 OpenAI 的問題。在此案例中,這是 Text

表格之下,對稱為 openai 的表格按一下核取方塊。

資料載入編輯器中的選取資料精靈

資料載入編輯器的「新增資料」索引標籤,具有醒目提示「選取資料」的圖示

按一下插入指令碼時,新的表格會新增至載入指令碼。

現在新增了 OpenAI LOAD 陳述式後,載入指令碼看起來應如下所示:

SourceTable2: NoConcatenate LOAD RowNo() as RowId, Text Inline [Text top 5 countries by population extract as JSON list ]; [openai]: LOAD * EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"OpenAI Connection for JSON Tables Completions (GPT-3)"}}', SourceTable2{RowId,Text});

 

資訊備註為了讓此確切程式碼在應用程式中順暢運作,也必須使用與以上載入指令碼中指定的 connectionname 相同的名稱值設定 OpenAI 連線。關於用於本教學課程的值,請參閱 建立連線

您現在已準備好執行載人指令碼。

將資料載入到應用程式中

指令碼完成後,按一下載入資料。這執行與 OpenAI 的通訊並在應用程式的資料模型中插入表格。

資訊備註若您在載入指令碼時收到錯誤,可能是連線設定和載入指令碼中選用的次要關聯欄位之間有不相符的情況。若您已在連線設定中定義關聯欄位,確保這也包括在請求指令碼中。

開啟資料模型檢視器並注意兩個表格如預期連結在一起。在預覽窗格中,OpenAI 對請求項目的回應包括在第二表格中。

從 OpenAI 連線建立的資料模型

資料模型檢視器顯示產生的資料模型,這包含兩個表格。

您現在可以使用已載入到應用程式中的資料產生分析內容。您不需要參考您使用此資料建立的任何圖表中的 OpenAI 連線。

此頁面是否對您有幫助?

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們可以如何改善!