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. Des actions supplémentaires 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 à l'examen en attente | Ajoutez un commentaire à votre dernière demande d'extraction en attente d'examen. |
| Ajouter un commentaire au 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 un gist | Créez un Gist GitHub. |
| Créer ou mettre à jour un fichier | Créez ou mettez à jour un seul fichier dans un dépôt. |
| Fermer la notification | Marquer une notification GitHub comme lue ou terminée. |
| Dupliquer le dépôt | Dupliquez un dépôt dans votre compte ou dans une organisation spécifiée. |
| Gérer l'abonnement aux notifications | Ignorer, surveiller ou supprimer un abonnement à un fil de notification. |
| Gérer l'abonnement aux notifications de dépôt | Ignorer, surveiller ou supprimer l'abonnement aux notifications d'un dépôt. |
| Marquer toutes les notifications comme lues | Marquer toutes les notifications comme lues, éventuellement limitées à un dépôt. |
| Fusionner la demande d'extraction;extraction | Fusionner une demande d'extraction. |
| Transférer des fichiers | Transférer plusieurs fichiers vers un dépôt en un seul commit. |
| Répondre au commentaire de la demande d'extraction d'extraction | Ajouter une réponse à un commentaire de demande d'extraction existant. |
| Ajouter le dépôt aux favoris | Ajouter un dépôt aux favoris pour le compte de l'utilisateur authentifié. |
| Workflow de déclenchement d'actions | Déclencher un workflow GitHub Actions (exécuter, annuler ou réexécuter des jobs) |
| Retirer le dépôt des favoris | Désactiver le suivi d'un dépôt au nom de l'utilisateur authentifié. |
| Mettre à jour le gist | Mettre à jour un Gist GitHub existant. |
| Mettre à jour la demande d'extraction;extraction | Mettre à jour une demande d'extraction existante. |
| Rédiger un commentaire de discussion | Ajouter, modifier, supprimer ou marquer/démarquer comme réponse un commentaire de discussion, ou y répondre. |
| Écrire un projet GitHub | Créer ou mettre à jour des projets GitHub (projet, éléments, champs, mises à jour d'état). |
| Problème d'écriture | Créez ou mettez à jour un problème dans un dépôt. |
| Écrire un libellé de dépôt | Créer, modifier ou supprimer une étiquette sur 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 jobs |
| Dépôt : Administration | Lecture seule | Lister les collaborateurs d'un 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, pousser 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 et gérer les 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 sur les demandes d'extraction ; fusionner, mettre à jour 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 de 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 v2 au niveau de l'organisation (projets, éléments, champs et mises à jour d'état) |
| Compte : suivi | Lecture et écriture | Ajouter des dépôts aux favoris et les retirer des favoris |
| 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 susceptibles d'affecter votre utilisation du data store GitHub.
- Lorsque vous créez une application ou ajoutez un data store à une application existante, nous vous recommandons de n'associer qu'un seul data store aux actions appartenant à un seul type de connecteur.
- Il n'est pas possible d'appliquer un périmètre VPC Service Controls aux datastores GitHub existants. 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.