Confluence オンプレミス Microsoft 365 Copilot コネクタを使用すると、organizationで Confluence サーバーまたはデータ センターのコンテンツのインデックスを作成できます。 Confluence サイトからコネクタとインデックス データを構成した後、エンド ユーザーは Microsoft Search でそのコンテンツを検索し、Microsoft 365 Copilotできます。
この記事は、Confluence オンプレミス Copilot コネクタの構成、実行、監視を担当する Microsoft 365 管理者を対象としています。 これは、Microsoft 365 管理センターでMicrosoft Copilotコネクタを設定するために提供される一般的な手順を補完します。
機能
- 強化された検索機能を使用して、アーキテクチャ ドキュメントの概要やポータルへのアクセス方法など、Copilot の Wiki コンテンツに関する自然言語の質問をします。
- セマンティック検索のサポートを使用して、正確な応答を得るための自然言語クエリを実行します。
- 互換性のために 8.0 を超える Confluence バージョンをサポートします。
制限事項
- ブログ、添付ファイル、コメントのインデックスを作成しません。
- 現在のページにのみインデックスを作成します。アーカイブされたページは除外されます。
- CQL (Confluence クエリ言語) は、オンプレミスの Confluence ではサポートされていません。ただし、領域とページ レベルのフィルターがサポートされています。
前提条件
- GCA [Graph コネクタ エージェント] をインストールする: GCA が、Confluence URL からアクセス可能なデータ ソースと同じネットワーク内の Windows マシンにインストールされていることを確認します。 Graph コネクタ エージェントの詳細については、以下を参照してください。
- プラグインのインストール: Confluence のセットアップで Atlassian Marketplace から Confluence on-prem プラグインをダウンロードしてインストールします。 Confluence On-prem Plugin for Copilot コネクタからプラグインを取得する |Atlassian Marketplace。
- プラグインを検証する: [管理>管理アプリ ] に移動し、アプリの種類のフィルターを [システム] に設定し、 Confluence Mobile Web プラグイン がインストールされ、有効になっていることを確認します。 このプラグインは既定でインストールされ、有効になっています。
- プラグインがインストールされていない場合は、 Confluence Data Center 用モバイル プラグインからプラグインを 取得してインストールします。
- プラグインがインストールされていても無効になっている場合は、有効にします。
- 認証: 適切なアクセス権を持つ認証資格情報があることを確認します。
重要
推奨: Confluence グローバル管理者は接続を作成する必要があります
Confluence グローバル管理者は誰ですか? Confluence 管理者は、完全な管理アクセス許可を持つユーザーです。
- アクセス許可をチェックするには:管理>全般構成>グローバルアクセス許可に移動します
- 使用できる、個人用スペース、スペースの作成、 Confluence 管理者、システム管理者など、すべてのアクセス許可が有効になっているグループ Confluence-administrators を探します。
- トークンを作成するすべてのユーザーは、このグループのメンバーである必要があります。
作業の開始
1. 表示名
表示名は、Copilot の各参照を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。 表示名は、信頼されたコンテンツも示します。 表示名は、 コンテンツ ソース フィルターとしても使用されます。 このフィールドには既定値が存在しますが、organizationのユーザーが認識する名前にカスタマイズできます。
2. Confluence オンプレミス URL
Confluence オンプレミス データに接続するには、organizationの Confluence インスタンス URL が必要です。 organizationの Confluence インスタンス URL は、通常は 'https://contoso.atlassian.net' のようになります。
3. Graph コネクタ エージェント (GCA)
Confluence サーバーまたはデータ センターのコンテンツのインデックスを作成するには、コネクタ エージェントをインストールして登録する必要があります。 詳細については、「 Graph コネクタ エージェントのインストール 」を参照してください。 organizationの Microsoft 365 テナントの管理者と、organizationの Confluence サイトの管理者である必要があります。
注:
GCA は別の Windows マシンにインストールでき、オンプレミス サーバーと同じコンピューター上にインストールする必要はありません。 マシンは、セットアップに使用できるアプリ ID とシークレットの生成に役立ちます。 クロール中に GCA マシンがオンになっていることを確認する必要があります。 一般的な GCA 関連の質問に対する回答については、「 FAQ」セクションを参照してください。
4. Confluence オンプレミス プラグインをインストールする
Copilot コネクタ Confluence On-prem プラグインがインストールされていることを確認します。 Confluence Copilot コネクタごとにプラグインをインストールする必要はありません。Confluence インスタンスに既にインストールされている場合は、以降の Confluence on-prem 接続に対してこの手順をスキップできます。
- Copilot コネクタ Confluence On-prem プラグインからアプリをダウンロードする |Atlassian Marketplace。
- Confluence システムにログインします。
-
[設定>管理アプリ] に移動します。
- [ アプリのアップロード] をクリックします。
- ダウンロードしたファイルを選択して続行します。
注:
プラグインは、8.0 より上の Confluence バージョンでサポートされています。
5. 認証の種類
Confluence On-prem からコンテンツを認証して同期するには、サポートされている 3 つの方法のいずれかを 選択します。
a. 基本認証
インスタンスに対して認証するには、Confluence アカウントのユーザー名とパスワードを入力します。
b. OAuth1.0a
公開キーと秘密キーのペアを生成し、コネクタ エージェントがインスタンスにアクセスできるように、Confluence オンプレミス サイトにアプリケーション リンクを作成します。 詳細については、 Atlassian 開発者向けドキュメントの手順 1 を参照してください。
c. OAuth 2.0 (推奨)
次の手順では、アプリを登録する方法に関するガイダンス を提供します 受信リンクを構成します。
- [管理>全般構成>アプリケーション リンク] に移動します。
- [ 作成] リンクを選択します。
- [ 外部アプリケーション] を選択し、方向として [ 受信 ] を選択します。
- スコープとして [管理] を選択します。
- リダイレクト URL:
https://gcs.office.com/v1.0/admin/oauth/callbackを入力します。
6. 限定対象ユーザーへのロールアウト
ロールアウトを広範な対象ユーザーに展開する前に、Copilot やその他の Search サーフェスで検証する場合は、制限付きユーザー ベースにこの接続をデプロイします。 詳細については、「Microsoft 365 Copilot コネクタの段階的ロールアウト」を参照してください。
この時点で、Confluence の接続を作成する準備ができました。 [作成] ボタンをクリックすると、Microsoft Graph コネクタが Confluence アカウントからインデックス作成ページを開始します。
アクセス許可、データ包含ルール、スキーマ、クロール頻度などのその他の設定の場合。 Confluence データで最適に動作するものに基づいて既定値を設定します。 既定値は次のとおりです。
| Users | |
|---|---|
| アクセス許可 | データ ソース内のコンテンツにアクセスできるユーザーのみ。 |
| ID のマップ | Microsoft Entra ID を使用してマップされたデータ ソース ID。 |
| Content | |
|---|---|
| スペースを含める/除外する | All |
| プロパティの管理 | 既定のプロパティとそのスキーマをチェックするには、ここをクリックします |
| 同期 | |
|---|---|
| 増分クロール | 頻度: 15 分ごと |
| フル クロール | 頻度: 毎日 |
これらの値のいずれかを編集する場合は、 Custom Setup オプションを選択する必要があります。
カスタム セットアップ
カスタムセットアップは、既定の表に一覧表示されている設定の既定値を編集する管理者向けです。 [カスタム セットアップ] オプションをクリックすると、[ユーザー]、[コンテンツ]、[同期] の 3 つのタブが表示されます。
ユーザー
アクセス許可
Confluence オンプレミス Copilot コネクタでは、このデータ ソースへのアクセス権を持つすべてのユーザーまたはユーザーにのみ表示される検索アクセス許可がサポートされています。 [すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。 Confluence オンプレミスでは、ユーザーとグループのセキュリティアクセス許可は、スペースのアクセス許可とページ制限を使用して定義されます。 アクセス許可の評価は、次の規則に従います。
- ページ レベルの制限からアクセス許可の構成を取得します。
- 親ページの制限からアクセス許可の構成を取得します。
- 領域のアクセス許可からアクセス許可の構成を取得します。
- 上記の 3 つの構成の積集合を計算して、ページの最終的な有効なアクセス許可を決定します。 この最終的なアクセス許可セットは、Microsoft 365 Copilotに同期されます
重要
スペース レベルで定義された匿名アクセス設定は、この評価では考慮されません。
[このデータ ソースへのアクセス権を持つユーザーのみ] を選択した場合は、Confluence サイトにプロビジョニングされたユーザーと AAD 以外のユーザー Microsoft Entra IDするかどうかをさらに選択する必要があります。
organizationに適したオプションを特定するには:
- Confluence ユーザーの電子メール ID が、Microsoft Entra IDのユーザーの UserPrincipalName (UPN) と同じである場合は、Microsoft Entra ID オプションを選択します。
- Confluence ユーザーのメール ID が、Microsoft Entra IDのユーザーの UserPrincipalName (UPN) と異なる場合は、AAD 以外のオプションを選択します。
重要
- id ソースの種類としてMicrosoft Entra IDを選択した場合、コネクタは Confluence から直接取得したユーザーの電子メール ID を、Microsoft Entra IDから UPN プロパティにマップします。
- ID の種類に "非 AAD" を選択した場合は、ID のマッピング手順については、「 Azure 以外の AD ID を マップする」を参照してください。 このオプションを使用して、メール ID から UPN へのマッピング正規表現を指定できます。
- アクセス許可を管理するユーザーまたはグループへのUpdatesは、フル クロールでのみ同期されます。 増分クロールでは、現在、アクセス許可に対する更新プログラムの処理はサポートされていません。
コンテンツ
インデックスを作成するデータを含めるか除外する
この手順では、Confluence データ ソースから使用可能なプロパティを追加または削除できます。 Microsoft 365 では、いくつかのプロパティが選択されます。 既定では、コネクタはすべてのスペースにインデックスを付けます。 ただし、スペース フィルター オプションを使用して、特定のスペースを含めるか除外するかを選択できます。
含めるか除外するスペース キーの一覧を入力すると、結果のプレビューが表示されます。 「スペース キー」と入力します。各 Confluence スペースにはスペース キーがあります。これは、そのスペースの URL の一部を形成する短い一意の識別子です。 スペース キーを取得するには、Confluence 管理者にお問い合わせください。詳細については、「スペース キー」を参照してください。
ページ フィルター
この手順では、ドキュメントのインデックス作成の日付範囲を指定できます。 パラメーターは次のとおりです。
- 最終作成日: ドキュメントが作成された日付。 この日付以降に変更されたドキュメントのみがインデックス付けされます。
- 最終更新日: ドキュメントが変更された日付。 この日付以降に変更されたドキュメントのみがインデックス付けされます。
重要
- 日付が時系列で表示されていることを確認します。 "最終作成日" は、"最終変更日" より後に指定しないでください。
- 日付が指定されていない場合、すべてのドキュメントがインデックス作成と見なされます。
プロパティの管理
Confluence On-prem データ ソースから使用可能なプロパティを追加または削除します。 プロパティにスキーマを割り当てます (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義します)。 さらに、セマンティック ラベルを変更し、プロパティにエイリアスを追加することもできます。 既定のプロパティは次のとおりです。
| Source プロパティ | Label | Schema |
|---|---|---|
| 設定元 | authors | クエリ、取得 |
| コンテンツ | 検索 | |
| CreatedByName | 作成者 | 検索、クエリ、取得 |
| CreatedOn | 作成日時 | クエリ、取得 |
| Id | クエリ、取得 | |
| PageTree | 取り戻す | |
| SpaceName | 検索、クエリ、取得 | |
| タイトル | title | 検索、取得 |
| UpdatedByName | lastModifiedBy | 取り戻す |
| UpdatedOn | lastModifiedDateTime | クエリ、取得、絞り込み |
| URL | url | 取り戻す |
データのプレビュー
プレビュー結果に移動して、選択したプロパティとフィルターを表示します。
注:
プレビューでは、スペース レベルのフィルター処理のみが考慮されます。
同期
更新間隔は、データ ソースと Copilot コネクタ インデックスの間でデータを同期する頻度を決定します。 更新間隔には、フル クロールと増分クロールの 2 種類があります。 詳細については、こちらをクリック してください。 必要に応じて、ここから更新間隔の既定値を変更できます。
接続を確認してテストする
- テストでは、 限定された対象ユーザーに発行を選択できます。
- インデックス付きコンテンツとアクセス許可を検索し、 インデックス ブラウザーを使用して検証します。
- よくある質問に対する回答については、「 FAQ」セクションを参照してください。
Microsoft Search の場合、検索結果ページをカスタマイズする必要がある場合。 検索結果のカスタマイズについては、「検索結果 のカスタマイズ」ページを参照してください。
トラブルシューティング
接続を公開したら、管理センターの [データ ソース] タブの状態を確認できます。 更新と削除を行う方法については、「接続を監視する」をご覧ください。 詳細については、「 Confluence オンプレミス Copilot コネクタのトラブルシューティング」を参照してください。
問題がある場合、またはフィードバックを提供する場合は、Microsoft Graph にお問い合わせください |サポート。