Distribuire il connettore GitHub Server Pull Requests Microsoft 365 Copilot

Il connettore GitHub Server Pull Requests Microsoft 365 Copilot integra i metadati delle richieste pull da GitHub Enterprise Server in Microsoft 365. Dopo la distribuzione, il connettore indicizza titoli, descrizioni, etichette, timestamp, autori, revisori, attività cardine e contesto del repository in modo che gli utenti possano cercare, riepilogare e recuperare informazioni dettagliate sulle richieste pull usando Microsoft 365 Copilot, Ricerca Copilot e Microsoft Search.

Questo articolo descrive i passaggi per distribuire e personalizzare il connettore GitHub Server Pull Requests.

Per informazioni avanzate sulla configurazione del servizio GitHub, vedere
Configurare il servizio GitHub per l'inserimento del connettore richieste pull di GitHub Server.

Prerequisiti

Prima di distribuire il connettore GitHub Server Pull Requests, assicurarsi che l'ambiente GitHub Enterprise Server sia configurato per l'inserimento. Nella tabella seguente vengono riepilogati i passaggi per configurare l'ambiente del servizio GitHub e distribuire il connettore.

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

• È necessario essere un amministratore di Microsoft 365.
• L'istanza di GitHub Enterprise Server deve essere accessibile tramite API.
• L'app GitHub deve essere completamente configurata e installata nell'organizzazione di destinazione.
• Microsoft Graph Connector Agent deve essere installato in un dispositivo con accesso all'istanza di GitHub (versione 3.1.11.0 o successiva).
• L'account utente usato per l'autenticazione deve avere accesso ai repository e alle richieste pull da indicizzare.
• Gli utenti che accedono ai dati di richiesta pull indicizzati devono avere identità Microsoft Entra ID per abilitare il mapping delle autorizzazioni.

Distribuire il connettore

Per aggiungere il connettore GitHub Server Pull Requests per l'organizzazione:

1. Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
2. Passare alla scheda Connettori e nel riquadro sinistro scegliere Raccolta.
3. Nell'elenco dei connettori disponibili scegliere Richieste pull di GitHub Server.

Impostare il nome visualizzato

Il nome visualizzato viene usato per identificare i riferimenti nelle risposte copilot in modo che gli utenti possano riconoscere le origini contenuto. È possibile mantenere il nome predefinito GitHub Server Pull Requests o sostituirlo con un nome visualizzato personalizzato rilevante per l'organizzazione.

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

Impostare l'URL dell'istanza

Immettere l'URL dell'istanza di GitHub Enterprise Server. Ad esempio:

https://github.<yourdomain>.com

Il connettore usa questo URL per richiedere i metadati di richiesta pull durante l'inserimento.

Scegliere il tipo di autenticazione

Il connettore richieste pull di GitHub Server supporta i tipi di autenticazione seguenti:

• App GitHub (per conto dell'utente):

  • Immettere l'ID client e il segreto client dell'app GitHub.
  • Autorizzare l'accesso.
  • Consigliato quando si usano account utente separati per l'isolamento dei limiti di frequenza.

• App GitHub (installazione):

  • Generare una chiave privata dalla pagina di configurazione dell'app GitHub.
  • Immettere l'ID client, il nome dell'organizzazione e caricare la chiave privata.

  Nota

  Questo tipo di autenticazione è attualmente in anteprima. Per usare questo tipo di autenticazione, contattare il supporto tecnico Microsoft.

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 e i gruppi che devono avere accesso anticipato. Per ulteriori informazioni, vedere
Implementazione temporanea per i connettori Copilot.

Scegliere Crea per distribuire la connessione. Il connettore inizia immediatamente l'indicizzazione del contenuto.

Nella tabella seguente sono elencati i valori predefiniti impostati.

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

Personalizzare le impostazioni utente

Autorizzazioni di accesso

L'accesso ai dati delle richieste pull rispetta le autorizzazioni dell'app GitHub e i controlli di accesso al repository GitHub.

Mapping delle identità

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

• Email: esegue il mapping della posta elettronica di GitHub alle proprietà dell'utente Microsoft Entra ID.
• Login: Esegue il mapping degli account di accesso di GitHub con Microsoft Entra ID proprietà utente.
• Nome: Esegue il mapping del nome di GitHub 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

Specificare o perfezionare i parametri di query usati per filtrare o identificare il contenuto della richiesta pull.

Gestire le proprietà

Nella tabella seguente vengono descritte le proprietà che il connettore indicizza per impostazione predefinita.

Personalizzare gli intervalli di sincronizzazione

Sono disponibili due tipi di ricerca per indicizzazione:

• Ricerca per indicizzazione incrementale: Viene eseguito ogni 15 minuti per impostazione predefinita.
• Ricerca per indicizzazione completa: Viene eseguito ogni giorno per aggiornare l'indice di richiesta pull.

È possibile personalizzare questi valori in base alle esigenze dell'organizzazione. Per ulteriori informazioni, vedere
Linee guida per le impostazioni di sincronizzazione.

Contenuto correlato

• Panoramica del connettore richieste pull di GitHub Server
• Risolvere i problemi relativi al connettore GitHub Server Pull Requests
• Configurare i connettori Copilot nel interfaccia di amministrazione di Microsoft 365