Condividi tramite

Risolvere i problemi relativi al connettore Microsoft 365 Copilot di GitLab Knowledge Server

Il connettore GitLab Knowledge Server consente a Microsoft 365 Copilot e Microsoft Search di indicizzare il contenuto delle conoscenze archiviato nell'istanza autogestita di GitLab. Questo articolo fornisce indicazioni per la risoluzione dei problemi relativi agli errori comuni che potrebbero verificarsi durante la distribuzione, la configurazione o l'inserimento del connettore.

Errori di autenticazione

Se l'autenticazione non riesce durante l'autorizzazione del connettore:

  • Verificare che l'ID client e il segreto client siano stati generati dall'applicazione OAuth GitLab corretta.
  • Verificare che gli ambiti necessari siano concessi: read_api, read_repositorye read_user.
  • Assicurarsi che l'URL di reindirizzamento corrisponda all'ambiente:
    • Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Per enti pubblici: https://gcsgcc.office.com/v1.0/admin/oauth/callback
  • Assicurarsi che l'account di autenticazione abbia accesso a repository, wiki e file di documentazione.

Contenuto non indicizzato

Se l'inserimento inizia ma non vengono visualizzati elementi:

  • Verificare che l'istanza di GitLab sia raggiungibile dal server che esegue l'agente del connettore Microsoft Graph.
  • Assicurarsi che i limiti di frequenza delle API in GitLab non blocchino l'inserimento. Disabilitare o aumentare i limiti delle richieste utente, IP o API.
  • Verificare che la versione di GitLab sia 17.7 o successiva.
  • Verificare che la versione dell'agente sia 3.1.8.0 o successiva.
  • Verificare che l'account del connettore disponga di repository e accesso wiki per tutti i progetti pertinenti.

Ritardi di inserimento o ricerca per indicizzazione lenti

Se l'inserimento viene completato lentamente:

  • Aumentare le soglie di limitazione della frequenza di GitLab per Utente, IP, API File, API deprecata, API Utenti, API Gruppi, API Progetti e API Membri.
  • Per ambienti di grandi dimensioni, usare le indicazioni seguenti:
    • Fino a 100.000 elementi: 9.000 richieste all'ora
    • 100.000-1.000.000 elementi: 15.000 richieste/ora
    • Più di 1.000.000 elementi: 15.000 richieste/ora; l'inserimento potrebbe richiedere da 1 a 2 settimane a seconda del carico del sistema

Mancata corrispondenza delle autorizzazioni

Se gli utenti visualizzano i risultati della ricerca a cui non devono avere accesso o non vedono i risultati a cui devono avere accesso:

  • Verificare che il mapping delle identità sia configurato correttamente. Gli attributi di mapping supportati includono posta elettronica, account di accesso e nome.
  • Se gli attributi utente non corrispondono tra GitLab e Microsoft Entra ID, configurare espressioni regolari (regex) per trasformare i valori.
  • Verificare se le impostazioni di visibilità della posta elettronica o i domini misti in GitLab impediscono un mapping accurato.
  • Assicurarsi che il modello di accesso selezionato (solo gli utenti con accesso a questa origine dati o Tutti) corrispondano ai requisiti dell'organizzazione.

Problemi di richiesta di merge o di accesso in base al ruolo

Se gli utenti riscontrano problemi di autorizzazione con le richieste di merge o alcuni ruoli GitLab:

  • L'accesso alle richieste di merge per i progetti pubblici limitati ai membri del progetto viene applicato al ruolo Reporter o superiore.
  • Il ruolo Planner è deprecato per motivi di stabilità. Assegnare il ruolo Reporter o un ruolo superiore agli utenti che richiedono l'accesso.

Problemi dell'agente connettore Microsoft Graph

Se l'agente non riesce a connettersi o segnala errori:

  • Verificare che il computer host dell'agente possa raggiungere l'istanza del server GitLab sulle porte necessarie.
  • Verificare che l'agente disponga di memoria e capacità CPU sufficienti.
  • Riavviare il servizio agente e riprovare a eseguire l'inserimento.

Contenuto correlato

  • Last updated on