上級 - Microsoft 365 Agents Toolkitを使用する

  • 6 分

ほとんどのシナリオでは、Foundry ポータルから直接発行するのが、エージェントをMicrosoft TeamsおよびMicrosoft 365 Copilotに取り込むための最も簡単なパスです。 ただし、一部の複雑なエンタープライズ シナリオでは、統合レイヤーを追加で制御する必要があります。 Microsoft 365 Agents Toolkit には、このような状況に対する代替アプローチが用意されています。

このユニットでは、エージェント ツールキットについて大まかに説明します。 詳細な説明については、最後のドキュメントへのリンクを参照してください。

注

このユニットでは、高度なトピックについて説明します。 Foundry エージェント統合を始める段階にある場合は、このユニットをスキップできます。Agents Toolkit アプローチを必要とするシナリオに遭遇した場合、後で戻ることができます。

Agents Toolkit を検討するタイミング

Microsoft 365 Agents Toolkit は、Visual Studio Code と Visual Studio の拡張機能として使用できる一連の開発ツールです。 エージェントで、既定の Entra ID セットアップを超えるカスタム シングル サインオン (SSO) 構成が必要な場合、または Teams と Foundry エージェントの間でカスタム処理、ログ記録、または変換のためのミドルウェア ロジックを追加する必要がある場合は、それを使用することを検討してください。

また、このツールキットは、開発、ステージング、運用の構成を分離した複数環境のデプロイを必要とする組織にも価値があります。 Foundry ポータルが提供する内容を超えた詳細なトレースを備えた高度なデバッグ機能を提供し、GitHub Actionsまたは Azure DevOps を介して CI/CD pipelinesと統合します。

Agents Toolkit のアプローチのしくみ

Foundry から直接発行する代わりに、Microsoft 365と Foundry エージェントの間に配置される Agents Toolkit を使用してプロキシ アプリケーションを作成します。

Teams/Copilot → Proxy App (Agents Toolkit) → Foundry Agent

このプロキシ アプリケーションは、Azure Bot Serviceを介して Teams または Copilot からメッセージを受信し、構成したカスタム ミドルウェアを介してメッセージを処理し、Foundry エージェントに要求を転送して、同じパスを介して応答を返します。 プロキシ アプローチを使用すると、メッセージ フローのすべてのステップを制御できますが、デプロイが複雑になります。

エージェント・ツールキットのはじめに

Agents Toolkit がシナリオに適している場合は、セットアップ プロセスの概要を次に示します。

まず、Visual Studio Code マーケットプレースから Microsoft 365 Agents Toolkit 拡張機能をインストールします。 インストールしたら、拡張機能パネルを開き、新しいエージェント/アプリの作成 を選択し、プロジェクトの種類として Custom Engine Agent を選択します。 ウィザードは、AIモデルのソースを含む構成オプションの設定を案内します。

プロジェクト テンプレートは、スタンドアロン エージェントのスキャフォールディングを作成します。 既存の Foundry エージェントに接続するには、Foundry エージェントのエンドポイントを呼び出すprojectを構成し、エージェントの資格情報を使用して認証を設定し、必要なミドルウェア ロジックを実装します。

Agents Toolkit には、Teams をシミュレートするローカル テスト環境である Microsoft 365 Agents Playground が含まれています。 デバッグ モードでprojectを実行して、ブラウザーでプレイグラウンドを開きます。ここで、テスト メッセージを送信して、接続が正しく動作することを確認できます。 テストが完了したら、ツールキットを使用してAzureリソースをプロビジョニングし、プロキシ アプリケーションをデプロイし、Teams に登録します。

比較の概要

アスペクト Foundry の直接公開 Agents Toolkit プロキシ
セットアップ時間 議事録 数時間から数日
コードが必要 None プロキシ アプリケーション
カスタマイズ 制限あり 広範囲
デバッグ Foundry ポータル 完全な IDE デバッグ
最適な用途 Standard デプロイ 複雑なエンタープライズ ニーズ

詳細情報

Agents Toolkit の詳細なガイダンスについては、以下を参照してください。

前のユニットで取り上げた直接発行アプローチは、統合シナリオの大部分を処理します。 エージェント ツールキットが対処する特定の要件を特定した状況に備えて、Agents Toolkit を予約します。