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 avis en attente | Ajoutez un commentaire à votre dernier examen de demande d'extraction en attente. |
| Ajouter un commentaire à un problème | Ajoutez un commentaire à un problème ou à demande d'extraction spécifique. |
| Créer une branche | Créez une branche dans un dépôt. |
| Créer ou modifier un fichier | Créez ou mettez à jour un seul fichier dans un dépôt. |
| Dupliquer le dépôt | Dupliquez un dépôt dans votre compte ou dans une organisation spécifique. |
| Fusionner la demande d'extraction;extraction | Fusionnez une demande d'extraction. |
| Envoyer des fichiers | Transférez plusieurs fichiers vers un dépôt en un seul commit. |
| Répondre à un commentaire demande d'extraction d'extraction | Ajoutez une réponse à un commentaire existant sur une demande d'extraction;extraction. |
| Ajouter un dépôt aux favoris | Ajoutez un dépôt à vos favoris au nom de l'utilisateur authentifié. |
| Workflow "Déclencher des actions" | Déclencher un workflow GitHub Actions (exécuter, annuler ou réexécuter des tâches) |
| Problème de triage | Mettez à jour les libellés, les responsables ou l'état d'un problème. |
| Retirer un dépôt des favoris | Supprime le suivi d'un dépôt au nom de l'utilisateur authentifié. |
| Mettre à jour une demande d'extraction;extraction | Mettez à jour une demande d'extraction existante. |
| Rédiger un commentaire dans une discussion | Ajouter, modifier, supprimer un commentaire de discussion, y répondre ou le marquer/démarquer comme réponse |
| Écrire un projet GitHub | Créez ou mettez à jour des projets GitHub (projets, éléments, champs, mises à jour de l'état). |
| Problème d'écriture | 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 relancer des exécutions de workflow ; accéder aux journaux de tâches |
| Dépôt : Administration | Lecture seule | Lister les collaborateurs du dépôt |
| Dépôt : contenu | Lecture et écriture | Lire des fichiers, des commits, des branches, des tags et des versions ; créer des branches, écrire des fichiers, transmettre 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 mettre à jour des problèmes, publier des commentaires, trier des problèmes 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 diffs et les commentaires sur les demandes d'extraction ; fusionner, mettre à jour et ajouter des commentaires et des réponses |
| 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 dans Projects v2 (projets, éléments, champs et mises à jour de l'état) |
| Compte : ajouter une étoile | Lecture et écriture | Ajouter et supprimer des dépôts des favoris |
| Compte : profil | Lecture et écriture | Accéder aux informations du profil utilisateur |
Pour savoir comment configurer ces autorisations, consultez Définir les autorisations et obtenir l'ID client et le code secret du client.
Limites
Cette section décrit les problèmes et les limites connus qui peuvent affecter votre utilisation du data store GitHub.
- Lorsque vous créez une application ou ajoutez un data store à une application existante, nous vous recommandons d'associer un seul data store aux actions appartenant à un seul type de connecteur.
- L'application d'un périmètre VPC Service Controls aux datastores GitHub existants n'est pas prise en charge. 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 emplacements
global,useteu.
Étapes suivantes
- Pour créer et configurer un connecteur avec GitHub, consultez Configurer un datastore GitHub.