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 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_apiread_repositoryread_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
-
Microsoft 365 Enterprise:
Distribuire il connettore
Per aggiungere il connettore GitLab Issues Cloud per l'organizzazione:
- Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
- Scegliere la scheda Raccolta .
- 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) |