Guru Microsoft 365 Copilot コネクタは、Guru コンテンツを Microsoft 365 に統合し、Copilot、Copilot Search、Microsoft Search を使用して、Teams、Outlook、SharePoint などのアプリ内で関連する Guru Card を直接表示できるようにします。 この記事では、Guru コネクタをデプロイしてカスタマイズする手順について説明します。
前提条件
Guru コネクタをデプロイする前に、次の前提条件を満たしていることを確認してください。
- organizationの Microsoft 365 テナントの検索管理者である必要があります。
- Guru Instance 管理 アカウント: Guru インスタンスに接続し、Guru Microsoft 365 Copilot コネクタが Guru カードを定期的に更新できるようにするには、ユーザー トークンを作成するためのアクセス許可を持つ Guru インスタンスの管理者ユーザー アカウントが必要です。 詳細については 、こちらを参照してください。
コネクタをデプロイする
organizationの Guru コネクタを追加するには:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
- [ コネクタ ] タブに移動し、左側のウィンドウで [ ギャラリー] を選択します。
- 使用可能なコネクタの一覧から [ 教師] を選択します。
表示名を設定する
表示名は、関連付けられたファイルまたはアイテムをユーザーが認識するのに役立つ Copilot 応答の参照を識別するために使用されます。 表示名は信頼されたコンテンツも示し、コンテンツ ソース フィルターとして使用されます。 既定の Guru 表示名をそのまま使用するか、値をカスタマイズして、organizationのユーザーが認識する表示名を使用できます。
コネクタの表示名と説明の詳細については、「 コネクタ コンテンツの Copilot 検出を強化する」を参照してください。
インスタンス URL の設定
Guru インスタンスの URL を指定します。 一般的な構造体https://app.getguru.com/、その後にorganizationのインスタンス識別子が続きます。
認証の種類を選択する
Guru コネクタでは、ユーザー トークンを使用した基本認証がサポートされています。 Guru 管理者アカウントを使用してユーザー トークンを生成することをお勧めします。 詳細については、 Guru API のドキュメントを参照してください。
ロールアウト
制限付き対象ユーザーにロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーとグループを指定します。 詳細については、「 Copilot コネクタの段階的ロールアウト」を参照してください。
[ 作成] を 選択して接続をデプロイします。 Guru Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。
次の表に、設定される既定値を示します。
| カテゴリ | 既定値 |
|---|---|
| ユーザー | このデータ ソースにアクセスできるユーザーのみ。 |
| ユーザー | Microsoft Entra ID を使用してマップされたデータ ソース ID。 |
| コンテンツ | 個人用スペースのカードを除くすべてのカード。 |
| コンテンツ | 既定のプロパティとそのスキーマをチェックするには、「プロパティの管理」を参照してください。 |
| 同期 | 増分クロール: 15 分ごと。 |
| 同期 | フル クロール: 毎日。 |
これらの値をカスタマイズするには、[ カスタム セットアップ] を選択します。 詳細については、「設定の カスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。
設定のカスタマイズ (省略可能)
Guru コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクタ ページで [ カスタム セットアップ] を選択します。
ユーザー設定をカスタマイズする
アクセス許可
Guru コネクタでは、アクセス許可の 2 つのオプションがサポートされています。
- すべてのユーザー: すべてのユーザーの検索結果にインデックス付きデータが表示されます。
- このデータ ソースへのアクセス権を持つユーザー ( 既定値): Guru でアクセスできるユーザーのみがコンテンツを表示できます。
[このデータ ソースへのアクセス権を持つユーザーのみ] を選択した場合は、Guru インスタンスにプロビジョニングされたユーザーと Entra 以外の ID ユーザー Microsoft Entra IDするかどうかを選択する必要があります。
- Guru ユーザーのメール ID が、Microsoft Entra IDのユーザーのユーザー プリンシパル名 (UPN) と同じである場合は、Microsoft Entra ID オプションを選択します。
- Guru ユーザーのメール ID が Entra ID のユーザーの UPN と異なる場合は、非 Entra ID オプションを選択します。
ID ソースとしてMicrosoft Entra IDを選択した場合、コネクタは Guru のユーザー電子メール ID をMicrosoft Entra IDの UPN プロパティにマップします。 ID ソースとして非 Entra ID を選択する場合は、電子メール ID を UPN にマップする正規表現を指定します。 詳細については、「 Entra 以外の ID をマップする」を参照してください。
注:
アクセス許可を管理するユーザーまたはグループへのUpdatesは、フル クロールでのみ同期されます。 増分クロールでは、現在、アクセス許可の更新の処理はサポートされていません。
コンテンツ設定をカスタマイズする
含まれるデータと除外されるデータをカスタマイズし、既定のコネクタ プロパティをカスタマイズできます。
コンテンツ インジェスト フィルター
インデックスを作成するデータを選択できます。 Guru Query Language (GQL) を使用して、インデックスを作成する前にデータをフィルター処理し、検索可能なデータを制御できます。 たとえば、GQL フィルターを使用して、 lastModified > 2016-01-01T00:00:00.000-00:00を使用して、一定時間後に変更されたコンテンツにインデックスを付ける場合があります。
詳細については、「 Guru Query Language」を参照してください。
プレビュー結果ボタンを使用して、選択したプロパティとフィルターのサンプル値を確認します。
プロパティの管理
Guru インスタンスから使用可能なプロパティをチェックできます。 プロパティにスキーマを割り当てる (プロパティが検索可能、クエリ可能、取得可能、またはリファイン可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加します。 次の表は、コネクタが既定でインデックスを作成するプロパティの一覧です。
| 既定のプロパティ | セマンティック ラベル | 説明 | Schema |
|---|---|---|---|
| タイトル | title | カードのタイトル | クエリ、検索、取得 |
| リンク | URL | アイテムの URL | 取り戻す |
| CreatedTime | createdDateTime | カードが作成された日時 | クエリ、取得 |
| ModifiedTime | lastModifiedDateTime | カードが最後に更新された日時 | クエリ、取得、絞り込み |
| Owner | createdBy | カードの所有者 | クエリ、検索、取得 |
| LastModifiedBy | lastModifiedBy | カードを最後に変更したユーザーの名前 | クエリ、検索、取得 |
| コレクション | containerName | カードが属するコレクションの名前 | クエリ、検索、取得 |
| CollectionUrl | containerUrl | カードが属するコレクションの URL | 取り戻す |
| コンテンツ | content | ページのレンダリングされた HTML コンテンツ | クエリ、検索 |
同期間隔をカスタマイズする
更新間隔は、データ ソースと Guru コネクタ インデックスの間でデータを同期する頻度を決定します。 Copilot コネクタでは、次の 2 種類の更新間隔が使用されます。
- フル クロール: 既定値は毎日です。
- 増分クロール: 既定値は 15 分ごとです。
更新間隔の既定値を変更できます。 詳細については、「 同期設定のガイドライン」を参照してください。