Il connettore GitHub per Gemini Enterprise ti consente di eseguire operazioni di creazione, aggiornamento e lettura sui dati di GitHub.
Azioni supportate
Quando il datastore GitHub è abilitato, puoi utilizzare i comandi in linguaggio naturale in Gemini Enterprise per eseguire azioni di GitHub.
Le seguenti azioni di GitHub che modificano i dati sono supportate dal datastore. Sono disponibili anche altre azioni di sola lettura per attività come la ricerca e il recupero del contesto.
| Azione | Descrizione |
|---|---|
| Aggiungi commento alla revisione in attesa | Aggiungi un commento alla revisione della richiesta di pull in attesa più recente. |
| Aggiungi commento al problema | Aggiungi un commento a un problema o a una richiesta di pull specifica. |
| Crea branch | Crea un nuovo branch in un repository. |
| Crea o aggiorna file | Crea o aggiorna un singolo file in un repository. |
| Crea un fork del repository | Crea un fork di un repository nel tuo account o in un'organizzazione specificata. |
| Unisci richiesta di pull | Unisci una richiesta di pull. |
| Esegui il push dei file | Esegui il push di più file in un repository in un unico commit. |
| Rispondi al commento della richiesta di pull | Aggiungi una risposta a un commento esistente della richiesta di pull. |
| Aggiungi repository a Speciali | Aggiungi un repository a Speciali per conto dell'utente autenticato. |
| Attiva flusso di lavoro Azioni | Attiva un flusso di lavoro di GitHub Actions (esegui, annulla o riesegui i job). |
| Triage del problema | Aggiorna le etichette, gli assegnatari o lo stato di un problema. |
| Rimuovi repository da Speciali | Rimuovi un repository da Speciali per conto dell'utente autenticato. |
| Aggiorna richiesta di pull | Aggiorna una richiesta di pull esistente. |
| Scrivi commento alla discussione | Aggiungi, rispondi, aggiorna, elimina o contrassegna/rimuovi il contrassegno come risposta a un commento della discussione. |
| Scrivi progetto GitHub | Crea o aggiorna i progetti GitHub (progetto, elementi, campi, aggiornamenti di stato). |
| Scrivi problema | Crea o aggiorna un problema in un repository. |
| Scrivi etichetta repository | Crea, aggiorna o elimina un'etichetta in un repository. |
Autorizzazioni obbligatorie
Per consentire a Gemini Enterprise di eseguire la ricerca utilizzando il datastore GitHub, devi disporre delle seguenti autorizzazioni:
| Nome autorizzazione | Tipo di autorizzazione | Motivo dell'accesso |
| Repository: Azioni | Lettura e scrittura | Attiva, elenca, annulla e riesegui le esecuzioni del flusso di lavoro; accedi ai log dei job |
| Repository: Amministrazione | Sola lettura | Elenca i collaboratori del repository |
| Repository: Contenuti | Lettura e scrittura | Leggi file, commit, branch, tag e release; crea branch, scrivi file, esegui il push dei commit e crea un fork dei repository |
| Repository: Discussioni | Lettura e scrittura | Leggi le discussioni di GitHub e le categorie di discussione; aggiungi, aggiorna o elimina i commenti della discussione |
| Repository: Problemi | Lettura e scrittura | Leggi problemi, etichette, commenti e cerca problemi; crea o aggiorna problemi, pubblica commenti, esegui il triage dei problemi e gestisci le etichette |
| Repository: Metadati | Sola lettura (obbligatoria) | Cerca repository e utenti |
| Repository: Richieste di pull | Lettura e scrittura | Leggi le richieste di pull, le differenze e i commenti delle richieste di pull; unisci, aggiorna e aggiungi commenti e risposte alle revisioni |
| Repository: Avvisi di scansione del codice | Sola lettura | Leggi gli avvisi di scansione del codice |
| Repository: Avvisi di Dependabot | Sola lettura | Leggi gli avvisi di sicurezza di Dependabot |
| Repository: Avvisi di scansione dei secret | Sola lettura | Leggi gli avvisi di scansione dei secret |
| Organizzazione: Membri | Sola lettura | Visualizza i team dell'organizzazione e i relativi membri |
| Organizzazione: Tipi di problemi | Sola lettura | Visualizza i tipi di problemi dell'organizzazione |
| Organizzazione: Progetti | Lettura e scrittura | Leggi e gestisci i progetti v2 a livello di organizzazione (progetti, elementi, campi e aggiornamenti di stato) |
| Account: Aggiunti a Speciali | Lettura e scrittura | Aggiungi e rimuovi repository da Speciali |
| Account: Profilo | Lettura e scrittura | Accedi alle informazioni del profilo utente |
Per informazioni su come configurare queste autorizzazioni, vedi Impostare le autorizzazioni e ottenere l'ID client e il client secret.
Limitazioni
Questa sezione descrive i problemi noti e le limitazioni che potrebbero influire sull'utilizzo del datastore GitHub.
- Quando crei una nuova app o aggiungi un datastore a una esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un singolo tipo di connettore.
- L'applicazione di un perimetro di Controlli di servizio VPC ai datastore GitHub esistenti non è supportata. Per applicare i Controlli di servizio VPC, devi eliminare e ricreare i datastore. Per saperne di più sui Controlli di servizio VPC e su come utilizzare le azioni dopo averli abilitati, vedi Proteggere l'app con i Controlli di servizio VPC.
- Il datastore GitHub è supportato solo nelle
global,usedeulocalità.
Passaggi successivi
- Per creare e configurare un connettore con GitHub, vedi Configurare un datastore GitHub.