Microsoft Foundry は、いくつかの名前付けとアーキテクチャの変更によって進化しました。 クラシック ポータル エクスペリエンスから移行する場合、この記事は用語、機能、SDK、ポータル ナビゲーションの参照マッピングを使用して移行を計画および実行するのに役立ちます。
メモ
Product naming: Microsoftの AI プラットフォームは、Azure AI Studio → Azure AI Foundry → から Microsoft Foundry (現在) に進化しました。 同様に、当社の AI サービス ポートフォリオは、Azure Cognitive Services → Azure AI Services → から Foundry Tools (現在) にプラットフォームとともに進化しました。 プラットフォームの進化にもかかわらず、Azure リソースの種類は Microsoft.CognitiveServices/accounts のままです。 このドキュメントのすべての名前は、同じ進化するプラットフォームを参照します。
前提 条件
- アクティブなサブスクリプションを持つAzure アカウント。 無料で作成します。
- Foundry プロジェクト。
-
SDK 移行: Python 3.9 以降または .NET 8 以降を使用し、
azure-ai-projects2.x およびopenaiパッケージをインストールしてください。 - リソースのアップグレード: アップグレードする予定のAzure OpenAIリソースの所有者または貢献者の役割。
重要
移行の主な日付:
-
2026 年 5 月 30 日 —
azure-ai-inferenceパッケージは廃止されます。openaiパッケージに移行します。 - 2026 年 8 月 26 日 — Assistants API の日没。 一般公開されている Microsoft Foundry Agents サービスを使用します。 移行ガイドに従ってワークロードを更新します。 詳細については、こちらをご覧ください。
移行を計画する
クラシック ポータル エクスペリエンスから現在の Foundry ポータルに移動するには、次の手順に従います。
- 用語の変更を確認します。 用語マッピングをスキャンして、名前が変更された概念と新しいリソースの種類を理解します。
- 機能の比較を確認します。 機能比較表を使用して、新規、拡張、またはクラシックのみの機能を識別します。
- SDK パッケージを更新します。 SDK マッピング テーブルを使用して、非推奨のパッケージを置き換えます。
- エージェントを Responses API に移行します。 2026 年 8 月の日没前に 、Assistants API を使用して Responses API を 使用するエージェントを書き換える。
- Foundry リソース リージョンで Responses API がサポートされていることを確認します。 Responses API と Foundry Agent Service は、すべてのAzure リージョンで使用できるわけではありません。 Foundry リソースがサポートされていないリージョンにある場合、エージェントとその他の Responses API 機能は現在のポータルでは機能しません。 移行する前に 、Responses API リージョンの可用性 の一覧を確認してください。
- 新しいポータルで検証します。 ポータル ナビゲーション参照を使用して、現在のエクスペリエンスのワークフローを確認します。
重要
Responses API は、すべてのAzureリージョンで使用できるわけではありません。 Foundry リソースがサポートされていないリージョンにある場合、現在の Foundry ポータルでエージェントを作成または実行することはできません。 移行する前に、リソースが サポートされているリージョンにいることを確認します。 そうでない場合は、サポートされているリージョンに新しい Foundry リソースを作成します。
用語マッピング
次の表は、従来の概念を現在の概念にマップしています。
| 概念 | 従来の用語 | 現在の用語 | ノート |
|---|---|---|---|
| ポータル (メイン) | Foundry (クラシック) ポータル | Foundry ポータル | Portal のバナー内にあるいスイッチを使用して、それらの間でトグル (切り替え) を行います。 |
| ポータルの設定 | 管理センター | 操作部 | ナビゲーションが再構成されました。 |
| リソースの種類 | Azure OpenAI + Hub | ファウンドリー リソース | 子プロジェクトが付属している、単一の AIServices の種類。 |
| AI サービス | Azure AI サービス | 鋳造ツール | 音声、ビジョン、言語、コンテンツの安全性、コンテンツの理解。 |
| モデルの課金 | サービスとしてのモデル (MaaS) | Foundry Direct モデル | ファースト パーティ モデルは、Azure メーター経由で直接課金されます。 |
| RBAC ロール | Cognitive Services OpenAI ユーザー | AZURE AI ユーザー、AI Project マネージャー、Azure AI 所有者Azure | コントロール/データ プレーンの分離を使用した新しいロール。 |
| API ワイヤ プロトコル | アシスタントAPI | Responses API | Assistants API の日没: 2026 年 8 月 26 日。 |
| API のバージョン管理 | 月単位の api-version パラメーター |
v1 安定したルート | バージョン パラメーターは必要ありません。 |
| 会話の状態 | スレッド | 会話 | 会話には、メッセージだけでなく、アイテム (メッセージ、ツール呼び出し、出力) が格納されます。 |
| チャット メッセージ | メッセージ | 項目 | 項目はメッセージのスーパーセットです。 |
| 実行 | 実行 (非同期、ポーリング) | 応答 (既定で同期) | ポーリング ループは必要ありません。 |
| エージェント定義 | アシスタント/エージェント | エージェントのバージョン | 明示的な種類 (プロンプト、ワークフロー、ホステッド) を指定して、バージョン管理されます。 |
| エージェントの作成 | create_agent() |
create_version() |
PromptAgentDefinitionを使用します。 |
| エンドポイント | 複数 (openai、azureml、cognitiveservices、検索、音声) | 単一プロジェクト エンドポイント + OpenAI v1 エンドポイント | エンドポイント管理が簡素化されました。 |
| ドキュメント | クラシック ドキュメント | 現在のドキュメント | 2 つの個別のドキュメント セット内のコンテンツ。 |
SDK マッピング
次の表を使用して、現在の Foundry エクスペリエンスにマップされる SDK パッケージと、置き換えられる SDK パッケージを特定します。
| SDK パッケージ | 従来の同等品 | ステータス | ノート |
|---|---|---|---|
openai |
azure-ai-inference |
モデル推論に使用する |
azure-ai-inference 2026 年 5 月 30 日に廃止されます。 |
OpenAI() と base_url |
AzureOpenAI() |
標準クライアントを使用する | Azure固有のコードが削除されました。 |
azure-ai-projects 2.x |
azure-ai-projects 1.x |
安定 — 新しいポータルを対象とする | 1.x はクラシック ポータル エクスペリエンスを対象とします。 |
azure-ai-projects 2.x |
azure-ai-generative |
安定 | 機能がプロジェクト クライアントにマージされました。 |
azure-ai-projects 2.x |
azure-ai-ml |
安定 | ハブからプロジェクトへの移行シナリオの場合。 |
azure-ai-projects (リモート) + azure-ai-evaluation (ローカル) |
azure-ai-evaluation (スタンドアロン) |
安定 | プロジェクト クライアントを使用したリモート評価。ローカル評価は変更されていません。 |
azure-search-documents (プロジェクト接続経由) |
azure-search-documents |
安定 | プロジェクト クライアントを介して検出可能な個別のパッケージ。 |
警告
SDK のバージョンがポータルのエクスペリエンスと一致していることを確認します。 2.x SDK サンプルを 1.x セットアップ (またはその逆) で使用すると、エラーが発生します。
次の例は、最も一般的な SDK 移行を示しています。Azure固有の AzureOpenAI クライアントを標準の OpenAI クライアントに置き換えます。
クラシック (前):
from openai import AzureOpenAI
client = AzureOpenAI(
azure_endpoint="https://my-resource.openai.azure.com",
api_key="my-key",
api_version="2024-12-01-preview"
)
現在 (後):
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
client = OpenAI(
base_url="https://my-project.services.ai.azure.com/openai/v1",
default_headers={"Authorization": f"Bearer {get_bearer_token_provider(DefaultAzureCredential(), 'https://cognitiveservices.azure.com/.default')()}"}
)
機能の比較
次の表は、クラシック ポータルエクスペリエンスと現在のポータル エクスペリエンスの機能の可用性を比較したものです。
両方のポータルで使用可能
| 機能 | クラシック | 現在の | ノート |
|---|---|---|---|
| 鋳造プロジェクト | ✅ | ✅ | |
| チャットの完了 | ✅ | ✅ | |
| 微調整 | ✅ | ✅ | |
| 評価 | ✅ | ✅ | 現在のポータルで改善されました |
| モデル カタログ | ✅ | ✅ | 現在のポータルで展開 |
現在のポータルの新機能
これらの機能は、現在の Foundry ポータルでのみ使用できます。
| 機能 | ステータス |
|---|---|
| Responses API | GA |
| エージェント v2 (Responses API) | GA |
| ツール カタログ (1,400 以上のツール) | GA (カタログ内の個々のツールのラベルをチェックして、それらが GA かプレビューかを判断します) |
| マルチエージェント ワークフロー | プレビュー |
| エージェント メモリ | プレビュー |
| M365/Teams に対するエージェントの公開 | GA |
| Foundry IQ | プレビュー |
| ホストエージェント | プレビュー |
| A2A プロトコル | プレビュー |
| Foundry コントロール プレーン | プレビュー |
クラシックのみ (移行が必要)
| 機能 | クラシック | 現在の | 移行アクション |
|---|---|---|---|
| Azure の OpenAI リソース | ✅ | Foundry リソースを使用する | Foundry リソースへのアップグレード |
| ハブベースのプロジェクト | ✅ | 表示されない | クラシック ポータルに切り替えるか、Foundry プロジェクトに移行する |
ポータル内を移動する
クラシック ポータルでは、すべてのナビゲーションにカスタマイズ可能な左ペインが 1 つ使用され、 下部に管理センター が表示されます。 現在のポータルでは、機能が 5 つの最上位セクションに分割され、それぞれに左側のウィンドウが表示されます。
| セクション | Scope | そこで見つかるもの |
|---|---|---|
| ホーム | 選択したプロジェクト | Projectの概要とクイック アクション |
| 発見 | 選択したプロジェクト | モデル カタログとモデル ベンチマーク |
| ビルド | 選択したプロジェクト | エージェント、モデル、プレイグラウンド、評価、微調整 |
| 動作 | すべてのプロジェクト | 管理者、クォータ、コンプライアンス、フリートの正常性、トレース |
| ドキュメント | N/a | ドキュメント のリンク |
次の表は、よく使用されるクラシック ポータルの場所を現在の場所にマップします。
| タスク | クラシック ポータルの場所 | 現在のポータルの場所 |
|---|---|---|
| モデルのデプロイを表示する | 左側のウィンドウのモデルとエンドポイント | 構築>モデル |
| プレイグラウンドを開く | 左側のウィンドウのプレイグラウンド | ビルド>モデル> モデルを選択する |
| エージェントをビルドする | 左側のウィンドウのエージェント | ビルド>エージェント |
| モデル カタログを参照する | 左側のウィンドウのモデル カタログ | 検出>モデル カタログ |
| 評価の表示 | 左側のウィンドウでの評価 | ビルド>評価 |
| モデルを微調整する | 左側のウィンドウでの微調整 | ビルド>微調整 |
| トレースと監視 | 左側のウィンドウでのトレース | 操作>トレース |
| クォータの管理 | 管理センター>クォータ | オペレート>クォータ |
| ユーザーとアクセス許可を管理する | 管理センター>ユーザー | 操作>管理者 |
| すべてのプロジェクトとリソースを表示する | 管理センター>すべてのリソース | 操作>管理者 |
| 接続されているリソース | 管理センター>接続されているリソース | > 管理者>プロジェクトを選択する |
| ガードレールとコンテンツ フィルター | 左側のウィンドウのガードレールとコントロール | > コンプライアンス |
ポータル エクスペリエンスを切り替える
クラシック ポータルと現在のポータル エクスペリエンスはいつでも切り替えることができます。 この切り替えでは、作業中のプロジェクトなど、現在のコンテキストが保持されます。
ヒント
現在のポータルには Foundry プロジェクトのみが表示されます。 ハブベースのプロジェクトまたはその他のリソースの種類にアクセスする必要がある場合は、クラシック ポータルに戻ります。
- 上部のバナーで [ New Foundry ] トグルを探します。
- トグルを選択して、クラシック エクスペリエンスと現在のエクスペリエンスを切り替えます。
- 選択したポータル インターフェイスでページが再読み込みされます。
移行に関する一般的な問題のトラブルシューティング
| 症状 | 原因 | 解決方法 |
|---|---|---|
ModuleNotFoundError または予期しない API の動作 |
SDK のバージョンがポータルターゲットと一致しない | SDK マッピング テーブルを確認し、正しいパッケージ バージョンをインストールする |
| 新しいポータルにプロジェクトがありません | ハブ ベースのプロジェクトが現在のポータルに表示されない | クラシック ポータルに切り替えてハブ ベースのプロジェクトにアクセスするか、 Foundry プロジェクトに移行します (記事はクラシック ドキュメントに記載されています) |
| エンドポイント接続エラー | 古いマルチエンドポイント URL が解決されなくなりました | 単一のプロジェクト エンドポイント形式に更新する (https://<project>.services.ai.azure.com) |
AuthenticationError 新しいクライアントを使用する |
適切なヘッダーなしで OpenAI() クライアントで使用される API キー |
DefaultAzureCredentialに示すように、ベアラー トークン プロバイダーでを使用する |
エージェント コードが 404 または MethodNotAllowed |
Responses API エンドポイントに送信されたアシスタント API 呼び出し | Responses API を使用するようにエージェント コードを書き換える (create_version()ではなくcreate_agent()) |
| 現在のポータルでエージェントを使用できない | Foundry リソースは、Responses API をサポートしていないリージョンにあります | サポートされているリージョンに Foundry リソースを作成する |