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 GitHub.
Le seguenti azioni 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 |
|---|---|
| Aggiungere un commento alla revisione in attesa | Aggiungi un commento alla revisione dell'ultima richiesta di pull in attesa. |
| Aggiungi un commento al problema | Aggiungere un commento a un problema o a una richiesta di pull specifico. |
| Crea branch | Crea un nuovo ramo 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. |
| Unire la richiesta di pull | Unire una richiesta di pull. |
| Push dei file | Esegui il push di più file in un repository in un unico commit. |
| Rispondere al commento di una richiesta di pull | Aggiungi una risposta a un commento esistente della richiesta di pull. |
| Aggiungere un repository a Speciali | Aggiungi una stella a un repository per conto dell'utente autenticato. |
| Workflow Azioni attivatore | Attivare un flusso di lavoro GitHub Actions (eseguire, annullare o ripetere i job). |
| Problema di triage | Aggiorna le etichette, gli assegnatari o lo stato di un problema. |
| Rimuovi repository da Speciali | Rimuovi la stella da un repository per conto dell'utente autenticato. |
| Aggiorna richiesta di pull | Aggiorna una richiesta di pull esistente. |
| Scrivi un commento nella discussione | Aggiungere, rispondere, aggiornare, eliminare o contrassegnare/annullare la contrassegnazione di un commento di una discussione come risposta. |
| Scrivi progetto GitHub | Crea o aggiorna i progetti GitHub (progetto, elementi, campi, aggiornamenti dello stato). |
| Problema di scrittura | Crea o aggiorna un problema in un repository. |
| Scrittura dell'etichetta del repository | Creare, aggiornare o eliminare un'etichetta in un repository. |
Autorizzazioni obbligatorie
Per consentire a Gemini Enterprise di eseguire ricerche utilizzando il datastore GitHub, devi disporre delle seguenti autorizzazioni:
| Nome autorizzazione | Tipo di autorizzazione | Motivo dell'accesso |
| Repository: Actions | Lettura e scrittura | Attivare, elencare, annullare ed eseguire nuovamente le esecuzioni del flusso di lavoro; accedere ai log dei job |
| Repository: amministrazione | Sola lettura | Elenca i collaboratori del repository |
| Repository: Contents | Lettura e scrittura | Leggi file, commit, branch, tag e release; crea branch, scrivi file, esegui il push dei commit e crea fork dei repository |
| Repository: Discussions | Lettura e scrittura | Leggere le discussioni di GitHub e le categorie di discussione; aggiungere, aggiornare o eliminare i commenti alle discussioni |
| Repository: Issues | Lettura e scrittura | Leggi problemi, etichette, commenti e cerca problemi; crea o aggiorna problemi, pubblica commenti, esamina i problemi e gestisci le etichette |
| Repository: Metadati | Sola lettura (obbligatorio) | Cercare repository e utenti |
| Repository: richieste di pull | Lettura e scrittura | Leggi le richieste di pull, le differenze e i commenti alle richieste di pull; unisci, aggiorna e aggiungi commenti e risposte alle revisioni |
| Repository: avvisi di scansione del codice | Sola lettura | Leggere 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 | Leggere gli avvisi di scansione dei secret |
| Organizzazione: Membri | Sola lettura | Visualizzare i team dell'organizzazione e i relativi membri |
| Organizzazione: tipi di problemi | Sola lettura | Visualizzare i tipi di problemi dell'organizzazione |
| Organizzazione: progetti | Lettura e scrittura | Leggere e gestire i progetti v2 a livello di organizzazione (progetti, elementi, campi e aggiornamenti di stato) |
| Account: assegnazione di stelle | Lettura e scrittura | Aggiungere e rimuovere repository da Speciali |
| Account: profilo | Lettura e scrittura | Accedere 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 sul tuo utilizzo del datastore GitHub.
- Quando crei una nuova app o aggiungi un datastore a uno esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un unico tipo di connettore.
- L'applicazione di un perimetro 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, consulta Proteggere l'app con i Controlli di servizio VPC.
- Il datastore GitHub è supportato solo nelle località
global,useeu.
Passaggi successivi
- Per creare e configurare un connettore con GitHub, consulta Configurare un datastore GitHub.