Condividi tramite

Risolvere i problemi relativi al connettore GitLab Knowledge Cloud Microsoft 365 Copilot

Il connettore GitLab Knowledge Cloud Microsoft 365 Copilot indicizza la documentazione e gli artefatti delle conoscenze archiviati nei progetti GitLab in GitLab.com. Questo articolo fornisce informazioni sulla risoluzione dei problemi relativi agli errori comuni che possono verificarsi quando si distribuisce e si usa il connettore GitLab Knowledge Cloud. Questi problemi sono in genere correlati all'autenticazione, alle autorizzazioni, al contenuto mancante o all'accesso all'API GitLab.

Non è possibile trovare il contenuto delle conoscenze di GitLab in Copilot o Microsoft Search

Se gli utenti non riescono a trovare la documentazione, i wiki o gli artefatti della conoscenza di GitLab in Copilot o nei risultati della ricerca, vedere quanto segue:

  • Verificare che l'URL dell'istanza di GitLab sia corretto.
  • Verificare che l'app OAuth di GitLab abbia gli ambiti necessari:
    • read_api
    • read_repository
    • read_user
  • Verificare che l'account GitLab autenticato abbia accesso a tutti i progetti indicizzati, i wiki e i file.
  • Assicurarsi che gli utenti dispongano di identità Microsoft Entra ID mappate correttamente agli utenti di GitLab.
  • Verificare che il contenuto sia compreso nell'intervallo di indicizzazione predefinito (gli ultimi 365 giorni, a meno che non siano personalizzati).

Accesso mancante a determinati progetti, wiki o runbook GitLab

Se alcuni contenuti non sono presenti nei risultati della ricerca o nelle risposte copilot:

  • Verificare le autorizzazioni dell'account GitLab usato durante l'installazione del connettore.
  • Controllare se i progetti, le pagine wiki o i runbook mancanti richiedono autorizzazioni a livello di progetto.
  • Verificare che le regole di mapping delle identità corrispondano correttamente agli utenti di GitLab agli account Microsoft Entra ID.
  • Se sono in uso trasformazioni regex, assicurarsi che i modelli corrispondano agli identificatori utente previsti.

Problemi di autorizzazione OAuth di GitLab

Se si verificano problemi durante il completamento del flusso OAuth:

  • Verificare che l'ID client e il segreto client siano validi e appartengano all'app OAuth GitLab configurata per il tenant.
  • Verificare che sia configurato l'URL di reindirizzamento corretto:
    • 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
  • Verificare se l'accesso Single Sign-On (SSO) è abilitato nell'istanza di GitLab. Alcuni flussi SSO richiedono che l'account venga connesso separatamente prima dell'autorizzazione.

Limitazione della frequenza api GitLab o inserimento incompleto

Se le pause di indicizzazione o il contenuto appaiono incompleti:

  • Controllare se il tenant di GitLab sta raggiungendo i limiti di frequenza.
  • Esaminare le linee guida per il volume di inserimento:
    • Fino a 100.000 elementi: in genere viene completato entro diverse ore.
    • Da 100.000 a 1.000.000 di elementi: l'inserimento potrebbe richiedere più giorni.
    • Oltre 1.000.000 elementi: l'inserimento può richiedere da diversi giorni a settimane a seconda del carico.
  • Ridurre temporaneamente l'ambito di indicizzazione (ad esempio, riducendo l'intervallo di date) per determinare se le prestazioni migliorano.
  • Esaminare le personalizzazioni degli intervalli di sincronizzazione per assicurarsi che soddisfino le esigenze dell'organizzazione:
    • Ricerca per indicizzazione incrementale: 15 minuti (impostazione predefinita)
    • Ricerca per indicizzazione completa: giornaliera (impostazione predefinita)

Risultati di ricerca non corretti o imprevisti in Copilot

Se le risposte copilot mostrano contenuto imprevisto o omettono la documentazione prevista di GitLab:

  • Verificare i mapping delle proprietà nella scheda Dati .
  • Verificare che i campi importanti, ad esempio titolo, contenuto, descrizione, etichette e timestamp, siano mappati e impostati correttamente.
  • Verificare che le proprietà contrassegnate come ricercabili, recuperabili o perfezionabili corrispondano alle esigenze del contenuto.
  • Esaminare la configurazione della stringa di query per verificare che il filtro non escluda il contenuto richiesto.

Problemi di mapping delle identità

Se gli utenti non sono in grado di visualizzare il contenuto previsto:

  • Verificare che i mapping delle identità siano allineati al tenant di GitLab:
    • Posta elettronica
    • Accesso
    • Nome
    • Trasformazione Regex
  • Assicurarsi che gli utenti di GitLab e Microsoft Entra ID siano allineati tra tutti gli attributi necessari.
  • Se le regole di mapping sono complesse, eseguire il test con un piccolo set di account per verificare il comportamento di mapping corretto.

Problemi di autorizzazioni

Se gli utenti non ricevono errori di accesso :

  • Verificare che le autorizzazioni dell'API REST GitLab consentano all'account del servizio del connettore di leggere l'ambito completo di documenti, wiki e asset di conoscenze.
  • Controllare le impostazioni di accesso di Microsoft 365:
    • Solo gli utenti con accesso a questa origine dati
    • Tutti
  • Verificare che le autorizzazioni a livello di gruppo o di progetto di GitLab non impediscano al connettore di recuperare il contenuto.

Errori dell'URL dell'istanza di GitLab

Se il connettore segnala problemi relativi all'URL dell'istanza:

  • Assicurarsi che l'URL dell'istanza corrisponda alla distribuzione GitLab usata per ospitare il contenuto delle informazioni.
    • Per GitLab.com, usare https://gitlab.com.
    • Per le istanze autogestiti di GitLab, verificare che l'URL sia accessibile e raggiungibile dall'ambiente Microsoft 365.

Contenuto correlato

  • Last updated on