Le connecteur GitHub pour Gemini Enterprise vous permet d'effectuer des opérations de création, de mise à jour et de lecture sur des données GitHub.
Action compatible
Lorsque le data store GitHub est activé, vous pouvez utiliser des commandes en langage naturel dans Gemini Enterprise pour effectuer des actions GitHub.
Les actions GitHub suivantes qui modifient les données sont compatibles avec le data store. D'autres actions en lecture seule sont également disponibles pour des tâches telles que la recherche et la récupération de contexte.
| Action | Description |
|---|---|
| Ajouter un commentaire à un examen en attente | Ajoutez un commentaire d'examen à votre dernier examen de demande d'extraction en attente. |
| Ajouter un commentaire sur un problème | Ajoutez un commentaire à un problème ou à une demande d'extraction spécifique. |
| Créer une branche | Créez une branche dans un dépôt. |
| Créer un gist | Créez un gist GitHub. |
| Créer ou modifier un fichier | Créez ou modifiez un seul fichier dans un dépôt. |
| Fermer la notification | Marquez une notification GitHub comme lue ou terminée. |
| Dupliquer le dépôt | Dupliquez un dépôt dans votre compte ou une organisation spécifiée. |
| Gérer l'abonnement aux notifications | Ignorez, suivez ou supprimez un abonnement à un fil de notification. |
| Gérer l'abonnement aux notifications du dépôt | Ignorez, suivez ou supprimez l'abonnement aux notifications d'un dépôt. |
| Marquer toutes les notifications comme lues | Marquez toutes les notifications comme lues, éventuellement limitées à un dépôt. |
| Fusionner la demande d'extraction | Fusionnez une demande d'extraction. |
| Envoyer des fichiers | Envoyez plusieurs fichiers vers un dépôt dans un seul commit. |
| Répondre à un commentaire de demande d'extraction | Ajoutez une réponse à un commentaire de demande d'extraction existant. |
| Ajouter un dépôt aux favoris | Ajoutez un dépôt aux favoris au nom de l'utilisateur authentifié. |
| Déclencher le workflow Actions | Déclenchez un workflow GitHub Actions (exécuter, annuler ou réexécuter des tâches). |
| Retirer un dépôt des favoris | Retirez un dépôt des favoris au nom de l'utilisateur authentifié. |
| Modifier un gist | Modifiez un gist GitHub existant. |
| Modifier une demande d'extraction | Modifiez une demande d'extraction existante. |
| Rédiger un commentaire de discussion | Ajoutez, modifiez, supprimez ou marquez/démarquez un commentaire de discussion comme réponse. |
| Écrire un projet GitHub | Créez ou modifiez des projets GitHub (projet, éléments, champs, mises à jour de l'état). |
| Écrire un problème | Créez ou modifiez un problème dans un dépôt. |
| Écrire un libellé de dépôt | Créez, modifiez ou supprimez un libellé dans un dépôt. |
Autorisations requises
Pour permettre à Gemini Enterprise d'effectuer des recherches à l'aide du data store GitHub, vous devez disposer des autorisations suivantes :
| Nom de l'autorisation | Type d'autorisation | Motif de l'accès |
| Dépôt : Actions | Lecture et écriture | Déclencher, lister, annuler et réexécuter des exécutions de workflow ; accéder aux journaux des tâches |
| Dépôt : Administration | Lecture seule | Répertorier les collaborateurs du dépôt |
| Dépôt : Contenu | Lecture et écriture | Lire les fichiers, les commits, les branches, les tags et les versions ; créer des branches, écrire des fichiers, envoyer des commits et dupliquer des dépôts |
| Dépôt : Discussions | Lecture et écriture | Lire les discussions GitHub et les catégories de discussion ; ajouter, modifier ou supprimer des commentaires de discussion |
| Dépôt : Problèmes | Lecture et écriture | Lire les problèmes, les libellés et les commentaires, et rechercher des problèmes ; créer ou modifier des problèmes, publier des commentaires et gérer des libellés |
| Dépôt : Métadonnées | Lecture seule (obligatoire) | Rechercher des dépôts et des utilisateurs |
| Dépôt : Demandes d'extraction | Lecture et écriture | Lire les demandes d'extraction, les différences et les commentaires de demande d'extraction ; fusionner, modifier et ajouter des commentaires et des réponses d'examen |
| Dépôt : Alertes d'analyse du code | Lecture seule | Lire les alertes d'analyse du code |
| Dépôt : Alertes Dependabot | Lecture seule | Lire les alertes de sécurité Dependabot |
| Dépôt : Alertes d'analyse des secrets | Lecture seule | Lire les alertes d'analyse des secrets |
| Organisation : Membres | Lecture seule | Afficher les équipes de l'organisation et leurs membres |
| Organisation : Types de problèmes | Lecture seule | Afficher les types de problèmes de l'organisation |
| Organisation : Projets | Lecture et écriture | Lire et gérer les projets de niveau organisationnel v2 (projets, éléments, champs et mises à jour de l'état) |
| Compte : Favoris | Lecture et écriture | Ajouter des dépôts aux favoris et les en retirer |
| Compte : Profil | Lecture et écriture | Accéder aux informations du profil utilisateur |
Pour savoir comment configurer ces autorisations, consultez Définir des autorisations et obtenir l'ID client et le code secret du client.
Limites
Cette section décrit les problèmes connus et les limites qui peuvent affecter votre utilisation du data store GitHub.
- Lorsque vous créez une application ou que vous ajoutez un data store à une application existante, il est recommandé d'associer un seul data store à des actions appartenant à un seul type de connecteur.
- L'application d'un périmètre VPC Service Controls aux datastores GitHub existants n'est pas acceptée. Pour appliquer VPC Service Controls, vous devez supprimer et recréer les datastores. Pour en savoir plus sur VPC Service Controls et sur l'utilisation des actions après l'activation de VPC Service Controls, consultez Sécuriser votre application avec VPC Service Controls.
- Le data store GitHub n'est compatible qu'avec les
global,useteuemplacements.
Étape suivante
- Pour créer et configurer un connecteur avec GitHub, consultez Configurer un datastore GitHub.