Share via


如何開始使用 Azure AI SDK

注意

Azure AI Studio 目前處於公開預覽。 提供此預覽時並無服務等級協定,因此我們不建議將其用於生產工作負載。 可能不支援特定功能,或可能已經限制功能。 如需詳細資訊,請參閱 Microsoft Azure 預覽版增補使用條款

Azure AI SDK 是一系列套件,可提供 Azure OpenAI 等 Azure AI 服務的存取。

在本文中,您將了解如何開始使用適用於生成式 AI 應用程式的 Azure AI SDK。 您可以:

將 SDK 安裝至現有的開發環境

安裝 Python

首先,安裝 Python 3.10 或更高版本、建立虛擬環境或 conda 環境,並將您的套件安裝到該虛擬或 conda 環境。 請勿將生成式 AI SDK 安裝到您的全域 Python 安裝中。 安裝 Python 套件時,您應該一律使用虛擬或 conda 環境,否則您可能會破壞 Python 的系統安裝。

透過虛擬環境安裝 Python

遵循 VS Code Python 教學課程中的指示,以了解在作業系統上安裝 Python 和建立虛擬環境的最簡單方式。

如果您已安裝 Python 3.10 或更高版本,您可以使用下列命令來建立虛擬環境:

py -3 -m venv .venv
.venv\scripts\activate

透過 Conda 環境安裝 Python

首先,遵循這裡的指示來安裝 miniconda。

然後,建立並啟動新的 Python 3.10 環境:

conda create --name ai_env python=3.10
conda activate ai_env

安裝 Azure AI 生成式 SDK

目前,若要使用 Azure AI SDK 的生成式套件,您會安裝一組套件,如本節所述。

警告

建議您在虛擬環境、conda 環境或 Docker 容器中安裝 SDK。 如果您未這麼做,您可能會遇到系統上已安裝的套件的相依性問題。 如需詳細資訊,請參閱安裝 Python

選項 1:透過 pip 安裝

pip install azure-ai-generative[index,evaluate,promptflow]
pip install azure-identity

選項 2:透過 requirements.txt 安裝

  1. 在專案目錄中建立名為 requirements.txt 的新文字檔。

  2. 將來自 GitHub 上 Azure/aistudio-copilot-sample requirements.txt 存放庫的內容複製到您的 requirements.txt 檔案。

  3. 輸入下列命令以從 requirements.txt 檔案安裝套件:

    pip install -r requirements.txt
    

Azure AI SDK 現在應該已安裝並可供使用!

使用 Azure AI SDK 而不安裝

您可以如先前所述,在本機安裝 Azure AI SDK,或透過網際網路瀏覽器或 Docker 容器執行它。

選項 1:使用 Azure AI Studio 中的 VS Code (Web)

Azure AI Studio 中的 VS Code (Web) 會在計算執行個體上建立和執行開發容器。 若要開始使用此方法,請遵循使用 VS Code 中的 Azure AI 專案中的指示。

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

選項 2:Visual Studio Code 開發容器

您可以使用 VS Code 開發容器,在 Docker 容器中執行 Azure AI SDK:

  1. 遵循 VS Code 開發容器的安裝指示
  2. 複製 aistudio-copilot-sample 存放庫,並使用 VS Code 加以開啟:
    git clone https://github.com/azure/aistudio-copilot-sample
    code aistudio-copilot-sample
    
  3. 選取 [在開發容器中重新開啟] 按鈕。 如果沒有出現,請開啟命令選擇區 (在 Windows 和 Linux 上為 Ctrl+Shift+P,在 Mac 上為 Cmd+Shift+P),然後執行 Dev Containers: Reopen in Container 命令。

選項 3:GitHub Codespaces

GitHub Codespaces 中的 Azure AI 程式碼範例可協助您快速開始使用,而不需要在本機安裝任何項目。

Open in GitHub Codespaces

下一步