ヒント
推奨事項: サポートされているプロコード宣言型エージェントとプラグイン シナリオ用の Work IQ 開発ツール から始めます。 WIQD クイックスタートを参照してください。 Toolkit ベースの手順は、それらを必要とする既存のプロジェクトおよびワークフローで引き続き使用できます。 ツールを選択する前に 、機能とターゲット エクスペリエンスのサポート を確認します。WIQD はカスタム エンジン エージェントを対象としません。
このチュートリアルでは、Toolkit の同期コネクタ テンプレートが保持されます。 WIQD プラグインで使用されるリモート MCP コネクタ構成ではなく、インジェスト サービスを構築します。
Microsoft 365 Copilot コネクタを使用すると、基幹業務データを Microsoft Graph に取り込んで、Microsoft 365 Copilot で利用できるようになります。 データが取り込まれると、Copilot はデータに基づいて推論し、それを使用してユーザーのプロンプトに応答できます。
このチュートリアルでは、Microsoft 365 Copilot プラグインのコンポーネントとして外部データ アクセスを提供できる同期された Copilot コネクタを作成します。 完全なプラグインを作成またはパッケージ化するものではありません。
Microsoft 365 Agents Toolkit には、Copilot コネクタの構築に使用できるテンプレートが含まれています。 Copilot コネクタ テンプレートは、Microsoft Graph で Copilot コネクタ API を使用してコネクタをすばやく構築できるように設計されています。 テンプレートは、GitHub API から Microsoft Graph にデータをプルするコネクタをスキャフォールディングします。 コネクタを構築したら、F5 エクスペリエンスを使用してローカルで実行することも、Azure Functions を介してデプロイすることもできます。
この記事では、Visual Studio Code で Microsoft 365 Agents Toolkit を使用して最初の Copilot コネクタを構築する手順のチュートリアルを提供します。
開始する前に、コンポーネント計画で同期されたコネクタが適切なモデルとして識別されていること、および Microsoft 365 Agents Toolkit がターゲット エクスペリエンスをサポートしていることを確認します。 計画のガイダンスについては、「 プラグイン機能としてのコネクタ」を参照してください。
注
このチュートリアルでは、同期コネクタを構築します。 フェデレーション コネクタ、MCP プラグイン、MCP サーバー、またはエージェント コネクタは構築されません。
ビルドする内容
このチュートリアルでは、Agents Toolkit は、GitHub の問題を取得する同期されたコネクタ実装のスキャフォールディングを行います。 プロジェクトを実行すると、ツールキットによって Microsoft Entra アプリケーションがプロビジョニングされ、Microsoft Graph で外部接続とスキーマが作成され、構成された GitHub リポジトリから外部アイテムが取り込まれます。
コネクタはソリューションの 1 つのコンポーネントです。 追加のプラグイン コンポーネントを個別に完成させ、コンポーネントを統合してテストします。
前提条件
この記事の手順を完了するには、次の前提条件を満たす必要があります。
Node.js、サポートされているバージョン: 18、20、22
カスタム アプリのアップロードが有効になっているMicrosoft 365 Copilot ライセンスまたは Microsoft 365 開発者テナント。
注
Microsoft 365 Copilot Chat でコネクタをテストするには、Microsoft 365 Copilot ライセンスが必要です。
Microsoft Entra 管理センターで管理者の同意を管理できる必要があります。 この手順は、グローバル管理者であるか、または完了する必要があります。 「必要なロールの アプリケーションにテナント全体の管理者の同意を付与 する」を参照してください。
Microsoft 365 管理センターでコネクタを表示するには、ユーザーに検索管理者、クラウド アプリケーション開発者のロールが必要です。
最初のカスタム コネクタの構築
次の手順を使用して、最初のコネクタを作成します。
Visual Studio Code のサイドバーで、[ Microsoft 365 Agents Toolkit] を選択し > 新しいエージェント/アプリを作成します。
Copilot コネクタを選択します。
コネクタ名として「
Github Issues」と入力します。コネクタのテナント全体の一意の ID を作成します。 コネクタ ID の要件の詳細については、 externalConnection リソースの id プロパティを参照してください。
[ 既定のフォルダー ] を選択して、プロジェクトのルート フォルダーを既定の場所に保存します。
.env.localファイルのCONNECTOR_REPOSフィールドを使用して、課題を取得するリポジトリを構成します。
F5 キーを押してコネクタをローカルで実行します。 ツールキットはコネクタ用の Microsoft Entra アプリを作成し、プロビジョニング プロセスを開始します。
ターミナルのリンクに従って Microsoft Entra 管理センターに移動し、[管理者の同意の付与] を選択します。
注
この手順を完了するには、organization のグローバル管理である必要があります。
アプリは接続を作成し、スキーマを登録してから、項目を取り込むための完全クロールを実行します。
注
スキーマの登録には、最大で 10 分かかる場合があります。
完全なクロールが完了すると、Microsoft 365 管理センターで次の手順を実行します。
左側のウィンドウで、[設定]>[検索]、[インテリジェンス]&>[データ ソース] に移動します。
接続 ID を見つけます。
[ コネクタの結果を含める] を選択します。
注
この手順を完了するには、検索管理である必要があります。この手順により、コネクタからの結果を Microsoft 365 Copilot Chat で使用できるようになります。 このコネクタを 宣言型エージェントのナレッジ ソースとしてのみ使用する場合、この手順は必要ありません。
ヒント
管理センターではなく、プログラムで接続 ID を検索する必要がある場合は、
ExternalConnection.Read.Allスコープを使用して Graph エクスプローラー で既存のコネクタに対してクエリを実行できます。アイテムにインデックスが作成されていることを確認するには、関連するコネクタ名を選択します。 [ インデックス付きアイテム] フィールドで、インデックスが作成された課題の数を確認します。
Microsoft 365 Copilot Chat を開き、「最新の 2 つの GitHub の問題は何ですか?」などのサンプル プロンプトをテストします。 ページの下部にある外部アイテムの引用に注目してください。 これらの引用は、Copilot コネクタからのデータです。
このテストでは、コネクタが独立して動作することを確認します。 これは、完全なプラグイン パッケージを検証したり、コネクタが他のプラグイン コンポーネントと連携して動作したりすることはありません。
データ ソースに合わせてテンプレートをカスタマイズする
カスタム データ用にこのテンプレートをカスタマイズするには、次のフォルダーのコンテンツを更新します。
src/custom: Microsoft Graph に取り込まれるデータを収集および変換するためのカスタム コードが含まれています。 この例では GitHub issues API を使用していますが、他の API に置き換えることができます。src/references: コネクタのスキーマ定義が含まれます。 取り込むデータとメタデータに合わせて調整します。src/models: データとコンフィギュレーションの内部表現のモデル定義が含まれています。 どちらのモデルもニーズに合わせてカスタマイズできます。
これらのフォルダーに加えて、シナリオに応じて、コードの他の部分をカスタマイズできます。
[Customization point] 文字列で始まるコメントをコードで検索できます。 これらのコメントは、カスタマイズの可能性がある領域を示しています。
次のステップ
コネクタ統合チェックを使用して、認証、スキーマ、インデックス作成、鮮度、およびアクセス許可を確認します。 期限切れの認証、拒否されたアクセス、使用できない接続またはデータ ソースの失敗テストと 境界テスト を含めます。
接続 ID、スキーマ、環境、アクセス許可、テスト証拠、コネクタ所有者を実装レコードに記録します。 プラグインに他のコンポーネントが含まれている場合は、 プラグインコンポーネントを統合してテストする前にそれらをビルドします。