Azure AI SDK の使用を開始する方法

[アーティクル]
11/24/2023

Note

Azure AI Studio は、現在、パブリックプレビュー段階です。このプレビューはサービスレベルアグリーメントなしで提供されており、運用環境ではお勧めしません。特定の機能はサポート対象ではなく、機能が制限されることがあります。詳しくは、Microsoft Azure プレビューの追加使用条件に関するページをご覧ください。

Azure AI SDK は、Azure OpenAI などの Azure AI サービスへのアクセスを提供するパッケージのファミリです。

この記事では、生成型 AI アプリケーション用の Azure AI SDK の使用を開始する方法について説明します。次のいずれかを実行できます。

SDK を既存の開発環境にインストールまたは
Azure AI SDK をインストールせずに使用する

既存の開発環境に SDK をインストールする

Python のインストール

まず、Python 3.10 以降をインストールし、仮想環境または conda 環境を作成し、その仮想環境または conda 環境にパッケージをインストールします。グローバル Python インストールに Generative AI SDK をインストールしないでください。 Python パッケージをインストールするときは、常に仮想環境または conda 環境を使用する必要があります。そうしないと、Python のシステムインストールが中断される可能性があります。

仮想環境経由で Python をインストールする

Python をインストールしてオペレーティングシステムに仮想環境を作成する最も簡単な方法については、 VS Code Python チュートリアルの手順に従ってください。

Python 3.10 以降が既にインストールされている場合は、次のコマンドを使用して仮想環境を作成できます:

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

python3 -m venv .venv
source .venv/bin/activate

python3 -m venv .venv
source .venv/bin/activate

Conda 環境経由で Python をインストールする

まず、ここでの手順に従って miniconda をインストールします。

次に、新しい Python 3.10 環境を作成してアクティブ化します:

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

Azure AI Generative SDK をインストールする

現在、Azure AI SDK の生成パッケージを使用するには、このセクションの説明に従って一連のパッケージをインストールします。

注意事項

SDK は、仮想環境、conda 環境、または docker コンテナーでインストールすることをお勧めします。これを行わないと、システムにインストールされているパッケージに依存関係の問題が発生する可能性があります。詳細については、「Python のインストール」を参照してください。

オプション 1: pip 経由でインストールする

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

オプション 2: requirements.txt 経由でインストールする

プロジェクトディレクトリに requirements.txt という名前の新しいテキストファイルを作成します。
GitHub の Azure/aistudio-copilot-sample requirements.txt リポジトリから requirements.txt ファイルにコンテンツをコピーします。
次のコマンドを入力して、 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 Generative SDK、Azure AI CLI、プロンプトフロー SDK、およびその他のツールを備える Docker コンテナーに基づいています。コンテナー内で VS Code をリモートで実行するように構成されています。 docker コンテナーはこの Dockerfile で定義されており、Microsoft の Python 3.10 開発コンテナーイメージに基づいています。

オプション 2: Visual Studio Code 開発コンテナー

VS Code Dev Containers を使用して、Docker コンテナーで Azure AI SDK を実行できます:

VS Code Dev Containers のインストール手順に従います。

aistudio-copilot-sample リポジトリを複製し、VS Code で開きます:

git clone https://github.com/azure/aistudio-copilot-sample
code aistudio-copilot-sample

[開発コンテナーで再度開く] ボタンを選択します。表示されない場合は、コマンドパレット (Windows と Linux でCtrl+Shift+P、Mac で Cmd+Shift+P) を開き、Dev Containers: Reopen in Container コマンドを実行します。

オプション 3: GitHub Codespaces

GitHub Codespaces の Azure AI コードサンプルは、ローカルに何もインストールしなくてもすぐに開始するのに役立ちます。