Microsoft Graph コネクタ エクスペリエンス

Microsoft Graph コネクタは、外部サービスのコンテンツを Microsoft Graph とセマンティック検索インデックスに直感的に取り込む方法を提供し、一連の Microsoft 365 エクスペリエンスで外部データを検出できるようにします。

この記事では、Microsoft Graph コネクタで有効にできるエクスペリエンスと、それらのエクスペリエンスを有効にする要件について説明します。

これらのエクスペリエンスを有効にするには、まず基本的な Microsoft Graph コネクタを構築する必要があります。 接続を作成し、スキーマを登録し、正しいアクセス制御リストを使用して項目を取り込む方法の詳細については、「 Microsoft Graph コネクタ API の操作」を参照してください。

Microsoft Search

Microsoft Graph コネクタを使用した Microsoft Search を使用すると、Office.com、職場でのBing、SharePoint など、Microsoft Search エンドポイント内のユーザーに対してデータを検索できます。

Microsoft Search 用にコネクタを構成するには:

• セマンティック ラベルをスキーマに適用します。 セマンティック ラベルは、検索結果のランク付け、関連性、既定の表示テンプレートに役立ちます。
• スキーマにプロパティ属性を適用します。 プロパティ属性は、各プロパティの検索機能を決定します。
• 必要に応じて、接続を作成するときに searchSettings を追加して、検索結果のカスタム結果の種類を登録します。

Outlook on the web のコンテキスト IQ (プレビュー)

Microsoft Graph コネクタを備えた Outlook on the web のコンテキスト IQ を使用すると、ユーザーは Outlook on the web で電子メールを作成しているときに、サードパーティのデータからコンテンツ内の提案を見つけることができます。 Context IQ を使用するエディターは、ユーザーが電子メール内でアダプティブ カードとして選択して埋め込むことができる、関連するユーザー、ファイル、Microsoft Graph コネクタ コンテンツを表示します。 ユーザーは、Outlook on the Web メールに "/" を挿入し、キーワードを入力することで、この機能にアクセスできます。 Outlook では、入力されたコンテキストに基づいて、電子メールの本文に挿入できる関連する提案が表示されます。

Context IQ 用にコネクタを構成するには:

• スキーマに次のセマンティック ラベルを適用します。title、url、iconUrl。 これらのラベルは、エクスペリエンスに表示されるプロパティを決定します。
• アイテムにユーザー アクティビティを追加します。 サポートされているアクティビティの種類については、「 externalActivity」を参照してください。 プラットフォームでは、これらのアクティビティを使用して、どのユーザーが最近どのアイテムと対話したかを判断します。 特定のユーザーによって実行されたアクティビティを持つアイテムは、エクスペリエンスでそのユーザーに表示される可能性が高くなります。
• 接続を作成するときに activitySettings に urlToItemResolver を追加します。 urlToItemResolverを使用すると、ユーザーが外部コンテンツの URL を互いに共有するときにプラットフォームが認識できるようになります。 このエクスペリエンスでは、そのユーザーと共有されているコンテンツを表示する可能性が高くなります。

Microsoft 365 用の Copilot

Microsoft Graph コネクタを備えた Microsoft 365 用 Microsoft Copilot を使用すると、ユーザーは、ユーザーの自然言語プロンプトに関連するすべてのコンテンツに関する重要な詳細を簡単に見つけ、要約し、学習できます。

Microsoft 365 用 Copilot でコンテンツが効果的に使用されるようにするには、次の手順を実行します。

• セマンティック ラベルを適用します。 セマンティック ラベルは、Copilot for Microsoft 365 でスキーマのセマンティックな意味を解釈するのに役立ちます。 必要に応じて、それらの多くをスキーマに適用します。 Copilot でコンテンツを表示するには、 iconUrl、 title、および url ラベルを適用する必要があります。 現時点では、Copilot for Microsoft 365 のプロンプトでは、 title セマンティック ラベルのみを使用できます。ただし、プラットフォームの進化に伴い、より多くのセマンティック ラベルがサポートされます。 該当するすべてのラベルを適用する場合、今後スキーマを再作成する必要はありません。

• 外部アイテムに関連するコンテンツをテキストとして取り込みます。 ユーザーは、Copilot for Microsoft 365 の外部アイテムの content プロパティに対してクエリを実行できます。 Microsoft 365 用 Copilot は、コンテンツが豊富なアイテムに対して優れたパフォーマンスを発揮します。

• 検索可能なプロパティ ラベルを、Copilot でユーザーのプロンプトと照合する格納されたコンテンツを含むスキーマ プロパティに適用します。 searchable ラベルは、検索できるスキーマ プロパティを定義するため、Copilot に関して最も重要です。

• 接続を作成するときに activitySettings に urlToItemResolver を追加します。 urlToItemResolver を使用すると、ユーザーが外部コンテンツの URL を互いに共有するタイミングをプラットフォームで検出できます。 Microsoft 365 用 Copilot は、そのユーザーと共有されているコンテンツを表示する可能性が高くなります。

• アイテムにユーザー アクティビティを追加します。 サポートされているアクティビティの種類の一覧については、「 externalActivity」を参照してください。 より多くのアクティビティを持つ項目は、重要度が高くなります。

• 接続の作成時に description プロパティにわかりやすい説明を指定します。 豊富な説明により、Copilot でコンテンツが表示される可能性が向上します。 接続の説明は、次の質問に簡単に答える必要があります。

  • この接続にはどのようなコンテンツがありますか?
  • ユーザーは、それぞれの組織でこのコンテンツ ソースをどのように参照しますか?
  • ワークフローのどのような部分で、ユーザーは日常業務でこのコンテンツを参照していますか?
  • コンテンツの特徴は何ですか?

さらに、検索管理者は、次の手順を使用して、Microsoft Graph コネクタ接続が インライン結果 に対して有効になっていることを確認する必要があります。

• 管理センターを開き、[ Search & intelligence>Customizations>Verticals に移動し、[ すべての 垂直] を選択します。
• [ コネクタの結果の管理] を選択します。 [結果をインラインで表示する] が選択されていること、および [検索] と [Copilot] で有効にする接続がオンになっていることを確認します。

Microsoft 365 アプリ

Microsoft Graph コネクタを備えた Microsoft 365 アプリを使用すると、クイック アクセスとマイ コンテンツの下の microsoft365.com からデータを検出できます。 これにより、ユーザーは重要なすべてのコンテンツを 1 か所で見つけることができます。

Microsoft 365 アプリのコネクタを構成するには:

• スキーマに次のセマンティック ラベルを適用します。title、url、iconUrl。 これらのラベルは、エクスペリエンスに表示されるプロパティを決定します。
• アイテムにユーザー アクティビティを追加します。 または、サポートされているアクティビティの種類の一覧については、「 externalActivity」を参照してください。 これらのアクティビティは、ユーザーがどの項目と最近対話したプラットフォームを示します。 特定のユーザーによって実行されたアクティビティを持つアイテムは、エクスペリエンスでそのユーザーに表示される可能性が高くなります。
• 接続を作成するときに activitySettings に urlToItemResolver を追加します。 urlToItemResolverを使用すると、ユーザーが外部コンテンツの URL を互いに共有するタイミングをプラットフォームで検出できます。 このエクスペリエンスでは、そのユーザーと共有されているコンテンツを表示する可能性が高くなります。