C#、JavaScript、または Python を使用して構築し、Azure または別のホスティング インフラストラクチャでホストされているエージェントが、organization内に存在する場合があります。 これらのエージェントは、AI サービスを利用する特定の領域に焦点を当てた特殊なエクスペリエンスであり、Web またはカスタム アプリに既に統合されています。 Microsoft 365 Agents Toolkit を使用して、エージェントをMicrosoft 365 Copilot Chatで表示できます。 これにより、ユーザーは統合された Microsoft 365 Copilot UI を使用して、企業全体で構築されたエージェントと連携できるため、エージェントをより検出しやすく、ユーザーがアクセスできるようになります。
Microsoft 365 エージェント SDKを使用する
エージェントを Microsoft 365 Copilot に取り込むには、Microsoft 365 Agents Toolkit を使用して、エージェントをMicrosoft 365 エージェント SDKと統合します。 Agents SDK では、C#、JavaScript、Python がサポートされています。 エージェントがこれらの言語のいずれかで記述されている場合は、エージェントを大幅に変更する必要はありません。 エージェント SDK コードをエージェントに追加し、組み込みのチャネル アダプターを使用して、エージェントを Microsoft 365 Copilot にデプロイするだけです。
Microsoft 365 エージェント SDKの組み込みチャネル アダプターは、Microsoft 365 Copilot を含む多数のチャネルをサポートします。 既存のエージェントを Agents SDK でラップすることで、ユーザー画面またはチャネル (Microsoft 365 Copilot など) とコードの間にある Azure Bot Serviceと統合できます。 Azure Bot Serviceは、そのチャネルが送信するものを変換し、コードが理解しているものと一致するように一般的なアクティビティに変換します。この場合は、Azure Bot Serviceからの受信メッセージを受け入れる Agents SDK ラッパーです。
エージェントのコンポーネントを変更する
エージェントを Copilot に取り込むには、このセクションで説明されているように、エージェントの一部のコンポーネントを変更する必要があります。
Microsoft 365 エージェント ツールキットから開始し、Echo/Empty Agent サンプルを使用することをお勧めします (現在、Visual Studio の C# と Visual Studio Code の JavaScript で使用できます)。 エージェント SDK の構造を理解するには、エージェント ツールキットと SDK を使用してエージェントをテストしてデプロイする手順に従います。これらのツールを使用すると、説明されているタスクが簡略化されます。
アプリの登録と Azure Bot Service レコードを作成してチャネル通信を処理する - Microsoft 365 エージェント SDKでは、Azure Bot Serviceを使用してチャネルとコード間の通信を処理し、それらのチャネルに関連するコンポーネントを管理します。 エージェントで手動で参照するアプリ登録を使用して Azure Bot Service リソースを作成する必要があります。
エージェント イベント リスナーの構成 - Microsoft 365 エージェント SDKを使用して構築されたエージェントは、チャネルからイベントをリッスンするように構成されています 。この場合は、Microsoft 365 Copilot です。 開始するには、 OnActivity を使用します。
Microsoft 365 Copilot から Azure Bot Serviceに送信されたアクティビティを処理できるように、エージェントの構造を更新します。これを行うには、既存のエージェントを、Microsoft 365 エージェント SDKを使用してビルドされたエージェントの構造に追加します。 特に多くのアクティビティを呼び出す必要はありません。エージェントは、OnActivity メソッドを使用して、クライアントからのメッセージをリッスンできます。 その後、リッスンしているイベントからトリガーされるメソッドに既存のエージェントを追加または参照できるため、アクティビティが送信されるたびに実行されます。 アクティビティには、メッセージまたはチャネル内の別の種類のアクションを指定できます。
エージェント ツールキットを使用して、手動で作成するか 、マニフェスト ファイル を生成します。 Microsoft 365 Copilot には、マニフェスト ファイルを含む .zip パッケージが必要です。 マニフェスト ファイルには、エージェントを探す場所やその他の情報を Microsoft 365 Copilot に伝える一連の手順が含まれています。 Microsoft 365 Copilot では、エージェントをホストし、アプリ登録 (ID) を介してリンクされ、マニフェスト ファイルで参照されるエンドポイントが必要です。 エージェントが Teams で実行されている場合は、Microsoft 365 Copilot の最新のスキーマをサポートするように既存のマニフェスト ファイルを変更できます。
Microsoft 365 Copilot に接続されているエージェントは、必要に応じて、ユーザーに代わって行動するためのアクセス許可を要求できます。 この機能を使用する場合は、Azure Bot Serviceのエージェントのセットアップ プロセス中に構成します。 使い始めるツール
エージェントを Copilot に取り込む作業は、エージェントの複雑さと、エージェントがユーザーの ID を使用してその知識のスコープを設定できるようにするためにトークン管理を追加する必要があるかどうかによって異なります。
開始するには、Microsoft 365 Agents Toolkit と Echo Agent サンプルを使用してエージェントを作成し、 Visual Studio または Visual Studio Code のドキュメントに従ってテストしてデプロイします。 これは、エージェント ツールキット、エージェント SDK、Microsoft 365 Copilot の連携方法について理解するのに役立ちます。