Panoramica
Usa questa guida se sei amministratore di un'area di lavoro ChatGPT e stai configurando il modello di app GitHub Enterprise per la tua organizzazione. Un modello non è l'app finale che i membri utilizzeranno. È una procedura di configurazione che crea una bozza di app specifica per l'area di lavoro dopo che hai fornito la configurazione GitHub Enterprise richiesta.
Per GitHub Enterprise, la configurazione collega ChatGPT all'host GitHub Enterprise della tua organizzazione. Devi creare un'app GitHub, registrare l'URL di callback di ChatGPT, generare le credenziali e poi incollare questi valori nella procedura di configurazione del modello in ChatGPT. Dopo che ChatGPT ha creato la bozza dell'app, puoi pubblicarla e gestirla come le altre app dell'area di lavoro.
Per informazioni sulla navigazione nell'area di lavoro e sull'accesso alle app, consulta: Controlli di amministrazione, sicurezza e conformità per plugin e app.
Che cosa stai configurando
Stai creando in ChatGPT un'app GitHub Enterprise specifica per la tua area di lavoro. L'app utilizza:
Un'app GitHub registrata sul tuo host GitHub Enterprise.
L'ID client e il segreto client dell'app GitHub per l'autorizzazione OAuth degli utenti.
La chiave privata dell'app GitHub, che consente a ChatGPT di generare token di installazione per le operazioni sui repository.
Un segreto e un URL del webhook, che consentono a GitHub Enterprise di inviare a ChatGPT gli eventi relativi alle installazioni e ai repository.
Il nome host di GitHub Enterprise, ad esempio
github.example.com.
Crea un'app GitHub, non un'app OAuth GitHub autonoma. La configurazione del modello in ChatGPT richiede le credenziali dell'app GitHub, una chiave privata e le impostazioni del webhook.
Prima di iniziare
Ti servono:
Accesso come amministratore o proprietario dell'area di lavoro ChatGPT.
Accesso come amministratore di GitHub Enterprise o proprietario dell'organizzazione, con la possibilità di creare e installare app GitHub.
Il solo nome host di GitHub Enterprise, senza
https://né un percorso.Una decisione sulle azioni sui repository che ChatGPT dovrà supportare, ad esempio ricerca nei repository in sola lettura, flussi di lavoro per pull request e issue, modifica di file, GitHub Actions o flussi di lavoro Codex più ampi.
Un ambiente sicuro in cui gestire la chiave privata e il segreto client dell'app GitHub.
Tieni aperti ChatGPT e GitHub Enterprise in schede separate. Non inventare l'URL di callback. Copia l'URL di callback esatto mostrato in ChatGPT.
Valori da preparare
Nome host di GitHub Enterprise: ad esempio,
github.example.com.URL di callback: copialo dalla procedura di configurazione del modello in ChatGPT.
ID client dell'app GitHub.
Segreto client dell'app GitHub.
Chiave privata PEM dell'app GitHub.
Segreto del webhook generato da ChatGPT.
URL del webhook generato dopo la creazione della bozza dell'app in ChatGPT.
Avvia la configurazione del modello in ChatGPT
In ChatGPT, passa all'area di lavoro in cui vuoi rendere disponibile l'app.
Apri Impostazioni dell'area di lavoro > App. Puoi anche accedere alla Console di amministrazione, selezionare l'area di lavoro ChatGPT desiderata e aprire Plugin. Seleziona Gestisci app legacy per aprire la pagina App della versione precedente, ancora disponibile.
Seleziona Directory.
Cerca GitHub Enterprise.
Seleziona il modello di app GitHub Enterprise e avvia la configurazione.
Inserisci un nome e una descrizione chiari per l'app, ad esempio GitHub Enterprise o GitHub Enterprise - Sviluppo.
Inserisci il nome host di GitHub Enterprise, ad esempio
github.example.com.Copia l'URL di callback mostrato in ChatGPT. Lascia aperta questa scheda.
Copia il segreto del webhook generato, se viene mostrato durante la configurazione.
Esempio di URL di callback: https://chatgpt.com/connector/oauth/<callback_id>
Non rimuovere l'ID di callback, non aggiungere una barra finale e non sostituire l'URL con un URL generico di ChatGPT.
Creare l’app GitHub in GitHub Enterprise
Apri l’host GitHub Enterprise, ad esempio
https://github.example.com.Vai all’organizzazione o all’account che dovrà essere proprietario dell’app.
Apri Impostazioni > Impostazioni sviluppatore > App GitHub.
Seleziona Nuova app GitHub.
Inserisci un nome chiaro per l’app, ad esempio ChatGPT GitHub Enterprise.
Inserisci l’URL di una pagina iniziale. Se non esiste una pagina interna dedicata, usa l’URL dell’organizzazione GitHub Enterprise.
In URL di callback, incolla l’URL di callback esatto copiato da ChatGPT.
Mantieni attiva l’opzione Fai scadere i token di autorizzazione utente, a meno che il tuo team di sicurezza non abbia un motivo specifico per modificarla.
Attiva Richiedi l’autorizzazione dell’utente durante l’installazione, in modo che gli utenti possano autorizzare l’app durante la procedura di installazione o connessione.
In Dove può essere installata questa app GitHub?, scegli l’opzione più restrittiva compatibile con il tuo piano di distribuzione.
Crea l’app GitHub.
Configura autorizzazioni ed eventi
Scegli le autorizzazioni minime necessarie per le azioni di ChatGPT che intendi abilitare.
Per individuare repository e porre domande sui loro contenuti in sola lettura, inizia con autorizzazioni di lettura come:
Metadati: sola lettura. GitHub richiede l'accesso ai metadati per le app GitHub.
Contenuti: sola lettura, per accedere ai file e ai contenuti dei repository.
Issue: sola lettura, se è necessario cercare o leggere le issue.
Pull request: sola lettura, se è necessario cercare pull request o accedere al contesto per la revisione.
Azioni: sola lettura, se è necessario accedere allo stato di esecuzione dei flussi di lavoro, ai job, ai log o agli artefatti.
Per i flussi di lavoro che prevedono la scrittura, aggiungi le relative autorizzazioni solo dove necessario, ad esempio per Contenuti, Pull request, Issue, Azioni o Flussi di lavoro. Usa le autorizzazioni più restrittive possibili che consentano le azioni di ChatGPT previste.
Gli eventi del webhook devono corrispondere ai flussi di lavoro supportati. Gli eventi più comuni includono Installazione, Repository dell'installazione, Push, Pull request, Issue, Commento a un'issue, Esecuzione del flusso di lavoro e Job del flusso di lavoro.
Genera e copia le credenziali dell'app GitHub
Nelle impostazioni dell'app GitHub, copia l'ID client.
Genera un Segreto client e copialo subito.
In Chiavi private, genera una chiave privata.
Scarica il file .pem e conservalo in modo sicuro.
Apri il file .pem in locale e copia l'intero testo PEM, comprese le righe iniziale e finale.
La chiave privata è un dato sensibile. Trattala come una credenziale. Se viene esposta, genera una nuova chiave privata, aggiorna la configurazione dell'app in ChatGPT ed elimina la chiave compromessa in GitHub Enterprise.
Completa la configurazione in ChatGPT
Torna alla scheda di configurazione del modello in ChatGPT.
Incolla l'ID client dell'app GitHub in ID client OAuth.
Incolla il segreto client dell'app GitHub in Segreto client OAuth.
Lascia invariati gli Ambiti, a meno che la tua organizzazione non abbia un'esigenza specifica di modificare le impostazioni predefinite del modello.
Verifica che il nome host di GitHub Enterprise contenga solo il nome host, ad esempio
github.example.com.Incolla o carica la chiave privata PEM dell'app GitHub nel campo Chiave privata dell'app GitHub.
Verifica che sia presente il segreto del webhook generato.
Crea la bozza dell'app.
Apri in ChatGPT i dettagli della bozza dell'app appena creata e copia l'URL del webhook generato.
L'URL del webhook dovrebbe avere questo formato: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Completa la configurazione del webhook in GitHub Enterprise
Torna alle impostazioni dell'app GitHub in GitHub Enterprise.
Apri le impostazioni generali dell'app GitHub.
Abilita l'opzione Webhook attivi se non è già abilitata.
Incolla l'URL del webhook di ChatGPT nel campo URL del webhook.
Incolla il segreto del webhook di ChatGPT nel campo Segreto del webhook.
Lascia attiva la verifica SSL.
Verifica che gli eventi a cui il webhook è sottoscritto corrispondano alle autorizzazioni e alle azioni che hai abilitato.
Salva le modifiche.
Pubblicare e gestire l’app in ChatGPT
Creare una bozza dell’app non la rende automaticamente disponibile ai membri. Dopo aver esaminato la bozza:
Pubblica la bozza dell’app.
Nelle impostazioni dell’area di lavoro, apri la pagina App, poi Abilitate e verifica che l’app sia presente. Puoi anche aprire la pagina App tramite Gestisci app legacy in Console di amministrazione > Plugin.
In Enterprise ed Edu, usa Accesso utenti per scegliere quali ruoli possono usare l’app. In Business, gestisci la disponibilità dell’app per l’intera area di lavoro.
Controlla le impostazioni di Controllo delle azioni per le azioni di lettura e scrittura.
Controlla le Autorizzazioni dell’app per scegliere quando ChatGPT deve chiedere conferma ai membri prima di usare l’app.
Chiedi a un utente di prova autorizzato di aprire App in ChatGPT e verificare che l’app sia presente.
Queste autorizzazioni dell’app si applicano alle conversazioni in ChatGPT. Gli agenti dell’area di lavoro usano controlli specifici, impostati da chi crea ciascun agente, per determinare quali azioni delle app sono disponibili e quando chiedere agli utenti finali di approvarle. Per informazioni sul comportamento degli agenti, consulta: Agenti dell’area di lavoro di ChatGPT per Enterprise e Business.
Installa e testa l'app GitHub
In GitHub Enterprise, installa l'app GitHub nell'organizzazione o nell'account.
Scegli tutti i repository o solo quelli selezionati, in base ai criteri dell'area di lavoro.
Avvia la procedura di connessione da ChatGPT come utente autorizzato.
Autorizza l'app GitHub quando richiesto.
Esegui prima una semplice azione di lettura, ad esempio elencare i repository accessibili o recuperare una pull request nota.
Se le azioni di scrittura sono abilitate, esegui un test su un repository a basso rischio prima di estendere la distribuzione.
Nome host e funzionamento di OAuth
ChatGPT usa il nome host per ricavare gli endpoint di GitHub Enterprise. Inserisci solo il nome host, ad esempio github.example.com o octocorp.ghe.com.
Non inserire un percorso API, un percorso di repository o github.com, a meno che quest'ultimo non sia l'esatto host GitHub Enterprise di questa app.
Risoluzione dei problemi
URI di reindirizzamento non corrispondente: verifica che l'URL di callback dell'app GitHub corrisponda esattamente a quello mostrato in ChatGPT.
ChatGPT non riesce a creare o salvare la bozza dell'app: verifica che tutti i campi obbligatori siano compilati, inclusi nome host, ID client OAuth, Segreto client OAuth, chiave privata e segreto del webhook.
L'autenticazione riesce ma le chiamate al repository non vanno a buon fine: verifica che l'app GitHub sia installata e abbia accesso al repository.
L'API restituisce un errore 403 o di autorizzazioni insufficienti: aggiungi l'autorizzazione mancante all'app GitHub e, se richiesto, chiedi al proprietario dell'installazione di approvare le autorizzazioni aggiornate.
Non viene visualizzato alcun repository: verifica che l'installazione dell'app includa i repository previsti e che l'utente che concede l'autorizzazione in ChatGPT vi abbia accesso.
Gli invii del webhook non vanno a buon fine: verifica che l'URL e il segreto del webhook corrispondano ai valori forniti da ChatGPT, lascia attiva la verifica SSL e assicurati che l'host GitHub Enterprise possa raggiungere
connectors.api.openai.org.Errori della chiave privata: verifica di aver copiato l'intero contenuto PEM, comprese le righe iniziale e finale.