Distribuire il connettore GitLab Merge Requests Server Microsoft 365 Copilot

Il connettore GitLab Merge Requests Server Microsoft 365 Copilot integra i metadati delle richieste di merge da GitLab self-managed (server) in Microsoft 365. Dopo la distribuzione, il connettore indicizza i titoli delle richieste di merge, le descrizioni, le etichette, gli stati, i timestamp, gli autori, gli assegnatari, i revisori, le attività cardine e il contesto del progetto. Questa indicizzazione consente agli utenti di cercare, riepilogare e recuperare informazioni dettagliate sulle richieste di merge usando Microsoft 365 Copilot, Ricerca Copilot e Microsoft Search.

Questo articolo descrive i passaggi per distribuire e personalizzare il connettore GitLab Merge Requests Server.

Prerequisiti

Prima di distribuire il connettore GitLab Merge Requests Server, assicurarsi che l'organizzazione soddisfi i prerequisiti seguenti:

Verificare che l'istanza di GitLab Server sia accessibile tramite l'API REST GitLab.
Generare un ID client e un segreto client da GitLab per l'autenticazione OAuth 2.0.
L'account utente di autenticazione deve avere accesso a repository, problemi, richieste di merge, file di informazioni e pagine wiki.
L'ID client e il segreto client devono includere gli ambiti seguenti:
- read_api
- read_repository
- read_user
Gli utenti che accedono ai dati GitLab indicizzati devono avere identità di Microsoft Entra ID corrispondenti per il mapping delle autorizzazioni.
Configurare l'URL di reindirizzamento appropriato durante la creazione dell'applicazione OAuth GitLab:
- 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
Per gli ambienti GitLab autogestiti, assicurarsi che:
- Si dispone di GitLab versione 17.7 o successiva.
- L'agente connettore Microsoft Graph versione 3.1.8.0 o successiva viene installato in un server in grado di connettersi all'istanza di GitLab.
- L'account di autenticazione deve disporre di privilegi amministrativi per abilitare la ricerca per indicizzazione dell'elenco di controllo di accesso (ACL).
Per ottenere prestazioni ottimali, modificare i limiti di frequenza di GitLab come consigliato:
- Limiti di frequenza per utenti e IP: deselezionare Abilita limite di frequenza delle richieste API autenticate e Abilita limite di frequenza delle richieste Web autenticate.
- Limiti di frequenza dell'API File: deselezionare Abilita limite di frequenza delle richieste API autenticate.
- Limiti di frequenza delle API deprecati: deselezionare Abilita limite di frequenza delle richieste API autenticate.
- Limiti di frequenza dell'API Utenti: impostare Max requests per 10 minuti per utente su un valore elevato (ad esempio, 100000).
- Limiti di frequenza api e progetti per gruppi: impostare tutti i valori su 0 per disabilitare i limiti.
- Limiti di frequenza dell'API Membri: impostato su 0.

Raccomandazioni relative ai limiti di frequenza

Usare le linee guida nella tabella seguente per scegliere le impostazioni di limite di frequenza in base al numero approssimativo di richieste di merge GitLab.

Numero approssimativo di elementi	Impostazione consigliata per il limite di frequenza	Tempo approssimativo per completare l'inserimento
Fino a 100.000	Usare le impostazioni predefinite del limite di frequenza (7200/ora)	Da ore a 1 giorno
Da 100.000 a 1.000.000	Usare le impostazioni predefinite del limite di frequenza (7200/ora)	Da 2 giorni a 1 settimana
1.000.000 o più	Usare le impostazioni predefinite del limite di frequenza (7200/ora)	1-2 settimane (varia in base al carico dell'ambiente)

Distribuire il connettore

Per aggiungere il connettore GitLab Merge Requests Server per l'organizzazione:

Nel riquadro sinistro del interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
Passare alla scheda Connettori e selezionare Raccolta.
Nell'elenco dei connettori disponibili selezionare Server richieste di merge GitLab.

Impostare il nome visualizzato

Il nome visualizzato identifica i riferimenti nelle risposte copilot e consente agli utenti di riconoscere l'origine di contenuto associata. È possibile accettare il nome visualizzato predefinito del server richieste di merge GitLab o personalizzarlo.

Per altre informazioni sui nomi visualizzati del connettore, vedere Migliorare l'individuazione copilot del contenuto del connettore.

Impostare l'URL dell'istanza

Specificare l'URL di base dell'istanza del server GitLab. Questo URL viene usato dal connettore per accedere ai dati delle richieste di merge tramite le API REST di GitLab. Usare il formato seguente:

https://<your-gitlab-server>/

Scegliere Graph Connector Agent

Selezionare l'agente connettore Microsoft Graph usato dall'organizzazione per inserire contenuto GitLab. L'agente deve essere installato in un computer che può raggiungere l'istanza del server GitLab.

Scegliere il tipo di autenticazione

Il connettore GitLab Merge Requests Server supporta l'autenticazione OAuth 2.0 . Immettere l'ID client e il segreto client e quindi scegliere Autorizza per completare il flusso OAuth.

Per informazioni su come creare un'app OAuth GitLab, vedere Configurare GitLab come provider di identità di autenticazione OAuth 2.0.

Eseguire l'implementazione

Per distribuire il connettore a un gruppo di destinatari limitato, scegliere l'interruttore accanto a Implementazione a gruppi di destinatari limitati e specificare gli utenti o i gruppi. Per altre informazioni, vedere Implementazione temporanea per i connettori Copilot.

Il connettore GitLab Merge Requests Server inizia l'indicizzazione del contenuto subito dopo la distribuzione.

Per personalizzare la connessione, scegliere Configurazione personalizzata. Per altre informazioni, vedere Personalizzare le impostazioni.

Dopo aver creato la connessione, è possibile esaminarne lo stato nella sezione Connettori del interfaccia di amministrazione di Microsoft 365.

Personalizzare le impostazioni (facoltativo)

È possibile personalizzare i valori predefiniti per le impostazioni del connettore GitLab Merge Requests Server. Per personalizzare le impostazioni, scegliere Configurazione personalizzata nella pagina del connettore.

Personalizzare le impostazioni utente

Autorizzazioni di accesso

Scegliere se i dati indicizzati sono visibili a:

Solo gli utenti con accesso a questa origine dati (impostazione predefinita)
Tutti

Se si sceglie Solo gli utenti con accesso a questa origine dati, i dati indicizzati vengono visualizzati nei risultati della ricerca per gli utenti che hanno accesso a tale origine. Se si sceglie Tutti, i dati indicizzati vengono visualizzati nei risultati della ricerca per tutti gli utenti.

Esegui il mapping delle identità

Eseguire il mapping delle identità utente di GitLab a Microsoft Entra ID. Le opzioni disponibili sono:

Email: esegue il mapping della posta elettronica di GitLab alle proprietà utente Microsoft Entra ID.
Accesso: esegue il mapping degli account di accesso di GitLab con Microsoft Entra ID proprietà utente.
Nome: esegue il mapping del nome GitLab con Microsoft Entra ID proprietà utente.

Se il mapping diretto non riesce, usare espressioni regolari (regex) per trasformare i dati. Ad esempio: [a-zA-Z0-9]+. Per altre informazioni, vedere Mapping delle identità Microsoft Entra.

Personalizzare le impostazioni del contenuto

Nella scheda Dati è possibile verificare i mapping delle proprietà nei dati di esempio per metadati quali contenuto, etichette, descrizione e timestamp.

Stringa di query

È possibile configurare un filtro dell'intervallo di tempo per il connettore. L'impostazione predefinita è 365 giorni.

Gestire le proprietà

È possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati, assegnare uno schema alla proprietà (ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà .

Personalizzare gli intervalli di sincronizzazione

Configurare intervalli di ricerca per indicizzazione completi e incrementali. Tuttavia, è consigliabile solo negli ambienti tra foreste.

Ricerca per indicizzazione incrementale: Ogni 15 minuti
Ricerca per indicizzazione completa: Quotidiana

Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.

Last updated on 2026-01-24

Condividi tramite