Condividi tramite


Distribuire il connettore GitLab Knowledge Cloud Microsoft 365 Copilot

Il connettore GitLab Knowledge Cloud Microsoft 365 Copilot consente all'organizzazione di indicizzare la documentazione, i wiki e gli artefatti delle conoscenze archiviati in GitLab e renderli disponibili nelle esperienze di ricerca Microsoft 365 Copilot e Microsoft. Questo articolo descrive i passaggi per distribuire e personalizzare il connettore GitLab Knowledge Cloud.

Prerequisiti

Prima di distribuire il connettore, assicurarsi di soddisfare i prerequisiti seguenti:

  • È necessario essere un amministratore di Microsoft 365.
  • Verificare che l'istanza di GitLab sia accessibile tramite API.
  • Generare un ID client e un segreto client da GitLab.
  • Assicurarsi che l'account di autenticazione abbia accesso a repository, wiki, runbook, documentazione e file di conoscenze.
  • 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.
  • Impostare gli URL di reindirizzamento appropriati durante l'installazione dell'autenticazione 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

Distribuire il connettore

Per aggiungere il connettore GitLab Knowledge Cloud per l'organizzazione:

  1. Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
  2. Scegliere la scheda Raccolta .
  3. Nell'elenco dei connettori disponibili scegliere GitLab Knowledge Cloud.

Impostare il nome visualizzato

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

Scegliere il tipo di autenticazione

Il connettore GitLab Knowledge Cloud supporta l'autenticazione OAuth 2.0 . Scegliere OAuth 2.0, immettere l'ID client e il segreto client e scegliere Autorizza.

Eseguire l'implementazione

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

Scegliere Crea per distribuire la connessione. Il connettore GitLab Knowledge Cloud avvia immediatamente l'indicizzazione del contenuto.

Nella tabella seguente sono elencati i valori predefiniti impostati.

Categoria Valore predefinito
Utenti Solo gli utenti con accesso a questa origine dati
Contenuto Ultimi 365 giorni di contenuto indicizzato
Sincronizza Incrementale: 15 minuti; Completo: giornaliero

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 Cloud. Per personalizzare le impostazioni, nella pagina del connettore nell'interfaccia di amministrazione scegliere Configurazione personalizzata.

Personalizzare le impostazioni utente

Autorizzazioni di accesso

Scegli una delle opzioni seguenti:

  • 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à

Per assicurarsi che le autorizzazioni vengano applicate correttamente, eseguire il mapping delle identità utente di GitLab a Microsoft Entra ID. Scegliere una delle opzioni seguenti per il mapping:

  • Email: esegue il mapping della posta elettronica di GitLab alle proprietà utente Microsoft Entra ID.
  • Login: 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.

Filtro contenuto

È 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 gli intervalli di sincronizzazione per le ricerche per indicizzazione complete e incrementali:

  • Ricerca per indicizzazione incrementale: Il valore predefinito è ogni 15 minuti.
  • Ricerca per indicizzazione completa: Il valore predefinito è giornaliero.

È possibile modificare questi intervalli in base alle esigenze dell'organizzazione. Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.

Nella tabella seguente sono elencati i limiti di frequenza per l'inserimento di contenuto del connettore GitLab Knowledge Cloud.

Numero approssimativo di elementi Tempo approssimativo per completare l'inserimento
Fino a 100.000 Entro 6 ore
Da 100.000 a 1.000.000 Da 6 ore a 3 giorni
1.000.000 o più 3 giorni-2 settimane (varia in base al carico dell'ambiente)