Condividi tramite

Distribuire il connettore GitLab Issues Cloud Microsoft 365 Copilot

Il connettore cloud GitLab Issues consente all'organizzazione di indicizzare i problemi archiviati in GitLab e renderli disponibili in Microsoft 365 Copilot e Microsoft Search. Questo articolo descrive i passaggi per distribuire e personalizzare il connettore cloud GitLab Issues.

Prerequisiti

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

  • Verificare che l'istanza di GitLab sia accessibile tramite l'API GitLab.
  • Generare un ID client e un segreto client da GitLab per l'autenticazione.
  • Assicurarsi che l'account di autenticazione abbia accesso ai problemi (e ai relativi progetti o repository associati) che si desidera indicizzare.
  • Assicurarsi che l'ID client e il segreto client includano 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 Issues 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 Issues Cloud.From the list of available connectors, choose GitLab Issues Cloud.

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 di GitLab Issues Cloud o personalizzarlo per soddisfare le esigenze dell'organizzazione.

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

Impostare l'URL dell'istanza

Specificare l'URL dell'istanza di GitLab. Per GitLab Cloud, questo URL è in genere:

https://gitlab.com

Scegliere il tipo di autenticazione

Il connettore supporta OAuth 2.0 per GitLab.

Per eseguire l'autenticazione:

  • Immettere l'ID client e il segreto client di GitLab.
  • Scegliere Autorizza.

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

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. Per altre informazioni, vedere Implementazione temporanea per i connettori Copilot.

Scegliere Crea per distribuire la connessione. Il connettore cloud GitLab Issues 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 Filtro intervallo di tempo: 365 giorni
Sincronizza Ricerca per indicizzazione incrementale: ogni 15 minuti
Ricerca per indicizzazione completa: giornaliera

Per personalizzare questi valori, scegliere Configurazione personalizzata. Per altre informazioni, vedere Personalizzare le impostazioni.

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

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

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 usando:

  • 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

Stringa di query

Esaminare o modificare la stringa di query predefinita per perfezionare gli elementi indicizzati.

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à . Nella tabella seguente sono elencate le proprietà indicizzate dal connettore per impostazione predefinita.

Proprietà Etichetta semantica Descrizione Attributi dello schema
title Titolo Titolo del problema Ricercabile, recuperabile
descrizione Corpo Descrizione del problema Ricercabile, recuperabile
Etichette Tag Emettere etichette Queryable, refinable
Autore Author Autore del problema Ricercabile, recuperabile
created_at Data creazione Timestamp per la creazione Queryable, retrievable
updated_at Data modifica Timestamp per l'ultimo aggiornamento Queryable, retrievable

Personalizzare gli intervalli di sincronizzazione

È possibile personalizzare gli intervalli di ricerca per indicizzazione completi e incrementali. Di seguito sono riportati i valori predefiniti:

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

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

Limiti di frequenza

Nella tabella seguente sono elencati i limiti di frequenza applicabili al connettore cloud GitLab Issues.

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

Contenuto correlato

  • Last updated on