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 を使用します。 特定のイベントについては、「 TurnContext と ActivityHandler」を参照してください。
エージェントの構造を更新して、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の連携方法を理解しやすくなります。