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 à un examen en attente | Ajoutez un commentaire d'examen à votre dernier examen de demande d'extraction en attente. |
| Ajouter un commentaire de 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 ou mettre à jour un fichier | Créez ou mettez à jour un seul fichier dans un dépôt. |
| Dupliquer un dépôt | Dupliquez un dépôt dans votre compte ou dans une organisation spécifiée. |
| Fusionner une 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 un workflow d'actions | Déclenchez un workflow GitHub Actions (exécuter, annuler ou réexécuter des tâches). |
| Trier un problème | Mettez à jour les libellés, les responsables ou l'état d'un problème. |
| Supprimer un dépôt des favoris | Supprimez un dépôt des favoris au nom de l'utilisateur authentifié. |
| Mettre à jour une demande d'extraction | Mettez à jour une demande d'extraction existante. |
| Rédiger un commentaire de discussion | Ajoutez, mettez à jour, supprimez ou marquez/démarquez un commentaire de discussion comme réponse. |
| Écrire un projet GitHub | Créez ou mettez à jour des projets GitHub (projet, éléments, champs, mises à jour d'état). |
| Écrire un problème | Créez ou mettez à jour un problème dans un dépôt. |
| Écrire un libellé de dépôt | Créez, mettez à jour 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éclenchez, listez, annulez et réexécutez des exécutions de workflow ; accédez aux journaux des tâches |
| Dépôt : Administration | Lecture seule | Répertoriez les collaborateurs du dépôt |
| Dépôt : Contenu | Lecture et écriture | Lisez les fichiers, les commits, les branches, les tags et les versions ; créez des branches, écrivez des fichiers, envoyez des commits et dupliquez des dépôts |
| Dépôt : Discussions | Lecture et écriture | Lisez les discussions GitHub et les catégories de discussion ; ajoutez, mettez à jour ou supprimez des commentaires de discussion |
| Dépôt : Problèmes | Lecture et écriture | Lisez les problèmes, les libellés et les commentaires, et recherchez des problèmes ; créez ou mettez à jour des problèmes, publiez des commentaires, triez les problèmes et gérez les libellés |
| Dépôt : Métadonnées | Lecture seule (obligatoire) | Recherchez des dépôts et des utilisateurs |
| Dépôt : Demandes d'extraction | Lecture et écriture | Lisez les demandes d'extraction, les différences et les commentaires de demande d'extraction ; fusionnez, mettez à jour et ajoutez des commentaires et des réponses d'examen |
| Dépôt : Alertes d'analyse du code | Lecture seule | Lisez les alertes d'analyse du code |
| Dépôt : Alertes Dependabot | Lecture seule | Lisez les alertes de sécurité Dependabot |
| Dépôt : Alertes d'analyse des secrets | Lecture seule | Lisez les alertes d'analyse des secrets |
| Organisation : Membres | Lecture seule | Affichez les équipes de l'organisation et leurs membres |
| Organisation : Types de problèmes | Lecture seule | Affichez les types de problèmes de l'organisation |
| Organisation : Projets | Lecture et écriture | Lisez et gérez les projets v2 au niveau de l'organisation (projets, éléments, champs et mises à jour d'état) |
| Compte : Favoris | Lecture et écriture | Ajoutez et supprimez des dépôts des favoris |
| Compte : Profil | Lecture et écriture | Accédez 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 et limites connus 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 régions
global,useteu.
Étape suivante
- Pour créer et configurer un connecteur avec GitHub, consultez Configurer un datastore GitHub.