Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il connettore Microsoft 365 Copilot di GitLab Knowledge Server consente all'organizzazione di indicizzare il contenuto delle conoscenze archiviato in istanze autogestiti (locali) di GitLab e renderlo disponibile nelle esperienze di ricerca Microsoft 365 Copilot e Microsoft. Questo articolo descrive i passaggi per distribuire e personalizzare il connettore GitLab Knowledge Server.
Prerequisiti
Prima di distribuire il connettore GitLab Knowledge Server, assicurarsi di soddisfare i prerequisiti seguenti:
- L'istanza del server GitLab (autogestita) è accessibile tramite l'API REST GitLab.
- Sono stati generati un ID client e un segreto client in GitLab per l'autenticazione OAuth 2.0.
- L'account di autenticazione ha accesso a repository, pagine wiki e file di documentazione.
- L'applicazione OAuth include gli ambiti seguenti:
read_api, ,read_userread_repository. - Gli utenti che accedono alle conoscenze indicizzate di GitLab hanno identità Microsoft Entra ID corrispondenti per il mapping delle autorizzazioni.
- L'URL di reindirizzamento è configurato correttamente durante la creazione dell'applicazione OAuth di 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
-
Microsoft 365 Enterprise:
- La versione di GitLab è 17.7 o successiva.
- L'agente connettore Microsoft Graph versione 3.1.8.0 o successiva viene installato in un server con accesso di rete all'istanza di GitLab.
- I limiti di frequenza delle API vengono configurati in base alle raccomandazioni di GitLab per le prestazioni del connettore:
- 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).
- Raggruppa i limiti di frequenza delle API: impostare tutti i valori su 0 per disabilitare i limiti.
- Limiti di velocità dell'API Progetti: impostare tutti i valori su 0 per disabilitare i limiti.
- Limiti di frequenza dell'API Membri: impostato su 0.
Raccomandazioni sui limiti di frequenza
Usare le linee guida nella tabella seguente per scegliere le impostazioni relative al limite di frequenza in base al numero approssimativo di elementi della knowledge base di GitLab.
| Numero approssimativo di elementi | Impostazione consigliata per il limite di frequenza | Tempo approssimativo per completare l'inserimento |
|---|---|---|
| Fino a 100.000 | Aumentare il limite di frequenza a 9.000 richieste/ora | Da ore a un giorno |
| Da 100.000 a 1.000.000 | Aumentare il limite di frequenza a 15.000 richieste/ora | Da due giorni a una settimana |
| 1.000.000 o più | Aumentare il limite di frequenza a 15.000 richieste/ora | 1-2 settimane (varia in base al carico dell'ambiente) |
Distribuire il connettore
Per aggiungere il connettore GitLab Knowledge Server per l'organizzazione:
- Nel riquadro sinistro del interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
- Scegliere la scheda Raccolta .
- Nell'elenco dei connettori disponibili scegliere GitLab Knowledge Server.
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 predefinito di GitLab Knowledge Server o personalizzarlo per l'organizzazione.
Impostare l'URL dell'istanza
Specificare l'URL di base dell'istanza del server GitLab. Questo URL è l'endpoint GitLab usato dal connettore per accedere alla documentazione e al contenuto del repository tramite le API REST GitLab. Specificare l'URL radice dell'installazione di GitLab autogestita, https://gitlab.contoso.comad esempio .
Scegliere l'agente connettore Microsoft Graph
Selezionare l'agente connettore Microsoft Graph che gestisce il modo in cui i dati di GitLab Knowledge vengono inseriti in Microsoft 365.
Scegliere il tipo di autenticazione
Il connettore GitLab Knowledge Server supporta l'autenticazione OAuth 2.0 . Specificare l'ID client e il segreto client dall'applicazione GitLab, quindi selezionare Autorizza.
Per la configurazione dell'applicazione GitLab, assicurarsi che l'account di autenticazione disponga di un repository e di un accesso wiki sufficienti per consentire al connettore di eseguire la ricerca per indicizzazione del contenuto.
Eseguire l'implementazione
Per distribuire il connettore a un gruppo di destinatari limitato, scegliere l'interruttore accanto a Implementazione per gruppi di destinatari limitati e specificare gli utenti e i gruppi a cui distribuire la connessione.
Scegliere Crea per distribuire la connessione. Il connettore GitLab Knowledge Server inizia immediatamente l'indicizzazione del contenuto.
Nella tabella seguente sono elencati i valori predefiniti impostati.
| Categoria | Valore predefinito |
|---|---|
| Utenti | Tutti gli utenti idonei di Microsoft 365 |
| Contenuto | Tutti gli oggetti conoscenze GitLab supportati (Markdown, wiki, documentazione) |
| Sincronizza | Ricerca per indicizzazione incrementale ogni 15 minuti; ricerca per indicizzazione completa giornaliera |
Per personalizzare questi valori, scegliere Configurazione personalizzata.
Dopo aver creato la connessione, è possibile esaminare 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 Knowledge Server. Per personalizzare questi valori, aprire la pagina del connettore nell'interfaccia di amministrazione e scegliere Configurazione personalizzata.
Personalizzare le impostazioni utente
Autorizzazioni di accesso
Scegliere se la conoscenza di GitLab indicizzata è visibile per:
- Solo gli utenti con accesso a questa origine dati (impostazione predefinita)
- Tutti
Se si sceglie l'opzione predefinita, il contenuto indicizzato viene visualizzato solo per gli utenti con autorizzazioni di accesso GitLab. La scelta di Tutti rende il contenuto visibile a tutti gli utenti tramite le esperienze Microsoft Search e Copilot dell'organizzazione.
Esegui il mapping delle identità
Per assicurarsi che vengano rispettate le autorizzazioni di GitLab, eseguire il mapping delle identità utente di GitLab a Microsoft Entra ID usando una delle opzioni seguenti:
- Posta elettronica
- Accesso
- Nome
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.
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
Sono disponibili gli intervalli di sincronizzazione seguenti:
- Ricerca per indicizzazione incrementale: il valore predefinito è ogni 15 minuti.
- Ricerca per indicizzazione completa: l'impostazione predefinita è giornaliera.
È possibile modificare questi intervalli in base alle esigenze dell'organizzazione. Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.