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 di revisione 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 gist | Crea un nuovo GitHub Gist. |
| Crea o aggiorna file | Crea o aggiorna un singolo file in un repository. |
| Ignora notifica | Contrassegna una notifica di GitHub come letta o completata. |
| Crea fork del repository | Crea un fork di un repository nel tuo account o in un'organizzazione specificata. |
| Gestisci l'iscrizione alle notifiche | Ignora, guarda o elimina un'iscrizione a un thread di notifiche. |
| Gestisci l'iscrizione alle notifiche del repository | Ignora, guarda o elimina l'iscrizione alle notifiche di un repository. |
| Segna tutte le notifiche come lette | Contrassegna tutte le notifiche come lette, facoltativamente limitate a un repository. |
| 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 il workflow di Actions | Attiva un workflow di GitHub Actions (esegui, annulla o riesegui i job). |
| Rimuovi repository da Speciali | Rimuovi un repository da Speciali per conto dell'utente autenticato. |
| Aggiorna gist | Aggiorna un GitHub Gist esistente. |
| 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 del 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: Actions | Lettura e scrittura | Attiva, elenca, annulla e riesegui le esecuzioni del workflow; accedi ai log dei job |
| Repository: Administration | 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 | Leggi le discussioni di GitHub e le categorie di discussione; aggiungi, aggiorna o elimina i commenti della discussione |
| Repository: Issues | Lettura e scrittura | Leggi problemi, etichette, commenti e cerca problemi; crea o aggiorna problemi, pubblica commenti e gestisci le etichette |
| Repository: Metadata | Sola lettura (obbligatoria) | Cerca repository e utenti |
| Repository: Pull requests | Lettura e scrittura | Leggi le richieste di pull, le differenze e i commenti delle richieste di pull; unisci, aggiorna e aggiungi commenti e risposte di revisione |
| Repository: Code scanning alerts | Sola lettura | Leggi gli avvisi di scansione del codice |
| Repository: Dependabot alerts | Sola lettura | Leggi gli avvisi di sicurezza di Dependabot |
| Repository: Secret scanning alerts | Sola lettura | Leggi gli avvisi di scansione dei secret |
| Organization: Members | Sola lettura | Visualizza i team dell'organizzazione e i relativi membri |
| Organization: Issue Types | Sola lettura | Visualizza i tipi di problemi dell'organizzazione |
| Organization: Projects | Lettura e scrittura | Leggi e gestisci i progetti v2 a livello di organizzazione (progetti, elementi, campi e aggiornamenti di stato) |
| Account: Starring | Lettura e scrittura | Aggiungi e rimuovi repository da Speciali |
| Account: Profile | Lettura e scrittura | Accedi alle informazioni del profilo utente |
Per informazioni su come configurare queste autorizzazioni, consulta 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 Controlli di servizio VPC, devi eliminare e ricreare i datastore. Per saperne di più su Controlli di servizio VPC e su come utilizzare le azioni dopo aver attivato Controlli di servizio VPC, consulta Proteggere l'app con Controlli di servizio VPC.
- Il datastore GitHub è supportato solo nelle
global,usedeulocalità.
Passaggi successivi
- Per creare e configurare un connettore con GitHub, consulta Configurare un datastore GitHub.