開発環境を準備する

Microsoft Foundry を使用してビルドする開発環境を準備します。 サポートされているプログラミング言語、認証用のAzure CLI、Git、および Foundry 開発者ツールが必要です。

Tip

Foundry DevPack は、開発者ツールを 1 つのコマンドでインストールする場合に推奨される方法です。 また、各ツールを個別にインストールすることもできます。

重要

この記事では、一般的な前提条件、グローバル ツール、およびVisual Studio Codeセットアップについて説明します。 シナリオ固有の SDK パッケージや認証コードについては説明しません。 環境の準備ができたら、クイックスタートに進 みます。

前提 条件

  • アクティブなサブスクリプションを持つAzure アカウント。 お持ちでない場合は、無料試用版サブスクリプションを含む無料Azure アカウントを作成します。

  • Visual Studio Codeをダウンロード、インストール、構成するか、選択した IDE を使用します。

  • Foundry リソースを作成して管理するには、次のいずれかのAzure RBAC ロールを使用します。

    • Foundry Project Manager を使用して Foundry プロジェクトを管理します。

    重要

    Foundry RBAC ロールの名前が最近変更されました。 Foundry User, Foundry Owner, Foundry Account Owner、および Foundry Project Manager は、以前は、AZURE AI ユーザー、Azure AI 所有者、Azure AI アカウント所有者、および AZURE AI Project Manager という名前でした。 名前の変更がロールアウトされている間、以前の名前が表示される場合があります。ロール ID とコア アクセス許可は、名前の変更によって変更されません。

    • 一部のシナリオで必要となる、サブスクリプション レベルのアクセス許可とロール割り当てのための所有者。

  • リソースを作成せずに既存のプロジェクトを使用するには、少なくともプロジェクトに Foundry User が必要です。

各ロールの詳細については、「Microsoft Foundry のロールベースのアクセス制御」を参照してください。

Foundry DevPack をインストールする

Foundry DevPack は、エディター、ターミナル、およびコーディング エージェント用の Foundry 開発者ツールをインストールします。 オペレーティング システムのコマンドを実行します。

Windows

winget install Microsoft.FoundryDevPack

macOS

brew install --cask microsoft/foundry/devpack && foundry-devpack install

Linux

curl -fsSL https://aka.ms/foundry-devpack-install.sh | bash

DevPack は、次のツールをインストールします。

ツール 実行可能事項
Microsoft Foundry Toolkit for Visual Studio Code Visual Studio Codeからビルド、テスト、評価、デプロイを行います。
azd と azd ai ターミナルからスキャフォールディング、デプロイ、評価、自動化を行います。
Foundry Canvas (プレビュー) ガイド付きCopilot キャンバスを使用して、ホストされたエージェントを設計してデプロイします。
Microsoft Foundry スキル Foundry ワークフローのコーディング エージェントに再利用可能なガイダンスを提供します。

次のセクションに進み、プログラミング言語を設定し、Azure CLIでサインインし、Git をインストールします。

プログラミング言語を操作する

アプリケーションに必要な言語を使用します。 対応するランタイムまたは Visual Studio Code 拡張機能をインストールする必要がある場合は、そのセクションを展開してください。

Python

Python 3.10 以降をインストールします。 Python 3.9 は、サポートされている最小バージョンです。 パッケージをグローバルにインストールする代わりに、プロジェクトの仮想環境を作成します。

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS、Linux

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

エディターのサポートについては、Visual Studio CodeのPython拡張機能をインストールします。

Java

JDK 17 以降をインストールします。 Microsoft Build of OpenJDKは無料の長期サポート ディストリビューションです。 エディターのサポートについては、Java用の Visual Studio Code 拡張機能パックをインストールします。

JavaScript/TypeScript

Node.js をインストールします。 バージョン 20 以降をお勧めします。

C#

.NET SDK の最新の Long-Term サポート バージョンをインストールします。 エディターのサポートについては、Visual Studio Code用の C# Dev Kit をインストールします。

Azure CLIをインストールしてサインインする

Azure CLIをインストールし、ローカル開発環境からサインインして、コードでユーザー資格情報を使用して Foundry を介してAzure サービスを呼び出すことができるようにします。

ほとんどの場合、次のコマンドを使用してターミナルからAzure CLIをインストールできます。

winget install -e --id Microsoft.AzureCLI

これらのコマンドが特定のオペレーティング システムまたはセットアップで機能しない場合は>Azure CLI

Azure CLIをインストールしたら、az login コマンドを使用してサインインし、ブラウザーを使用してサインインします。

az login

または、デバイス コードを使用してブラウザー経由で手動でサインインすることもできます。

az login --use-device-code

サインイン後にスクリプトを実行するには、このターミナルを開いたままにしておきます。

Git をインストールする

Foundry SDK サンプルを複製するには、Git が必要です。 Git がインストールされていない場合は、 Git Web サイトからダウンロードしてインストールします。

開発者ツールを個別にインストールする

Foundry DevPack を使用しない場合は、各開発者ツールを個別にインストールします。

  1. Azure Developer CLI をインストールします。
  2. azdのすべての Foundry 拡張機能をインストールします。
    azd ext install microsoft.foundry
    代わりに個々の拡張機能をインストールするには、「Azure Developer CLI Foundry 拡張機能をインストールする」を参照してください。
  3. エディターとコーディング エージェント ツールをインストールします。

多くの AI ソリューション テンプレートでは、azdを使用したデプロイがサポートされています。

トラブルシューティング

問題 解決方法
インストール後にコマンドが見つかりません ターミナルを閉じて再度開くか、Visual Studio Code再起動して PATH の変更を有効にします。
az login ブラウザー エラーで失敗する az login --use-device-codeを実行して、デバイス コードで認証します。
Pythonが見つかりません macOS または Linux でpythonする代わりにpython3を使用するか、3.9 以降Pythonインストールします。
Python パッケージのインストール中にアクセス許可が拒否されました macOS または Linux では、 sudo pip installを使用しないでください。 代わりに仮想環境を使用してください。

関連コンテンツ

  • Last updated on