GitLab Knowledge Cloud Microsoft 365 Copilot コネクタをデプロイする

GitLab Knowledge Cloud Microsoft 365 Copilot コネクタを使用すると、organizationで GitLab に格納されているドキュメント、Wiki、ナレッジ成果物のインデックスを作成し、Microsoft 365 Copilotおよび Microsoft Search エクスペリエンスで使用できるようにします。この記事では、GitLab Knowledge Cloud コネクタをデプロイしてカスタマイズする手順について説明します。

前提条件

コネクタをデプロイする前に、次の前提条件を満たしていることを確認してください。

Microsoft 365 管理者である必要があります。
GitLab インスタンスに API 経由でアクセスできることを確認します。
GitLab から クライアント ID と クライアントシークレット を生成します。
認証アカウントがリポジトリ、Wiki、Runbook、ドキュメント、ナレッジファイルにアクセスできることを確認します。
クライアント ID とクライアントシークレットには、次のスコープを含める必要があります。
- read_api
- read_repository
- read_user
インデックス付き GitLab データにアクセスするユーザーは、アクセス許可マッピングに対応するMicrosoft Entra ID ID を持っている必要があります。
GitLab 認証のセットアップ中に適切なリダイレクト URL を設定します。
- Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
- Microsoft 365 Government:https://gcsgcc.office.com/v1.0/admin/oauth/callback

コネクタをデプロイする

organizationの GitLab Knowledge Cloud コネクタを追加するには:

Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
[ ギャラリー ] タブを選択します。
使用可能なコネクタの一覧から、[ GitLab Knowledge Cloud] を選択します。

表示名を設定する

表示名は、Copilot 応答の参照を識別し、ユーザーがコンテンツソースを認識するのに役立ちます。既定の GitLab Knowledge Cloud の表示名をそのまま使用することも、カスタマイズすることもできます。

認証の種類を選択する

GitLab Knowledge Cloud コネクタでは 、OAuth 2.0 認証がサポートされています。 [OAuth 2.0] を選択し、クライアント ID とクライアントシークレットを入力して、[承認] を選択します。

ロールアウト

制限付き対象ユーザーにロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーとグループを指定します。詳細については、「 Copilot コネクタの段階的ロールアウト」を参照してください。

[ 作成] を 選択して接続をデプロイします。 GitLab Knowledge Cloud コネクタは、コンテンツのインデックス作成をすぐに開始します。

次の表に、設定される既定値を示します。

カテゴリ	既定値
ユーザー	このデータソースにアクセスできるユーザーのみ
コンテンツ	過去 365 日間のインデックス付きコンテンツ
同期	増分: 15 分。完全: 毎日

これらの値をカスタマイズするには、[ カスタムセットアップ] を選択します。

接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。

設定のカスタマイズ (省略可能)

GitLab Knowledge Cloud コネクタ設定の既定値をカスタマイズできます。設定をカスタマイズするには、管理センターのコネクタページで [ カスタムセットアップ] を選択します。

ユーザー設定をカスタマイズする

アクセス許可

次のいずれかのオプションを選択します。

このデータソースへのアクセス権を持つユーザーのみ (既定)
すべてのユーザー

[このデータソースにアクセスできるユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示されます。 [ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。

ID のマッピング

アクセス許可が正しく適用されるようにするには、GitLab ユーザー ID をMicrosoft Entra IDにマップします。マッピングには、次のいずれかのオプションを選択します。

Email: GitLab 電子メールをユーザープロパティMicrosoft Entra IDにマップします。
ログイン：Microsoft Entra IDユーザープロパティを使用して GitLab ログインをマップします。
名前：GitLab 名をユーザープロパティMicrosoft Entra IDマップします。

直接マッピングが失敗した場合は、正規表現 (regex) を使用してデータを変換します。例: [a-zA-Z0-9]+。詳細については、「Microsoft Entra ID のマップ」を参照してください。

コンテンツ設定をカスタマイズする

[ データ ] タブでは、コンテンツ、ラベル、説明、タイムスタンプなどのメタデータのサンプルデータ内のプロパティマッピングを確認できます。

コンテンツフィルター

コネクタの時間範囲フィルターを構成できます。既定の設定は 365 日です。

プロパティの管理

データソースから使用可能なプロパティの追加または削除、プロパティへのスキーマの割り当て (検索可能、クエリ可能、取得可能、またはリファイン可能)、セマンティックラベルの変更、プロパティへのエイリアスの追加を行うことができます。

同期間隔をカスタマイズする

完全クロールと増分クロールの同期間隔を構成します。

増分クロール: 既定値は 15 分ごとです。
フルクロール: 既定値は毎日です。

これらの間隔は、organizationのニーズに合わせて調整できます。詳細については、「同期設定のガイドライン」を参照してください。

次の表に、GitLab Knowledge Cloud コネクタのコンテンツインジェストのレート制限を示します。

項目のおおよその数	インジェストを完了するまでのおおよその時間
最大 100,000	6時間以内
100,000 から 1,000,000	6 時間から 3 日
1,000,000 以上	3 日から 2 週間 (環境負荷によって異なります)

Last updated on 2026-01-24