Skip to main content

Votre premier flux de travail agentique

Obtenez votre première automatisation basée sur l’IA en cours d’exécution à l’aide d’un workflow prédéfini et de l’interface CLI GitHub.

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ée

    Pour 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 :

  1. Vérifiez les prérequis du référentiel.
  2. Invitez-vous à sélectionner un moteur IA (Copilot est la valeur par défaut, ou choisissez parmi d’autres moteurs).
  3. 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_KEY ou GEMINI_API_KEY. Consultez l’article de référence sur l’authentification pour obtenir des instructions d’installation.
  4. Générez le fichier markdown du flux de travail et compilez le fichier correspondant .lock.yml .
  5. Ouvrez une pull request incluant les deux fichiers générés dans .github/workflows/.
  6. 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 :

  1. Ouvrez .github/workflows/daily-repo-status.md dans votre référentiel.

  2. 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.

  3. Si vous avez modifié la configuration frontmatter, recompilez le flux de travail :

    gh aw compile
    
  4. Validez vos modifications et poussez-les.

  5. Vous pouvez éventuellement déclencher une autre exécution :

    gh aw run daily-repo-status
    

Étapes suivantes