# 建立 Azure OpenAI 連線

若要與 Azure OpenAI 通訊，建立連線至 Azure OpenAI 分析來源。

從這些連線接收的資料可用於載入指令碼和圖表運算式，以提升您的 Qlik Sense 分析應用程式或指令碼。

## 開始之前

在 Microsoft Azure 帳戶內，Azure OpenAI 服務位於 Azure 的認知服務內，預設不會啟用。若您在啟用 Azure OpenAI 服務時需要協助，請聯絡 Microsoft。

## 可用的連接器設定

以下列其中一個設定來設定 Azure OpenAI 分析連線。

### OpenAI 完成 API

此設定將每列資料作為問題傳送至完成 API (使用小批次以改善效能)。每個回應將儲存為表格中的文字，列數與輸入相同。

此設定可以用於載入指令碼與圖表運算式。

### OpenAI 聊天完成 API

此設定將每列資料作為請求傳送至 OpenAI 聊天完成 API。在此情況下，會透過「使用者」訊息角色進行請求，並作為獨立的請求傳送來自 Qlik 的每列資料。

資訊備註不支援傳送多列作為聊天內容。您需要在單一請求列中納入所有問題。

此設定可以用於載入指令碼與圖表運算式。

## 建立連線

您可以從 分析 活動中心的建立頁面，或從您已建立之應用程式中的資料載入編輯器，建立連線至 Azure OpenAI 分析連接器。按照以下步驟建立連線。

如需關於如何設定參數值的資訊，請參閱 [Azure OpenAI 服務 REST API 參考](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)。

請執行下列動作：

1. 建立新的 Qlik Sense 應用程式或指令碼，並開啟 資料載入編輯器 或 指令碼。

2. 按一下建立新連線。

3. 在空間之下，選取連線所在的空間。

4. 在分析來源之下，按一下 Azure OpenAI。

5. 選擇所需的設定。如需更多關於每個可用選項的資訊，請參閱 [可用的連接器設定](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Availabl)。

6. 輸入 Azure OpenAI API 金鑰。

7. 輸入 Azure API 版本。已使用目前的預設填入此欄位。

8. 按需求調整任何其他預設參數值。

   如需其他參數描述，請參閱 [可進行的設定](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Configur)。

   資訊備註您幾乎永遠需要改變最大 Token 參數值才能連線，以根據您的需求正常運作。此參數控制將會產生的回應大小。

9. 按一下建立。

資料連線儲存至建立應用程式的空間，因此可在其他 Qlik Sense 應用程式或指令碼中重複使用。

建立連線後，您可以用來載入資料以傳送至 Azure OpenAI。此外，您可以在圖表運算式中使用。如需更多資訊，請參閱 [從 Azure OpenAI 連線中選取和載入資料](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-load.htm) 和 [在視覺化運算式中使用 Azure OpenAI 連線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-use.htm)。

## 可進行的設定

可以在連線對話方塊中進行下列表格中的設定。

可在連線對話方塊中進行的設定

| 欄位 | 描述 |
| --- | --- |
| 選取設定 | 在設定之下，選取連接器的設定。如需詳細資訊，請參閱[可用的連接器設定](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Availabl)。 |
| 授權 | 輸入 Azure OpenAI API 金鑰。如需更多資訊，請參閱 [Azure OpenAI 服務 REST API 參考](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)。 |
| Azure OpenAI 請求 | <ul> <li> <p><span>Azure 資源名稱</span>：您已在 <span>Microsoft Azure</span> 中設定的資源專案。</p> <p><span>Azure 部署名稱</span>：您已為所選 OpenAI 模型設定的特定部署。</p> </li> <li> <p><span>Azure API&nbsp;版本</span>：Azure 中的 API 版本。這預先填入目前的預設值。</p> </li> </ul> |
| OpenAI 請求 | <ul> <li> <p><span>溫度</span>：要使用的取樣溫度。</p> </li> <li> <p><span>Token 上限</span>：此參數調整要產生的 Token 數量上限。換言之，這控制將會產生的回應大小。您幾乎永遠需要改變預設值才能連線，以根據您的需求正常運作。</p> </li> <li> <p><span>Top P</span>：調整 Nucleus 取樣。這可以作為替代選項改變為<span>溫度</span>取樣。</p> </li> <li> <p><span>頻率處罰</span>：模型處罰新 Token (這是來自現有 Token 的重複逐字) 的程度。</p> </li> <li> <p><span>存在處罰</span>：模型處罰新 Token (這已包含在文字中，直到採用的時機點為止) 的程度。</p> </li> <li> <p><span>使用者</span>：最終使用者 ID，有助於監控政策違反情況。</p> </li> </ul> |
| 關聯 | 指定關聯欄位，即輸入資料表格中包含唯一識別碼的欄位。<br><br>在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時，需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回，並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位，可以來自來源資料，也可以作為表格載入過程的一部分。 |
| 名稱 | 連線的名稱。如果沒有輸入名稱，則使用預設名稱。 |

## 瞭解更多資訊

* [Azure OpenAI 服務 REST API 參考](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)