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 Knowledge consente alle organizzazioni di indicizzare markdown e file di testo dai repository GitHub in esperienze Microsoft 365 Copilot e Microsoft Search. Questo articolo descrive i passaggi per distribuire e personalizzare il connettore. Per informazioni generali sulla distribuzione del connettore Copilot, vedere Configurare i connettori Copilot 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 Knowledge, 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 | Amministratore di Microsoft 365 |
| Personalizzare le impostazioni del connettore (facoltativo) | Amministratore di Microsoft 365 |
Prima di distribuire il connettore GitHub Cloud Knowledge, assicurarsi che:
- L'utente è un amministratore di Microsoft 365 per l'organizzazione.
- L'istanza di GitHub è accessibile tramite API.
- Viene creata e configurata un'app GitHub per l'autenticazione.
- 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), l'account viene connesso prima della configurazione. Il flusso di autenticazione di GitHub non supporta l'accesso SSO.
Distribuire il connettore
Per aggiungere il connettore GitHub Cloud Knowledge 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 GitHub Cloud Knowledge.
Impostare il nome visualizzato
Il nome visualizzato identifica i riferimenti nelle risposte copilot e indica contenuto attendibile. È possibile accettare il nome visualizzato predefinito di GitHub Cloud Knowledge oppure scegliere un nome riconosciuto dagli utenti dell'organizzazione.
Per altre informazioni, vedere Migliorare l'individuazione copilot del contenuto del connettore.
Impostare l'URL dell'istanza
Immettere l'URL dell'organizzazione di GitHub che verrà indicizzato dal connettore. Ad esempio:
https://github.com/<organization-name>
Scegliere il tipo di autenticazione
Il connettore supporta i tipi di autenticazione seguenti:
OAuth (scelta consigliata): per usare l'autenticazione OAuth:
- Installare l'app GitHub per i problemi di GitHub nell'organizzazione GitHub.
- Scegliere un nome visualizzato che consenta agli utenti di riconoscere la connessione.
- Immettere il nome dell'organizzazione.
- Scegliere Autorizza per accedere e concedere l'accesso.
Nota
Questo metodo di autenticazione è attualmente in anteprima.
App GitHub personalizzata (per conto dell'utente): immettere l'ID client e il segreto client dall'app GitHub e autorizzare l'accesso.
App GitHub personalizzata (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.
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 Microsoft 365 Copilot.
Scegliere Crea per distribuire la connessione. Il connettore GitHub Cloud Knowledge 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 | Markdown e file di testo dai repository selezionati |
| 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 GitHub Cloud Knowledge. 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
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.
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.
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.
Scegliere i repository e i tipi di file (file Markdown, documenti di testo) che si desidera rendere ricercabile.
Gestire le proprietà
È possibile aggiungere o rimuovere proprietà, assegnare attributi dello schema e definire etichette semantica. Le proprietà seguenti sono indicizzate per impostazione predefinita:
| Proprietà | Etichetta semantica | Descrizione | Attributi dello schema |
|---|---|---|---|
| Nome del file | Titolo | Nome del file | Ricercabile, recuperabile |
| Archivio | Origine | Nome del repository GitHub | Ricercabile, con query |
| Contenuto | Corpo | Contenuto di markdown o file di testo | Ricercabile, recuperabile |
Personalizzare gli intervalli di sincronizzazione
L'intervallo di aggiornamento determina la frequenza di sincronizzazione dei dati. Valori predefiniti:
- Ricerca per indicizzazione incrementale: ogni 15 minuti
- Ricerca per indicizzazione completa: giornaliera
È possibile modificare questi valori in base alle esigenze. 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.