Remarque
Flux de travail GitHub pilotés par des agents are in préversion publique and subject to change.
Présentation
Flux de travail GitHub pilotés par des agents vous permet d’automatiser les tâches de référentiel à l’aide de flux de travail alimentés par l’IA. Pour obtenir une vue d’ensemble de Flux de travail GitHub pilotés par des agents, consultez À propos des flux de travail agentiques GitHub.
Dans ce guide, vous allez ajouter un flux de travail agentique prédéfini , un rapport d’état de référentiel quotidien, à un référentiel existant. Cela prend environ 10 minutes et vous fournit un exemple concret d’agents automatisés s’exécutant dans GitHub Actions.
Ce guide de démarrage rapide se concentre sur l’exécution de votre premier flux de travail. Pour obtenir des conseils d’installation et de résolution des problèmes plus approfondis, consultez le Flux de travail GitHub pilotés par des agents site de documentation.
Prerequisites
Avant de commencer, assurez-vous d’avoir :
-
Un compte IA : GitHub Copilot, Anthropic Claude, OpenAI Codexou Google Gemini
-
Un GitHub référentiel sur lequel vous avez un accès en écriture
-
GitHub Actions activé pour le dépôt
-
GitHub CLI (
gh) v2.0.0 ou version ultérieure installée et authentifiéePour vérifier votre version, exécutez
gh --version. Pour vous authentifier, exécutez :gh auth login --scopes repo,workflow
Vous pouvez suivre ce guide de démarrage rapide avec n’importe quel moteur pris en charge. GitHub Copilot est le moteur par défaut et un GitHub Copilot plan n’est requis que lorsque vous le choisissez.
Les systèmes d’exploitation pris en charge sont Linux, macOS et Windows avec WSL.
Étape 1 : Installer l’extension gh aw
Installez l’extension Flux de travail GitHub pilotés par des agents pour :GitHub CLI
gh extension install github/gh-aw
Étape 2 : Ajouter un workflow et déclencher une exécution
À partir de la racine de votre référentiel, exécutez :
gh aw add-wizard githubnext/agentics/daily-repo-status
La add-wizard commande accepte les références de flux de travail au OWNER/REPO/WORKFLOW-NAME format. Ce processus interactif :
- Vérifiez les prérequis du référentiel.
- Invitez-vous à sélectionner un moteur IA (Copilot est la valeur par défaut, ou choisissez parmi d’autres moteurs).
- Guidez-vous à travers la configuration du secret et de l’authentification pour votre moteur choisi. Selon le moteur choisi, l’assistant peut vous demander de configurer
COPILOT_GITHUB_TOKEN,ANTHROPIC_API_KEY,OPENAI_API_KEYouGEMINI_API_KEY. Consultez l’article de référence sur l’authentification pour obtenir des instructions d’installation. - Générez le fichier markdown du flux de travail et compilez le fichier correspondant
.lock.yml. - Ouvrez une pull request incluant les deux fichiers générés dans
.github/workflows/. - Passez vous-même en revue la pull request et fusionnez-la, ou choisissez un workflow qui la fusionne à votre place.
Une fois le flux de travail créé, vous serez invité à l’exécuter immédiatement. Sélectionnez Oui pour déclencher le flux de travail.
Étape 3 : Attendre que le flux de travail se termine
Une exécution automatisée de flux de travail prend généralement 2 à 3 minutes. Une fois terminé, un nouveau problème s’affiche dans votre référentiel avec un rapport d’état quotidien qui analyse :
- Activité récente du référentiel (problèmes, demandes de tirage, discussions, mises en production)
- Suivi de la progression et points forts
- Étapes suivantes actionnables pour les responsables de maintenance
Étape 4 : Personnaliser le flux de travail (facultatif)
Vous pouvez modifier le flux de travail pour qu’il corresponde à vos priorités :
-
Ouvrez
.github/workflows/daily-repo-status.mddans votre référentiel. -
Modifiez le corps Markdown afin d’indiquer ce que vous souhaitez voir figurer dans le rapport : votre backlog d’anomalies, la configuration CI, les tests, les performances ou la feuille de route.
-
Si vous avez modifié la configuration frontmatter, recompilez le flux de travail :
gh aw compile -
Validez vos modifications et poussez-les.
-
Vous pouvez éventuellement déclencher une autre exécution :
gh aw run daily-repo-status
Étapes suivantes
- Pour créer votre propre fichier personnalisé Flux de travail agentiques, consultez Création de flux de travail agentiques GitHub.
- Pour connaître les modèles avancés et la référence complète, consultez le Flux de travail GitHub pilotés par des agents site de documentation.