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 GitHub Cloud Issues Microsoft 365 Copilot consente all'organizzazione di indicizzare i problemi di GitHub in modo che possano essere visualizzati nelle esperienze Microsoft 365 Copilot e Microsoft Search. Questo articolo descrive i passaggi per distribuire e personalizzare il connettore nel interfaccia di amministrazione di Microsoft 365.
Per informazioni avanzate sulla configurazione di GitHub, vedere Configurare il servizio GitHub per l'inserimento del connettore.
Prerequisiti
Prima di distribuire il connettore GitHub Cloud Issues, assicurarsi che l'ambiente GitHub Cloud sia configurato nell'organizzazione. Nella tabella seguente vengono riepilogati i passaggi per configurare l'ambiente e distribuire il connettore.
| Attività | Ruolo |
|---|---|
| Configurare l'ambiente | Amministratore di GitHub |
| Distribuire il connettore nel interfaccia di amministrazione di Microsoft 365 | Amministratore di Microsoft 365 |
| Personalizzare le impostazioni del connettore (facoltativo) | Amministratore di Microsoft 365 |
Prima di distribuire il connettore GitHub Cloud Issues, assicurarsi che:
- L'utente è un amministratore di Microsoft 365.
- L'ambiente GitHub è configurato e accessibile tramite API.
- Viene creata un'app GitHub per l'autenticazione con le autorizzazioni necessarie.
- Gli utenti che accedono ai dati indicizzati di GitHub hanno identità Microsoft Entra ID corrispondenti per il mapping delle autorizzazioni.
- Per gli utenti gestiti dall'organizzazione che eseguono l'autenticazione tramite Single Sign-On (SSO), gli account vengono connessi prima dell'installazione. Il flusso di autenticazione di GitHub non supporta l'accesso SSO durante la configurazione.
Distribuire il connettore
Per aggiungere il connettore GitHub Cloud Issues per l'organizzazione:
- Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
- Passare alla scheda Connettori e nel riquadro sinistro scegliere Raccolta.
- Nell'elenco dei connettori disponibili scegliere Problemi cloud di GitHub.
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 GitHub Cloud Issues o personalizzarlo.
Per altre informazioni, vedere Migliorare l'individuazione copilot del contenuto del connettore.
Scegliere il tipo di autenticazione
Il connettore supporta i tipi di autenticazione seguenti:
- App GitHub (per conto dell'utente): consigliata per la maggior parte degli scenari. Immettere l'ID client e il segreto client dall'app GitHub e autorizzare l'accesso.
- App GitHub (installazione):usare una chiave privata generata dall'app GitHub. Immettere l'ID client e il nome dell'organizzazione e caricare la chiave privata.
Per informazioni su come creare un'app GitHub, vedere Usare un'app GitHub personalizzata per l'autenticazione.
Stendere
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 GitHub Cloud Issues avvia immediatamente l'indicizzazione del contenuto.
Nella tabella seguente sono elencati i valori predefiniti impostati quando si distribuisce il connettore.
| Categoria | Valore predefinito |
|---|---|
| Utenti | Mapping delle identità in base alla posta elettronica |
| Contenuto | Problemi indicizzati con metadati, etichette e timestamp |
| 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, 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 Cloud Issues. Per personalizzare le impostazioni, nella pagina del connettore nell'interfaccia di amministrazione scegliere Configurazione personalizzata.
Personalizzare le impostazioni utente
Autorizzazioni di accesso
Specificare quali utenti e gruppi hanno accesso al contenuto indicizzato di 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.
- Accesso: 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.
Se l'amministratore dell'organizzazione imposta le autorizzazioni predefinite per i membri per limitare l'accesso al repository, il connettore rispetta questa impostazione. Gli utenti non possono visualizzare i repository dell'organizzazione a meno che non vengano aggiunti in modo esplicito come collaboratori.
Per le aziende che usano il modello Bring Your Own Key (BYOK) anziché Enterprise Managed Users (EMU), ogni utente deve abilitare l'autorizzazione per condividere il campo identity richiesto nelle impostazioni dell'account GitHub. Questo passaggio garantisce un corretto mapping delle identità tra GitHub e la directory dell'organizzazione.
Personalizzare le impostazioni del contenuto
Nella scheda Contenuto è 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à . Per impostazione predefinita, il connettore indicizza le proprietà seguenti.
| Proprietà | Etichetta semantica | Descrizione | Attributi dello schema |
|---|---|---|---|
| title | Titolo | Titolo del problema | Ricerca consentita |
| descrizione | Contenuto | Descrizione del problema | Ricerca consentita |
| Etichette | Tag | Emettere etichette | Affinabile |
| Timestamp | Data | Data di creazione e aggiornamento | Ordinabile |
Personalizzare gli intervalli di sincronizzazione
Configurare gli intervalli di sincronizzazione della ricerca per indicizzazione completi e incrementali. Di seguito sono riportati i valori predefiniti:
- Ricerca per indicizzazione incrementale: Ogni 15 minuti
- Ricerca per indicizzazione completa: Quotidiano
È possibile modificare questi intervalli in base alle esigenze dell'organizzazione. Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.
Nota
Il supporto per webhook è ora disponibile in anteprima. Assicurarsi di impostare le autorizzazioni webhook (lettura e scrittura) sia a livello di repository che di organizzazione. I webhook consentono di sfruttare l'automazione avanzata e gli aggiornamenti in tempo reale per garantire un'esperienza di integrazione più semplice e reattiva.