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 Knowledge Connector di GitHub Server integra le conoscenze di GitHub Enterprise in Microsoft 365, consentendo a Copilot e Microsoft Search di visualizzare pagine wiki, file markdown e blog pertinenti direttamente all'interno di app come Teams, Outlook e SharePoint. Questo articolo descrive i passaggi per distribuire e personalizzare il connettore.
Per informazioni sulla configurazione di GitHub, vedere Configurare il servizio GitHub per l'inserimento del connettore.
Prerequisiti
Prima di distribuire il connettore Knowledge Connector di GitHub Server, assicurarsi che l'ambiente GitHub sia configurato nell'organizzazione. La tabella seguente riepiloga i passaggi per configurare l'ambiente GitHub e distribuire il connettore:
| Attività | Ruolo |
|---|---|
| Configurare l'ambiente GitHub | 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, assicurarsi che:
- L'utente è un amministratore di Microsoft 365.
- L'istanza di GitHub Enterprise è accessibile tramite API.
- Viene creata e installata un'app GitHub con le autorizzazioni necessarie.
- L'account utente usato per l'autenticazione ha accesso ai repository e alle conoscenze da indicizzare.
- Gli utenti che accedono ai dati indicizzati di GitHub hanno identità Microsoft Entra ID corrispondenti per il mapping delle autorizzazioni.
- Microsoft Graph Connector Agent viene installato in un dispositivo con accesso all'istanza di GitHub (versione 3.1.11.0 o successiva).
Distribuire il connettore
Per aggiungere il connettore knowledge base di GitHub Server 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 Server Knowledge.From the list of available connectors, choose GitHub Server 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 Server Knowledge o personalizzarlo in base a un nome riconosciuto dagli utenti dell'organizzazione.
Impostare l'URL dell'istanza
Immettere l'URL dell'istanza del server GitHub Enterprise. Questo URL è in genere il formato seguente:
https://github.<your-domain>.com
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. Si noti che questo tipo di autenticazione è attualmente in anteprima. Per usare questo tipo di autenticazione, contattare il supporto tecnico Microsoft.
Per informazioni su come creare un'app GitHub, vedere Usare un'app GitHub personalizzata per l'autenticazione.
Distribuire a un pubblico limitato
Distribuire questa connessione a una base di utenti limitata se si vuole convalidarla in Copilot e Microsoft Search prima di espandere l'implementazione. Per altre informazioni, vedere Implementazione temporanea per i connettori Copilot.
Scegliere Crea per distribuire la connessione. Il connettore knowledge base di GitHub Server avvia immediatamente l'indicizzazione del contenuto.
Dopo aver creato la connessione, è possibile esaminare lo stato nella sezione Connettori del interfaccia di amministrazione di Microsoft 365.
Nella tabella seguente sono elencati i valori predefiniti impostati quando si distribuisce il connettore.
| Categoria | Valore predefinito |
|---|---|
| Utenti | Autorizzazioni di accesso impostate su Solo gli utenti con accesso a questa origine dati. |
| Contenuto | Indicizzare i file Markdown e la documentazione di testo dai repository selezionati. |
| Sincronizza | Ricerca per indicizzazione incrementale ogni 15 minuti; ricerca per indicizzazione completa ogni giorno. |
Per personalizzare questi valori, scegliere Configurazione personalizzata. È possibile modificare le autorizzazioni utente, gestire i mapping delle proprietà e modificare gli intervalli di sincronizzazione.
Personalizzare le impostazioni (facoltativo)
È possibile personalizzare i valori predefiniti per le impostazioni del connettore knowledge base di GitHub Server. Per personalizzare le impostazioni, nella pagina del connettore nell'interfaccia di amministrazione scegliere Configurazione personalizzata.
Personalizzare le impostazioni utente
Autorizzazioni di accesso
Scegliere tra:
- Solo gli utenti con accesso a questa origine dati (impostazione predefinita)
- Tutti
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 BYOU (anziché Enterprise Managed Users), ogni utente deve abilitare l'autorizzazione per condividere il campo di identità utente specifico necessario per il mapping nelle impostazioni dell'account GitHub per consentire il mapping delle identità.
Personalizzare le impostazioni del contenuto
Scegliere i repository e i tipi di file (file Markdown e documentazione di testo) che si desidera rendere ricercabile.
Gestire le proprietà
È possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati GitHub, assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà.
Intervalli di sincronizzazione
L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore. Di seguito sono riportati i valori predefiniti:
- Ricerca per indicizzazione incrementale: ogni 15 minuti
- Ricerca per indicizzazione completa: giornaliera
È possibile modificare queste impostazioni predefinite nella scheda Sincronizza . Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.