次の方法で共有

GitLab Knowledge Cloud Microsoft 365 Copilot コネクタに関する問題のトラブルシューティング

GitLab Knowledge Cloud Microsoft 365 Copilot コネクタは、GitLab.com 上の GitLab プロジェクトに格納されているドキュメントとナレッジ成果物にインデックスを付けます。 この記事では、GitLab Knowledge Cloud コネクタをデプロイして使用するときに発生する可能性がある一般的なエラーのトラブルシューティング情報を提供します。 通常、これらの問題は、認証、アクセス許可、コンテンツの欠落、GitLab API アクセスに関連しています。

Copilot または Microsoft Search で GitLab ナレッジ コンテンツが見つかりません

Copilot または検索結果で GitLab ドキュメント、Wiki、ナレッジ成果物が見つからない場合は、次の内容を確認してください。

  • GitLab インスタンス URL が正しいことを確認します。
  • GitLab OAuth アプリに必要なスコープがあることを確認します。
    • read_api
    • read_repository
    • read_user
  • 認証された GitLab アカウントが、インデックス付きプロジェクト、Wiki、およびファイルすべてにアクセスできるかどうかを確認します。
  • ユーザーが GitLab ユーザーに正しくマップされるMicrosoft Entra ID ID を持っていることを確認します。
  • コンテンツが既定のインデックス作成範囲内にあることを確認します (カスタマイズされていない限り、過去 365 日間)。

特定の GitLab プロジェクト、Wiki、または Runbook へのアクセスが見つからない

検索結果または Copilot 応答に一部のコンテンツが見つからない場合:

  • コネクタのセットアップ中に使用される GitLab アカウントのアクセス許可を確認します。
  • 不足しているプロジェクト、Wiki ページ、または Runbook にプロジェクト レベルのアクセス許可が必要かどうかを確認します。
  • ID マッピング ルールが GitLab ユーザーとMicrosoft Entra ID アカウントと正しく一致していることを確認します。
  • 正規表現変換が使用されている場合は、パターンが予想されるユーザー識別子と一致していることを確認します。

GitLab OAuth の承認に関する問題

OAuth フローの完了に関する問題が発生した場合:

  • クライアント ID とクライアント シークレットが有効であり、テナント用に構成された GitLab OAuth アプリに属していることを確認します。
  • 正しいリダイレクト 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
  • GitLab インスタンスでシングル サインオン (SSO) が有効になっているかどうかを確認します。 一部の SSO フローでは、承認前にアカウントを個別にサインインする必要があります。

GitLab API レートの制限または不完全なインジェスト

インデックス作成が一時停止するか、コンテンツが不完全に表示される場合:

  • GitLab テナントがレート制限に達しているかどうかを確認します。
  • インジェストボリュームのガイドラインを確認します。
    • 最大 100,000 個のアイテム: 通常、数時間以内に完了します。
    • 100,000 から 1,000,000 アイテム: インジェストには数日かかることがあります。
    • 1,000,000 を超えるアイテム: 読み込みによっては、取り込みに数日から数週間かかる場合があります。
  • インデックス作成の範囲を一時的に減らし (たとえば、日付範囲を狭くするなど)、パフォーマンスが向上するかどうかを判断します。
  • 同期間隔のカスタマイズを確認して、組織のニーズを満たしていることを確認します。
    • 増分クロール: 15 分 (既定値)
    • フル クロール: 毎日 (既定値)

Copilot の正しくない検索結果または予期しない検索結果

Copilot 応答に予期しないコンテンツが表示される場合、または予想される GitLab ドキュメントを省略する場合:

  • [ データ ] タブでプロパティ マッピングを確認します。
  • タイトル、コンテンツ、説明、ラベル、タイムスタンプなどの重要なフィールドがマップされ、正しく設定されていることを確認します。
  • 検索可能、取得可能、または絞り込み可能とマークされたプロパティが、コンテンツのニーズと一致することを確認します。
  • クエリ文字列の構成を確認して、フィルター処理で必要なコンテンツが除外されていないことを確認します。

ID マッピングの問題

ユーザーが期待されるコンテンツを表示できない場合:

  • ID マッピングが GitLab テナントと一致していることを確認します。
    • 電子メール
    • ログイン
    • 名前
    • 正規表現変換
  • GitLab と Microsoft Entra ID ユーザーが、必要なすべての属性に合わせて調整されていることを確認します。
  • マッピング ルールが複雑な場合は、少数のアカウントセットでテストして、正しいマッピング動作を確認します。

アクセス許可の問題

ユーザーが アクセス エラーを 受け取っていない場合:

  • GitLab REST API のアクセス許可によって、コネクタのサービス アカウントがドキュメント、Wiki、ナレッジ資産の全範囲を読み取ることを許可することを検証します。
  • Microsoft 365 のアクセス設定を確認します。
    • このデータ ソースにアクセスできるユーザーのみ
    • すべてのユーザー
  • GitLab グループまたはプロジェクト レベルのアクセス許可によって、コネクタがコンテンツを取得できないことを確認します。

GitLab インスタンス URL エラー

コネクタがインスタンス URL の問題を報告する場合:

  • インスタンス URL が、ナレッジ コンテンツのホストに使用される GitLab デプロイと一致していることを確認します。
    • GitLab.com の場合は、 https://gitlab.comを使用します。
    • GitLab セルフマネージド インスタンスの場合は、URL が Microsoft 365 環境からアクセス可能で到達可能であることを確認します。

関連コンテンツ

  • Last updated on