在 VS Code 中開始使用 Azure AI Foundry 專案 （預覽）

重要

本文中標示為 (預覽) 的項目目前處於公開預覽狀態。 此預覽版本沒有服務等級協定，不建議將其用於生產工作負載。 可能不支援特定功能，或可能已經限制功能。 如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

Azure AI Foundry 支援在 VS Code - 桌面和 Web 中開發。 在每個案例中，VS Code 會從遠端連線到在虛擬機上執行的預先建置自訂容器，也稱為計算執行個體。

從 Azure AI Foundry 啟動 VS Code

1. 移至 Azure AI Foundry。

2. 在 Azure AI Foundry 入口網站中開啟您的專案。

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

4. 選取 VS Code 容器。

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

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

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

   警告

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

7. 容器準備就緒之後，請啟動 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 Foundry 入口網站中啟動的特定項目目錄。

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

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

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

重要

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

使用提示流程

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

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

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

您也可以使用 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