OpenAPI を使用して Foundry Agent Service に機能を公開することで、既存の Web アプリを強化します。 多くの Web アプリには既に REST API が用意されているため、REST API をツールとして呼び出すことができるエージェントへの統合に最適な候補になります。 Foundry Agent Service をこれらの API に接続することで、コードがほとんどない強力で機能豊富なエージェントを迅速に作成できます。
概要
OpenAPI 仕様では、REST API が標準化された、コンピューターで読み取り可能な形式で記述されています。 Foundry Agent Service では、これらの仕様を使用して、AI エージェント内のツールとして Web アプリの機能を自動的に検出して呼び出すことができます。 このアプローチにより、次のことが可能になります。
- 既存の API を活用する: コードを変更せずに、現在の REST エンドポイントを AI アクセス可能なツールに変換する
- API 標準の維持: 人間と AI の両方のコンシューマーにサービスを提供する業界標準の OpenAPI 仕様を使用する
- 迅速な統合を有効にする: OpenAPI 仕様を更新するだけで、エージェントに新しい機能を追加する
- ビジネス ロジックを保持する: 既存のアプリケーション コード、セキュリティ、およびデータ アクセス パターンを変更せずに保持する
- マネージド サービスを使用したスケーリング: Foundry Agent Service の組み込みのスケーラビリティと信頼性を使用する
このパターンは特に強力です。ほとんどの最新の Web アプリケーションでは、コア機能用の REST API が既に公開されているためです。 これらの API を OpenAPI 仕様で文書化することで、インテリジェント エージェントの構成要素としてすぐに使用できるようになります。
OpenAPI ツールを使用する場合
次の場合は、App Service アプリを Foundry エージェント用の OpenAPI ツールとして公開することを検討してください。
- 既存の REST API がある: アプリケーションには、明確に定義された HTTP エンドポイントが既に用意されています
- 迅速なエージェント開発が必要: 最小限のカスタム コードで機能エージェントをすばやく作成する必要がある
- 宣言型ツール定義が必要です。プログラミングではなく、仕様を使用して機能を記述することをお勧めします。
- 複数のエージェントをサポートする場合: 同じ API で、オーケストレーションが異なる複数のエージェント シナリオに対応できます
- 明確な API コントラクトが必要です。OpenAPI 仕様は、エージェントと人間の開発者の両方にドキュメントと検証を提供します
このアプローチは、REST API がコンポーネント間の自然な境界を形成する基幹業務アプリケーション、内部ツール、マイクロサービス アーキテクチャに特に適しています。
OpenAPI ツールとエージェントの連携方法
統合は簡単なフローに従います。
- API を定義する: App Service REST エンドポイントの OpenAPI 仕様を作成または生成する
- ツールとして登録する: OpenAPI 仕様の場所を指定して、API を Foundry Agent Service に追加する
- エージェント検出: エージェントは、使用可能な操作、パラメーター、および応答の形式を自動的に理解します
- ランタイム呼び出し: ユーザーがエージェントと対話するときに、必要に応じて App Service エンドポイントを呼び出します
- 結果処理: エージェントは API 応答を解釈し、結果を会話に組み込みます
App Service には、マネージド ID や Microsoft Entra ID の統合など、セキュリティで保護されたツールの呼び出しに必要な認証パターンが組み込まれています。