開始使用 VS Code 中的 Azure AI Studio 專案 (預覽版)

重要

本文所述的部分功能可能僅適用於預覽版。 此預覽版本沒有服務等級協定，不建議將其用於生產工作負載。 可能不支援特定功能，或可能已經限制功能。 如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

Azure AI Studio 支援在 VS Code 電腦版與網頁版中開發。 在每個案例中，VS Code 會從遠端連線到在虛擬機上執行的預先建置自訂容器，也稱為計算執行個體。

從 Azure AI Studio 啟動 VS Code

1. 移至 Azure AI Studio。

2. 開啟 Azure AI Studio 中的專案。

3. 在左側功能表中，選取 [程式碼]。

4. 針對 計算，請選取現有的計算執行個體或建立新的計算執行個體。

   • 選取要使用的計算執行個體。 如遭停止，請選取 [啟動計算] 並等候其切換至 [執行中]。 當計算可供使用時，您會看到 [就緒] 狀態。
   • 如果您沒有計算執行個體，請輸入名稱，然後選取 [建立計算]。 等候計算執行個體準備就緒。

5. 針對 VS Code 容器，請在按鈕啟用後選取 [設定容器]。 這會為您設定計算上的容器。 容器設定可能需要幾分鐘的時間才能完成。 第一次設定容器之後，後續即可直接啟動。 您可能需要在出現提示時驗證計算。 設定完成時，您會看到 [就緒]。

   警告

   即使您 在計算執行個體上啟用閑置關機，任何使用此自訂 VS Code 容器設定的計算都不會發生閑置關機。 這是為了確保您在容器工作時，計算不會意外關閉。

6. 在 VS Code 中開啟專案：

   • 如果您要在本機 VS Code 執行個體中工作，請選擇 [在 VS Code (電腦版) 中開啟專案]。 新的 VS Code 本機執行個體隨即在本機電腦開啟。
   • 如果您要改為在瀏覽器中工作，請選擇下拉式箭號，然後選擇 [在 VS Code (網頁版) 中開啟專案]。 連線至 vscode.dev 的新瀏覽器索引標籤隨即開啟。

   

自訂容器資料夾結構

我們預先建置的開發環境是以具有 Azure AI SDK、提示流程 SDK 和其他工具的 Docker 容器為基礎。 環境已設定為在容器內部遠端執行 VS Code。 容器是以與此 Dockerfile 類似的方式定義，並以 Microsoft 的 Python 3.10 開發容器映像為基礎。

您的檔案總管會開啟至您在 AI Studio 中啟動的特定專案目錄。

容器是使用 Azure AI 資料夾階層 (afh 目錄) 來設定，其設計目的是在目前的開發內容內引導您，並協助您最有效率地處理程式碼、資料和共用檔案。 這個 afh 目錄儲存您的 Azure AI Studio 專案，而且每個專案都有一個包含 code、data 和 shared 資料夾的專用專案目錄。

下表摘要說明資料夾結構：

資料夾	描述
code	用於處理 Git 存放庫或本機程式碼檔案。 code 資料夾是直接位在您的計算執行個體上的儲存位置，而且對大型存放庫效能良好。 這是複製 Git 存放庫或以其他方式帶入或建立程式碼檔案的理想位置。
data	用於儲存本機資料檔案。 建議使用 data 資料夾，以一致的方式儲存及參考本機資料。
shared	用於處理專案的共用檔案和資產，例如提示流程。 例如，可以在 shared\Users\{user-name}\promptflow 找到專案提示流程。

重要

建議您在這個專案目錄內工作。 您包含在專案目錄中的檔案、資料夾和存放庫會保存在主機電腦上 (您的計算執行個體)。 即使計算執行個體停止或重新啟動，儲存在程式碼和資料資料夾中的檔案仍會保存，但如果刪除該計算，則會遺失。 不過，共用檔案會儲存在中樞的儲存體帳戶中，因此就算刪除計算執行個體，也不會遺失。

使用提示流程

您可以建立、參考及處理提示流程。

您可以在 shared\Users\{user-name}\promptflow 找到已在 Azure AI Studio 中建立的提示流程。 您也可以在 code 或 shared 資料夾中建立新的流程。

提示流程會自動使用您專案可存取的 Azure AI Studio 連線。

您也可以使用 VS Code 中，已預安裝於這個環境的提示流程延伸模組。 在這個延伸模組中，您可以將連線提供者設定為 您的專案。 請參閱取用 Azure AI 的連線。

如需詳細資訊，請參閱提示流程功能。

使用 AI 應用程式範本

AI 應用程式範本會從專案的 [程式碼] 索引標籤右側連結。 這些範例會逐步引導您使用 Azure AI SDK 來：

• 設定您的開發環境並連線到現有的資源
• 引進您的自訂應用程式程式碼
• 執行評估
• 部署程式碼

若要佈建全新的一組資源，包括新的中樞和專案，以及部署這些範例應用程式，您可以在本機開發環境中使用 Azure Developer CLI (AZD)。

備註

如果您打算跨多個程式碼和資料目錄或多個存放庫作業，您可以使用 VS Code 中的分割根檔案總管功能。 若要試用這項功能，請遵循下列步驟：

1. 輸入 Ctrl+Shift+p 開啟命令選擇區。 搜尋並選取[工作區: 將資料夾新增至工作區]。
2. 選取您要載入的存放庫資料夾。 您應該會在檔案總管中看到已開啟資料夾的新區段。 如果是存放庫，您現在可以在 VS Code 中使用原始檔控制。
3. 如果您想要儲存這個設定供未來的開發工作階段使用，請再次輸入 Ctrl+Shift+p，然後選取[工作區: 另存工作區為]。 這個動作會將設定檔儲存至您目前的資料夾。

如需慣用程式設計語言的應用程式範本和 SDK 範例，請參閱 開發使用 Azure AI 服務的應用程式。

相關內容

• 開始使用提示流程 SDK 建置聊天應用程式
• 開始使用 Azure AI SDK