エージェントのテスト、デプロイ、統合

エージェントのテスト、デプロイ、発行は、開発から運用環境への移行において重要な手順です。 Microsoft Foundry には、エージェントの動作の検証、Foundry プロジェクトへのデプロイ、および外部のコンシューマーとアプリケーションが使用できる呼び出し可能なエンドポイントとしてのエージェントの発行に関する包括的な機能が用意されています。

エージェントのテスト戦略

徹底的なテストにより、エージェントはユーザーに到達する前に、さまざまなシナリオで確実に動作します。 Foundry ポータルと Visual Studio Code 拡張機能の両方で、対話型テスト用のプレイグラウンドが提供されます。

遊び場を効果的に使用する:

• 満足のいくパス テスト - エージェントが一般的な予期される要求を正しく処理するかどうかを確認します。
• エッジ ケース テスト - あいまいな入力、不完全な情報、および通常とは異なる要求を試して、エージェントが不確実性をどのように処理するかを明らかにします。
• 境界テスト - スコープ外の要求をテストして、エージェントが命令で定義されている境界を尊重することを確認します。
• 複数ターンの会話テスト - エージェントが複数の交換にわたってコンテキストを維持し、以前の応答に基づいて構築されていることを確認します。
• ツール呼び出しテスト - エージェントが適切な時間に適切なツールを呼び出し、結果を正しく組み込むことを確認します。

テスト結果を記録して改善を追跡し、回帰をキャッチします。

プロジェクトへのエージェントの配置

Microsoft Foundry では、ポータルまたは Visual Studio Code からのエージェントのデプロイがサポートされています。 配置すると、エージェント構成が Foundry プロジェクトに保存されるため、テストと反復処理が可能になります。

Foundry ポータルからのデプロイ

1. Foundry ポータルでエージェントに移動する
2. 構成とテスト結果が十分であることを確認する
3. エージェントのページから [保存] を選択する
4. バージョンと展開の設定を確認する

Visual Studio Codeからのデプロイ

1. AI Toolkit でエージェントを開く
2. [ Foundry に保存] を 選択して構成の変更をプッシュする
3. ホストされているエージェントの場合は、開発者ツールで [+ビルド] メニューを開き、[Microsoft Foundry にデプロイ] を選択します
4. コンテナーの構成を選択して確認する

どちらの方法でも、チーム メンバーがアクセスしてテストできるプロジェクト ワークスペース内にエージェントが保持されます。

エンドポイントへのエージェントの公開

発行すると、プロジェクト ワークスペースからエージェント アプリケーションと呼ばれるマネージド Azure リソースに エージェントが移動されます。 この手順により、エージェントは安定したエンドポイントを介して外部から呼び出し可能になります。

発行で生まれるもの

エージェント バージョンを発行すると、Foundry によって次のことが作成されます。

• エージェント アプリケーション - 独自の呼び出し URL、認証ポリシー、および Entra エージェント ID を持つ Azure リソース。
• デプロイ - アプリケーション内の特定のエージェント バージョンの実行中のインスタンス。ライフサイクル管理の開始/停止が含まれます。

デプロイと発行の主な違いはスコープです。 配置すると、プロジェクト内にエージェントが保持されます。 発行により、Foundry プロジェクトへのアクセスを必要とせずに外部コンシューマーが呼び出すことができる専用エンドポイントが作成されます。

Foundry ポータルからの発行

1. ポータルで、発行するエージェントのバージョンを選択します
2. [ 発行] を選択してエージェント アプリケーションとデプロイを作成する

Visual Studio Code からの発行

1. コマンド パレット (Ctrl+Shift+P) を開き、Microsoft Foundry: Deploy Hosted Agent をホストエージェント用に実行します。
2. ターゲット ワークスペースとコンテナーの構成を選択する
3. 確認してデプロイする

発行後、AI Toolkit 拡張機能ツリー ビューの [Hosted Agents (Preview)] セクションにエージェントが表示されます。

エージェント アプリケーション エンドポイント

発行されたエージェントは、Responses API プロトコルを使用して安定したエンドポイントを公開します。

https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>/applications/<app-name>/protocols/openai/responses

この URL は、新しいエージェント バージョンをロールアウトしても同じままであるため、ダウンストリーム コンシューマーは更新によって中断されません。

認証と ID

エージェント アプリケーションでは、認証に Microsoft Entra ID が使用されます。 呼び出し元には、エージェント アプリケーション リソースに対する Azure AI ユーザー ロールが必要です。 API キー認証は、エージェント アプリケーションではサポートされていません。

エンドポイントの確認

発行後、エンドポイントが動作することを確認します。

1. アクセス トークンを取得します。

   az account get-access-token --resource https://ai.azure.com
   

2. エージェント アプリケーション エンドポイントを呼び出します。

   curl -X POST \
     "https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>/applications/<app-name>/protocols/openai/responses?api-version=2025-11-15-preview" \
     -H "Authorization: Bearer <access-token>" \
     -H "Content-Type: application/json" \
     -d '{"input":"Say hello"}'
   

403 Forbiddenを受け取った場合は、呼び出し元にエージェント アプリケーション リソースに対する Azure AI ユーザー ロールがあることを確認します。

公開済みエージェントのアップデート

新しいエージェント バージョンをロールアウトするには:

1. 開発環境に変更を加え、徹底的にテストする
2. Foundry ポータルで、エージェントプレイグラウンドから [更新プログラムの発行 ] を選択します
3. エージェント アプリケーションは、100% のトラフィックを新しいバージョンに自動的にルーティングします

エンドポイント URL は変更されないため、既存の統合は引き続き機能します。

統合コードの生成

Microsoft Foundry VS Code 拡張機能は、公開されたエージェントにアプリケーションを接続するためのサンプル統合コードを生成します。

1. [マイ リソース] ビューでデプロイしたエージェントを選択する
2. コードの表示を選択してください。
3. フォルダーを選択する
4. この拡張機能は、認証、接続、メッセージの送信、応答の処理のためのコードを生成します

統合パターン

公開されたエージェントを統合するための一般的なパターンは次のとおりです。

• Web アプリケーション - Responses API エンドポイントにユーザー メッセージを送信し、UI に応答を表示します。 複数ターンの対話のために、クライアント側で会話履歴を保存します。
• API 駆動型ワークフロー - イベントまたはスケジュールによってトリガーされるバックエンド サービスからエージェント エンドポイントを呼び出します。 応答をプログラムで処理して、ダウンストリーム アクションを推進します。
• チャットボット インターフェイス - ユーザー セッションを会話にマップします。 エンドポイントを介してリアルタイムのメッセージ交換を処理します。
• バックグラウンド自動化 - 定期的なタスクのエージェント呼び出しをスケジュールします。 システム データをエージェントにフィードし、出力を処理してビジネス システムを更新します。

実稼働に関する考慮事項

運用環境でエージェントを実行するには、いくつかの運用領域に注意する必要があります。

• 監視 - Application Insights 統合を使用して、応答時間、ツール呼び出しの成功率、エラー パターン、トークン消費量を追跡します。
• セキュリティ - 認証にマネージド ID を使用し、最小特権アクセスを適用し、データ保持ポリシーを定義します。
• コスト管理 - トークンの使用状況を監視し、応答の長さの制限を設定し、予期しないスパイクを防ぐためにレート制限を実装します。
• エラー処理 - 一時的な障害に対して指数バックオフを使用して再試行ロジックを実装します。 バックオフ戦略を使用してレート制限を処理します。 エージェントに送信する前に入力を検証します。
• 会話管理 - エージェント アプリケーション エンドポイントは現在、ステートレス応答 API のみをサポートしています。 会話履歴をクライアントに保存して、複数ターンのエクスペリエンスを提供します。