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 Server Knowledge Microsoft 365 Copilot consente alle organizzazioni di indicizzare Markdown e le conoscenze basate su testo dai repository di GitHub Enterprise in esperienze di ricerca Microsoft 365 Copilot e Microsoft. Questo articolo fornisce informazioni sui passaggi di configurazione che gli amministratori di GitHub devono completare prima che l'organizzazione distribuisa il connettore knowledge base di GitHub Server.
Per informazioni su come distribuire il connettore, vedere Distribuire il connettore knowledge base di GitHub Server.
Impostare l'elenco di controllo:
L'elenco di controllo seguente elenca i passaggi necessari per configurare l'ambiente e configurare i prerequisiti del connettore.
| Attività | Ruolo |
|---|---|
| Identificare il nome dell'organizzazione | Amministratore di GitHub |
| Verificare l'accesso API all'istanza di GitHub di destinazione | Amministratore di GitHub |
| Definire Microsoft Entra ID regole di mapping delle identità | Amministratore di GitHub |
| Accedere all'account GitHub | Amministratore di GitHub |
| Configurare un'app GitHub personalizzata per l'autenticazione | Amministratore di GitHub |
| Modificare il limite di frequenza delle API di GitHub Server | Amministratore di GitHub |
Identificare il nome dell'organizzazione
Determinare quale organizzazione di GitHub usare per la configurazione del connettore.
Verificare l'accesso API all'istanza di GitHub di destinazione
Verificare che l'istanza di GitHub Enterprise sia accessibile tramite API.
Definire regole di mapping Microsoft Entra ID
Assicurarsi che gli utenti che accedono ai dati di GitHub indicizzati abbiano identità di Microsoft Entra ID corrispondenti per abilitare un mapping accurato delle autorizzazioni. Le opzioni di mapping includono attributi di posta elettronica, account di accesso e nome.
Accedere all'account GitHub
Per gli utenti gestiti dall'organizzazione che eseguono l'autenticazione tramite Single Sign-On (SSO), assicurarsi che l'account sia connesso prima di configurare il connettore. Il flusso di autenticazione di GitHub attualmente non supporta l'accesso basato su SSO durante la configurazione.
Usare un'app GitHub personalizzata per l'autenticazione
Per un'esperienza di configurazione più semplificata, usare l'app GitHub gestita da Microsoft.
È anche possibile scegliere di usare la propria app GitHub per l'autenticazione. Se si sceglie questa opzione, seguire la procedura descritta nell'elenco di controllo seguente per completare l'installazione.
| Attività | Ruolo |
|---|---|
| Creare e configurare l'app GitHub | Amministratore di GitHub |
| Creare le credenziali per l'app GitHub | Amministratore di GitHub |
| Installare l'app GitHub | Amministratore di GitHub |
Creare e configurare l'app GitHub
Verificare di avere le autorizzazioni appropriate assegnate per configurare il servizio GitHub. Per altre informazioni, vedere Ruoli in un'organizzazione.
Per creare un'app GitHub da usare con il connettore knowledge base di GitHub Server:
In GitHub selezionare la foto del profilo in alto a destra, selezionare Organizzazioni e scegliere l'organizzazione da cui il connettore deve eseguire il pull dei dati.
Nella pagina panoramica dell'organizzazione selezionare Impostazioni.
Nella barra laterale sinistra scorrere verso il basso fino a Impostazioni sviluppatore e selezionare App GitHub.
Selezionare Nuova app GitHub.
Configurare l'app:
- Nome dell'app GitHub: immettere il nome desiderato.
- URL della home page: copiare l'URL dalla barra degli indirizzi del browser.
-
URL di callback:
- Per Microsoft 365 per le aziende:
https://gcs.office.com/v1.0/admin/oauth/callback - Per Microsoft 365 Per enti pubblici:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Per Microsoft 365 per le aziende:
Deselezionare l'opzione Webhook .
Impostare le autorizzazioni seguenti:
Autorizzazioni per il repository
- Contenuto - Sola lettura
- Metadati - Sola lettura
- Amministrazione - Sola lettura
Autorizzazioni dell'organizzazione
- Membri - Sola lettura
- Amministrazione - Sola lettura
Autorizzazioni dell'account
- indirizzi Email - Sola lettura
In Dove può essere installata questa app GitHub selezionare Qualsiasi account e quindi selezionare Crea app GitHub.
Creare le credenziali per l'app GitHub
Nella pagina Generale dell'app GitHub selezionare Genera un nuovo segreto client per generare e copiare il segreto client.
Installare l'app GitHub
Nella pagina Generale dell'app GitHub selezionare Installa app.
Selezionare l'organizzazione in cui si vuole installare l'app.
Modificare il limite di frequenza delle API di GitHub Server
Quando si inserisce grandi volumi di dati di GitHub, ad esempio richieste pull, problemi o file di conoscenze, la configurazione del limite di frequenza delle API nell'ambiente GitHub Server influisce direttamente sulla velocità con cui viene completato il processo di inserimento. GitHub Server applica un limite api predefinito di 15.000 richieste autenticate all'ora per utente o token. Questo limite supporta set di dati più piccoli, ma può rallentare l'inserimento quando vengono elaborati centinaia di migliaia o milioni di elementi.
Se l'organizzazione deve aumentare la velocità effettiva, è possibile aumentare il limite di velocità dell'API. I limiti più elevati consentono al connettore di recuperare gli elementi più rapidamente, ma aumentano anche il carico sull'infrastruttura di GitHub Server. Prima di aggiornare le impostazioni relative ai limiti di frequenza, verificare che l'ambiente disponga di capacità cpu, I/O di archiviazione e larghezza di banda di rete adeguati per supportare l'aumento del volume delle richieste. Dopo aver aggiornato il limite, monitorare le prestazioni del sistema per garantire l'inserimento stabile a una velocità effettiva più elevata.
Consigli per l'impostazione del limite di frequenza
Usare le indicazioni riportate nella tabella seguente per scegliere un'impostazione di limite di frequenza appropriata in base al numero approssimativo di richieste pull nell'ambiente GitHub.
| Numero approssimativo di elementi | Impostazione consigliata per il limite di frequenza | Tempo approssimativo per completare l'inserimento |
|---|---|---|
| Fino a 100.000 | Usare le impostazioni predefinite per il limite di frequenza (velocità di inserimento normale) | ND |
| Da 100.000 a 1.000.000 | Aumentare il limite di frequenza a 30.000 richieste/ora | Da 2 giorni a 1 settimana |
| 1.000.000 o più | Usare 30.000 richieste all'ora o superiore (a seconda della capacità del server) | 1-2 settimane (varia in base al carico dell'ambiente) |
Aggiornare l'impostazione relativa al limite di frequenza delle API
Per aumentare il limite di richieste API:
- Accedere all'istanza di GitHub Server con un account amministratore.
- Nell'angolo in alto a destra selezionare Amministratore sito per accedere alla modalità di amministrazione. Per altre informazioni, vedere Configurazione dei limiti di frequenza.
- Nel riquadro sinistro selezionare Console di gestione (o Amministrazione Console, a seconda della versione in uso).
- Aprire la scheda Limitazione frequenza .
- Verificare che sia selezionata l'opzione Abilita limitazione della frequenza delle API HTTP .
- In Richieste API (all'ora) - Autenticato immettere il valore del limite di frequenza ,ad esempio 30000.
- Selezionare Salva impostazioni.
Nota
Quando si salvano le modifiche, alcuni servizi di GitHub Server potrebbero riavviare e causare una breve interruzione del servizio. Dopo aver salvato, attendere che la configurazione si propaghi nell'istanza.