Connectez votre compte GitHub à Goodweek pour gérer les dépôts, les issues, les pull requests et les workflows directement depuis votre espace de travail IA.
ℹ️ Remarque sur la gouvernance
Goodweek ne dépassera jamais les niveaux d'accès accordés à l'utilisateur au sein de GitHub, garantissant ainsi la conformité avec les politiques de gouvernance de votre organisation. Les résultats et les fonctionnalités disponibles peuvent varier en fonction des autorisations spécifiques et de l'accès authentifié de chaque utilisateur.
📋 Prérequis
Avant qu'un utilisateur puisse voir et connecter l'intégration GitHub, l'administrateur de votre organisation doit d'abord l'activer depuis le panneau d'administration Goodweek, dans l'onglet Intégrations.
Configuration administrateur
L'intégration GitHub utilise OAuth 2.0 et ne nécessite aucune approbation au niveau administrateur pour les dépôts personnels. Cependant, l'accès aux ressources d'une organisation GitHub peut nécessiter des étapes supplémentaires.
⚠️ Restrictions des applications OAuth pour les organisations GitHub
Les organisations GitHub peuvent restreindre les applications OAuth tierces ayant accès aux données de l'organisation. Si votre organisation a activé les restrictions d'accès des applications OAuth, un propriétaire de l'organisation GitHub doit approuver Composio avant que les utilisateurs puissent accéder aux dépôts et ressources de l'organisation :
Accédez à votre organisation GitHub → Paramètres → Accès tiers → Politique des applications OAuth.
Recherchez l'application Composio et cliquez sur Approuver pour accorder l'accès à l'organisation.
Cette restriction est activée par défaut sur les nouvelles organisations GitHub. Sans approbation, les utilisateurs peuvent connecter leur compte GitHub personnel mais ne pourront pas accéder aux dépôts appartenant à l'organisation.
Connexion utilisateur
Dans Goodweek, accédez à Intégrations.
Recherchez GitHub et cliquez sur Connecter.
Vous serez redirigé vers GitHub, où il vous sera demandé de vous connecter et d'autoriser l'accès.
Cliquez sur Autoriser pour accorder l'accès et revenir à Goodweek.
Remarques importantes
Chaque utilisateur doit connecter son propre compte individuellement.
Goodweek ne peut accéder qu'aux dépôts et ressources que votre compte GitHub individuel est autorisé à voir.
L'accès aux dépôts appartenant à l'organisation nécessite que le propriétaire de l'organisation approuve Composio comme décrit ci-dessus.
Vous pouvez révoquer l'accès de Goodweek à tout moment depuis GitHub → Paramètres → Applications → Applications OAuth autorisées → Composio → Révoquer.
Outils disponibles
Outil | Description | Type |
Get a Repository | Récupère des informations détaillées sur un dépôt GitHub spécifique. | Lecture |
List Repositories for User | Répertorie les dépôts d'un utilisateur spécifié ou de l'utilisateur authentifié. | Lecture |
List Organization Repositories | Répertorie les dépôts d'une organisation GitHub spécifiée. | Lecture |
Search Repositories | Recherche des dépôts GitHub à l'aide de la syntaxe de recherche de GitHub. | Lecture |
Create a Repository | Crée un nouveau dépôt GitHub pour l'utilisateur authentifié ou l'organisation. | Écriture |
Get Repository Content | Récupère le contenu d'un fichier ou d'un répertoire dans un dépôt. | Lecture |
Create or Update File Contents | Crée un nouveau fichier ou met à jour le contenu d'un fichier existant dans un dépôt. | Écriture |
Get an Issue | Récupère une issue GitHub spécifique par dépôt et numéro d'issue. | Lecture |
List Repository Issues | Répertorie les issues d'un dépôt avec un filtrage facultatif par état, libellés et responsable. | Lecture |
Create an Issue | Crée une nouvelle issue dans un dépôt spécifié. | Écriture |
Update an Issue | Met à jour le titre, le contenu, l'état, les libellés ou les responsables d'une issue existante. | Écriture |
Add Labels to an Issue | Ajoute un ou plusieurs libellés à une issue GitHub. | Écriture |
Add Assignees to an Issue | Attribue un ou plusieurs utilisateurs à une issue GitHub. | Écriture |
Create Issue Comment | Ajoute un commentaire à une issue GitHub existante. | Écriture |
List Issue Comments | Répertorie tous les commentaires d'une issue GitHub spécifique. | Lecture |
Get a Pull Request | Récupère les détails d'une pull request spécifique. | Lecture |
List Pull Requests | Répertorie les pull requests d'un dépôt avec un filtrage facultatif par état et branche. | Lecture |
Create a Pull Request | Crée une nouvelle pull request d'une branche source vers une branche de base. | Écriture |
Update a Pull Request | Met à jour le titre, le contenu, l'état ou la branche de base d'une pull request. | Écriture |
Create a Review Comment on a Pull Request | Ajoute un commentaire de revue à une ligne spécifique d'une pull request. | Écriture |
Merge a Pull Request | Fusionne une pull request dans sa branche de base. | Écriture |
List Repository Commits | Répertorie les commits d'un dépôt avec un filtrage facultatif par auteur, chemin ou plage de dates. | Lecture |
Get a Commit | Récupère les détails d'un commit spécifique à partir de son SHA. | Lecture |
List Repository Branches | Répertorie les branches d'un dépôt spécifié. | Lecture |
Create a Branch | Crée une nouvelle branche dans un dépôt à partir d'un SHA ou d'une branche spécifiés. | Écriture |
Get a Workflow Run | Récupère les détails d'une exécution spécifique d'un workflow GitHub Actions. | Lecture |
List Workflow Runs for a Workflow | Répertorie les exécutions d'un workflow spécifié avec un filtre d'état facultatif. | Lecture |
Re-run a Workflow | Réexécute tous les jobs d'une exécution de workflow spécifiée. | Écriture |
Search Code | Recherche du code dans les dépôts GitHub à l'aide de la syntaxe de recherche de code de GitHub. | Lecture |
Search Issues and Pull Requests | Recherche des issues et des pull requests GitHub à l'aide de la syntaxe de recherche de GitHub. | Lecture |
Get a User | Récupère les informations publiques d'un utilisateur GitHub spécifié. | Lecture |
Get the Authenticated User | Récupère le profil de l'utilisateur GitHub authentifié. | Lecture |
List Organization Members | Répertorie les membres d'une organisation GitHub. | Lecture |
Close an Issue | Ferme une issue GitHub spécifiée. | ⚠️ Destructif |
Close a Pull Request | Ferme une pull request spécifiée sans la fusionner. | ⚠️ Destructif |
Delete a File | Supprime un fichier d'un dépôt. Cette action est irréversible sans l'historique de contrôle de version. | ⚠️ Destructif |
Cas d'usage
Créez et gérez des issues depuis les conversations. Enregistrez de nouvelles issues GitHub avec titre, description, libellés et responsables directement depuis une conversation Goodweek — utile pour capturer des bugs ou des demandes de fonctionnalités sans passer sur GitHub.
Passez en revue les pull requests et l'historique des commits. Récupérez les détails d'une PR, listez les commits récents ou vérifiez le statut d'une exécution de workflow depuis Goodweek pour rester au fait de l'activité du dépôt.
Recherchez du code et des issues sur tous les dépôts. Utilisez la syntaxe de recherche de GitHub depuis Goodweek pour trouver du code, des issues ou des PR spécifiques dans vos dépôts sans ouvrir l'interface GitHub.
Créez et mettez à jour des fichiers dans les dépôts. Lisez le contenu de fichiers ou envoyez de petites mises à jour de fichiers directement depuis Goodweek — utile pour mettre à jour la documentation, les fichiers de configuration ou le contenu du README.
Dépannage
Connexion réussie mais les dépôts de l'organisation sont manquants
Votre organisation GitHub a activé les restrictions d'accès des applications OAuth. Un propriétaire de l'organisation GitHub doit approuver Composio depuis les Paramètres de l'organisation → Accès tiers → Politique des applications OAuth.
Intégration non visible dans Goodweek
Assurez-vous que l'administrateur de votre organisation a activé l'intégration GitHub depuis le panneau d'administration Goodweek, dans l'onglet Intégrations.