Important
この記事で "(プレビュー)" と付記されている項目は、現在、パブリック プレビュー段階です。 このプレビューはサービス レベル アグリーメントなしで提供されており、運用環境ではお勧めしません。 特定の機能がサポートされていないか、機能が制限されている可能性があります。 詳細については、「 Microsoft Azure プレビューの追加使用条件」を参照してください。
Azure Developer CLI (azd) ai拡張機能を使用すると、ターミナルから Microsoft Foundry で AI エージェントを構築、デプロイ、評価、運用できます。 この記事では、拡張機能をインストールし、インストールを確認し、Azureに対する認証を行います。
前提条件
- Azure サブスクリプション。 無料で作成できます。
- Azure Developer CLI (
azd) バージョン 1.25.2 以降。 azd をインストールします。 - 使用予定のエージェント フレームワークに応じて、Python 3.10 以降、または .NET 8 以降が必要です。
Azureアクセス許可
Azure サブスクリプションには、次のロールが必要です。
| Role | Purpose |
|---|---|
| 投稿者 | Azureリソースをプロビジョニングおよび管理します。 |
| Foundry 所有者 | 新しい Foundry プロジェクトを作成する場合にのみ必要です。 |
Important
Foundry RBAC ロールの名前が最近変更されました。 Foundry User, Foundry Owner, Foundry Account Owner、および Foundry Project Manager は、以前は、AZURE AI ユーザー、Azure AI 所有者、Azure AI アカウント所有者、および AZURE AI Project Manager という名前でした。 名前の変更がロールアウトされている間、以前の名前が表示される場合があります。ロール ID とコア アクセス許可は、名前の変更によって変更されません。
拡張機能のパッケージ化方法を理解する
azd ai名前空間は、複数の独立したazd拡張機能で構成されます。 それぞれが、 azd aiの下に最上位のコマンド グループを提供します。
| 拡張機能 ID | コマンドグループ | それが何をするか |
|---|---|---|
microsoft.foundry |
メタパッケージ | 1 回のインストールのすべての Foundry 拡張機能をバンドルします。 |
azure.ai.agents |
azd ai agent |
ターミナルから Foundry を使用してエージェントを発送します。 |
azure.ai.connections |
azd ai connection |
Foundry プロジェクト接続を管理します。 |
azure.ai.inspector |
azd ai inspector |
ローカルで実行されているエージェントのブラウザー ベースのインスペクター UI。 |
azure.ai.projects |
azd ai project |
Foundry プロジェクト コンテキスト (set、 unset、 show) を管理します。 |
azure.ai.routines |
azd ai routine |
Foundry ルーチン (タイマー、スケジュール、イベント トリガー) を管理します。 |
azure.ai.skills |
azd ai skill |
Foundry スキルを管理する (再利用可能なエージェントの動作ガイドライン)。 |
azure.ai.toolboxes |
azd ai toolbox |
Foundry ツールボックス (バージョン管理されたツール コレクション) を管理します。 |
microsoft.foundry パッケージは、独自のコマンドを提供しないシン メタ パッケージです。 インストールすると、すべての個々の拡張機能が取り込まれます。これは、推奨される開始点です。 エージェント拡張機能が依存しているため、 azure.ai.agents を単独でインストールすると、 azure.ai.inspector も自動的にプルされます。
完全なバンドルをインストールする
メタパッケージを使用して、すべての Foundry 拡張機能を 1 つの手順でインストールします。
azd ext install microsoft.foundry
後で更新するには:
azd ext upgrade microsoft.foundry
個々の拡張機能をインストールまたはアップグレードする
また、各拡張機能を独自に管理することもできます。
# Just the agent surface
azd ext install azure.ai.agents
# Just the routine surface
azd ext install azure.ai.routines
# Upgrade one extension without touching the others
azd ext upgrade azure.ai.connections
個々の拡張機能は個別にバージョン管理されるため、一度に 1 つずつピン留めまたはアップグレードできます。
インストールを確認する
インストール済みの拡張機能の一覧:
azd ext list
microsoft.foundryと個々の拡張機能が表示されます。 各拡張機能では、 version サブコマンドも公開されます。
azd ai agent version
azd ai connection version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version
Authenticate
CLI がユーザーに代わってリソースをプロビジョニングおよび管理できるように、Azureにサインインします。
azd auth login
このコマンドを実行すると、対話型認証用のブラウザー ウィンドウが開きます。 サインインすると、CLI によって、以降のコマンド用に資格情報がローカルにキャッシュされます。