Microsoft Graph コネクタ SDK の概要

  • [アーティクル]

Microsoft Graph コネクタ SDK を使用すると、事前構築済みのコネクタを持たないが、Microsoft Graph にインデックスを作成するデータ ソースの高品質で効率的で回復力のあるコネクタを構築するプロセスが簡素化されます。

SDK には、コードとコードをテストするためのツールを記述するのに役立つフレームワークとコントラクト コンポーネントが含まれています。

コネクタ SDK を使用すると、Visual Studio 統合開発環境 (IDE) 内にカスタム Microsoft Graph コネクタを直接作成できます。 カスタム コネクタをビルド、デバッグ、デプロイするために必要なすべての機能が提供されます。

SDK で構築された接続を介して取り込まれたアイテムは、アイテム クォータを消費します。 持っているアイテム クォータの量と、より多くのクォータを購入する方法の詳細については、「 ライセンス要件と価格」を参照してください。

コンポーネント

コネクタ SDK には、次のコンポーネントが含まれています。

  • カスタム コネクタ テンプレート: C# でカスタム コネクタを開発する場合は、Visual Studio Marketplace からテンプレートをダウンロードしてすぐに開始できます。 この 一覧の任意の言語でカスタム コネクタを開発することもできます。

  • コントラクト: コントラクトは、Microsoft プラットフォーム (Microsoft Graph コネクタ エージェント) とカスタム コネクタ コード間の対話のためのコントラクトを含む gRPC プロトコル バッファー ファイルです。

  • Microsoft Graph コネクタ エージェント: Microsoft 365 管理センターとカスタム コネクタ コード間のコネクタ機能と座標を管理する軽量ソフトウェア コンポーネント。

    最新バージョンのコネクタ エージェントをダウンロードし、インストール構成アシスタントを実行します。 詳細については、「 Microsoft Graph コネクタ エージェント」を参照してください。

  • コネクタ SDK テスト ユーティリティ: カスタム コネクタ コードをテストし、コネクタ エージェント プラットフォームと通信するために使用できる事前構築済みのテスト シナリオが含まれています。

Microsoft Graph コネクタ エージェントの機能

コネクタ エージェントは、Microsoft 組み込みコネクタの実行に使用されるのと同じ堅牢な コネクタ プラットフォーム上に構築されています。

これには、次の機能が含まれています。

  • コネクタからデータを取得する: エージェントはカスタム コネクタに接続し、コネクタによって実装されたロジックを使用してソースからデータを取得できます。

  • Microsoft 365 管理センター統合: エージェントを使用すると、Microsoft 365 管理センターを使用してカスタム コネクタを構成、管理、監視できます。

  • クロールのスケジュールと管理: エージェントは、フル クロールと増分クロールを通じてデータ ソースをクロールできます。 フル クロール (リスト ベースまたは Microsoft Graph ベース) は、ユーザーが定義した間隔でデータ全体を定期的に通過します。 増分クロールは頻度が高く、ユーザーが定義した間隔で前のタイムスタンプ/チェックポイントからデータ ソースをクロールします。

  • 削除、差分、およびサイクル検出: エージェントは、定期的なフル クロール中にコネクタによって送信されたアイテムに基づいて、データ ソースから削除されたアイテムを検出できます。 エージェントは、Microsoft インデックスからアイテムを削除する処理も行います。

    エージェントは、アイテムのハッシュを計算し、以前に見たアイテムのハッシュと比較することで、前回のクロール以降に変更されたアイテムも検出します。 クロールを高速化するために、エージェントは、アイテムが変更されたときにのみインデックスが作成されるデータを送信します。

    また、エージェントは、リンクされたアイテム (Web サイトなど) を持つデータ ソースから発生する重複アイテムも検出し、これらのアイテムのクロールをスキップします。

  • ID マッピング: コネクタ エージェントを使用すると、データのAccess Control Lists (ACL) のスタンプを有効にして、セキュリティ トリミングを有効にします。 データ ソースからのMicrosoft Entra IDまたは ACL に基づいてセキュリティ トリミングを有効にすることができます。

  • Microsoft Graph インジェスト: エージェントは、カスタム コネクタからデータを受信した後、Microsoft Graph にデータを取り込みます。

注:

現在、次の機能は使用できません。

  • クロール中のグラフ ベースのデータ ソース トラバーサル。たとえば、フォルダー構造を走査する場合などです。
  • データ ソースからのアクセス制御に基づいて検索アクセス許可を管理する機能。

C# では 、サンプル コネクタ を使用するか、 GitHub の Microsoft Graph コネクタ SDK ページのコントラクトを使用して、サポートされているその他の言語で作業を開始できます。

次の手順