使用 Azure Developer CLI 來部署 Azure OpenAI On Your Data

發行項
02/25/2025

使用本文來了解如何自動資源部署 Azure OpenAI Service On Your Data。 Azure Developer CLI (azd) 是開放原始碼的命令行工具，可使用範本系統簡化佈建和部署資源至 Azure。此範本包含基礎結構檔案，可佈建必要的 Azure OpenAI 資源和設定。此外，也包含已完成的範例應用程式程式碼。

必要條件

Azure 訂用帳戶。免費建立一個。
Azure Developer CLI 已安裝在您的電腦上。
能夠在訂用帳戶層級指派許可權（擁有者或使用者存取管理員）。

複製和初始化 Azure Developer CLI 範本

如需後續步驟，請複製並初始化範本：
```
azd init --template openai-chat-your-own-data
```
azd init 命令會提示您建立環境名稱。此值會作為 Azure Developer CLI 所建立之所有 Azure 資源的開頭。名稱：
- 在所有 Azure 訂用帳戶中必須是唯一的。
- 必須是 3 到 24 個字元。
- 其中僅能包含數字和小寫字母。

使用範本來部署資源

登入 Azure：
```
azd auth login
```
將 Azure OpenAI 資源佈建和部署至 Azure：
```
azd up
```
Azure Developer CLI 會提示您輸入下列資訊：
- Subscription：部署資源的目標 Azure 訂用帳戶。
- Location：在其中部署資源的 Azure 區域。
注意

範例 azd 範本使用 gpt-35-turbo-16k 模型。此範本的建議區域是美國東部，因為不同的 Azure 區域支援不同的 OpenAI 模型。如需區域的支援模型詳細資料，請移至 Azure OpenAI 服務模型支援頁面。

佈建流程可能需要幾分鐘的時間。等候工作完成，再繼續進行後續步驟。
選取 azd 輸出中的連結，以移至 Azure 入口網站中的新資源群組。應該會出現下列最上層資源：
- 具有已部署模型的 Azure OpenAI 服務
- Azure 儲存體帳戶，可用來上傳您自己的資料檔
- 已使用適當索引和資料來源設定的 Azure AI 搜尋服務

將資料上傳至儲存體帳戶

azd 範本已佈建所有必要的資源，讓您與自己的資料聊天，但您仍然需要上傳您想要提供給 AI 服務的資料檔：

移至 Azure 入口網站中的新儲存體帳戶。
在左側功能表上，選取 [儲存體瀏覽器]。
選取 [Blob 容器]，然後移至 [檔案上傳] 容器。
選取窗格頂端的 [上傳] 按鈕。
在開啟的飛出視窗功能表中，上傳您的資料。

注意

搜尋索引子會設定為每隔五分鐘執行一次，以為儲存體帳戶中的資料編製索引。您可以等候幾分鐘，讓系統為上傳的資料編製索引，或從搜尋服務頁面手動執行索引子。

連線或建立應用程式

執行 azd 範本並上傳資料之後，您就可以開始使用 Azure OpenAI On Your Data。如需可用來組建應用程式的程式碼範例，請參閱快速入門文章。

共用方式為