Création de flux de travail agentiques GitHub

À propos de la création de Flux de travail GitHub pilotés par des agents

Vous pouvez créer Flux de travail GitHub pilotés par des agents avec un agent de codage (recommandé) ou manuellement. Un flux de travail est un fichier markdown dans .github/workflows/ lequel contient le frontmatter YAML pour les instructions de configuration et de langage naturel pour l’agent IA.

Pour créer un flux de travail agentique, vous définissez le flux de travail dans Markdown, compilez-le dans un .lock.yml fichier, validez les deux fichiers, puis exécutez-le via GitHub Actions des déclencheurs ou le GitHub CLI.

Cet article se concentre sur les tâches principales : création, mise à jour et réutilisation de flux de travail. Pour obtenir des détails techniques complets et des modèles supplémentaires, utilisez 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
  

• L’extension Flux de travail GitHub pilotés par des agents pour le GitHub CLI installé :

  gh extension install github/gh-aw
  

  Si vous utilisez GitHub CLI la version 2.90.0 ou ultérieure, l’exécution d’une gh aw commande vous invite à installer automatiquement l’extension si elle n’est pas encore installée.

Authentication

Vous pouvez configurer l’authentification avec votre moteur IA choisi (agent de codage) de deux façons :

• Utilisation de l’élément intégré GITHUB_TOKEN pour la facturation de l’organisation (recommandé). Cette option concerne spécifiquement le moteur GitHub Copilot et ne peut être utilisée que par des dépôts appartenant à une organisation disposant d’un forfait GitHub Copilot.
• Utilisation d’une ou d’une personal access token clé API pour les référentiels personnels et les moteurs d’IA tiers.

Utilisation de la fonctionnalité intégrée GITHUB_TOKEN

Si vous utilisez GitHub Copilot dans un dépôt appartenant à l’organisation, vous pouvez utiliser la fonctionnalité GITHUB_TOKEN intégrée de GitHub Actions au lieu d’un personal access token. Cela facture l'utilisation du flux de travail directement à votre organisation et évite la nécessité de gérer un secret personal access token pour les requêtes Copilot. Pour configurer cela :

1. L’administrateur de votre organisation doit activer la stratégie « Autoriser l’utilisation de Copilot CLI facturé à l’organisation », si ce n’est pas déjà fait, dans les paramètres de Copilot.
2. Pour les workflows que vous souhaitez imputer à une organisation, indiquez copilot-requests: write dans l’en-tête du workflow permissions.

Activation de la facturation de l’organisation

« Autoriser l’utilisation de Copilot CLI facturée à l’organisation » doit être activée dans les paramètres de stratégie GitHub Copilot. Si la stratégie « Copilot CLI » est déjà activée, la stratégie de facturation est activée par défaut.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la barre latérale, cliquez sur Copilot****Stratégies.

5. Activez « Copilot CLI », puis activez « Autoriser l’utilisation d’Copilot CLI facturée à l’organisation ».

Facturation d’un flux de travail à une organisation

Lors de la création d’un flux de travail, vous devez inclure copilot-requests: write sous permissions dans l’en-tête du flux de travail. Lorsque cette autorisation est définie, le jeton GitHub Actions' est utilisé pour les requêtes Copilot, et COPILOT_GITHUB_TOKEN est ignoré pour ces requêtes. Si le jeton GitHub Actions ne dispose pas d’un accès GitHub Copilot au sein de l’organisation, le flux de travail échoue au moment de l’envoi de requêtes à Copilot, et vous devez configurer COPILOT_GITHUB_TOKEN à la place.

permissions:
  contents: read
  copilot-requests: write

Utilisation d’une clé personal access token ou d’une clé API

Pour les dépôts personnels ou les moteurs d’IA tiers, vous devez créer un secret du dépôt contenant un personal access token ou une clé API. Pour GitHub Copilot, le secret est COPILOT_GITHUB_TOKEN, qui stocke un personal access token granulaire.

Si vous utilisez gh aw add-wizard, le flux d’installation vous invite à créer ce secret. Si vous créez un flux de travail agentique à partir de l’interface web GitHub ou manuellement, vous devrez d’abord ajouter vous-même le secret dans les secrets GitHub Actions de votre dépôt, soit dans l’interface utilisateur GitHub, soit avec gh aw secrets set en ligne de commande. Pour obtenir des instructions, consultez la référence d’authentification.

Création d’un workflow

La méthode recommandée pour créer Flux de travail agentiques consiste à utiliser un agent de codage CLI ou VS Code. Cela vous donne un chemin guidé pour la création, la compilation et la validation du flux de travail.

Utilisation d’un agent de codage CLI ou VS Code

1. À l’aide de l’extension GitHub CLIFlux de travail GitHub pilotés par des agents (gh aw), initialisez le référentiel pour la rédaction agentique (recommandé pour la configuration initiale dans un référentiel) :

   gh aw init
   

   Cela ajoute des compétences, des instructions et un agent personnalisé lié à la création de flux de travail agentique, afin que les agents de codage puissent créer et modifier des flux de travail plus efficacement.

2. Démarrez votre agent de codage dans le contexte de votre référentiel (par exemple, Copilot pour CLI ou en mode agent VS Code).

3. Saisissez un prompt mentionnant la compétence agentic-workflows et décrivant le flux de travail souhaité :

   Copilot prompt

   /agentic-workflows Create a new workflow that creates a daily report on
   recent activity in the repository, delivered as
   an issue.
   

4. L’agent crée le flux de travail et compile le flux de travail à l’aide du GitHub CLI.

5. Passez en revue le flux de travail, puis demandez à l’agent de valider et d’envoyer (push) les fichiers.

6. Déclenchez le flux de travail à partir de l’onglet GitHub Actions ou avec l’exécution GitHub CLI :

   gh aw run YOUR-WORKFLOW-NAME
   

Autres méthodes de création

Vous pouvez également créer des flux de travail agentiques :

• Dans l’interface web GitHub. Consultez création de flux de travail dans l’interface web GitHub.
• Manuellement. Consultez la création de flux de travail en modifiant manuellement.

Informations de référence sur la structure de flux de travail

Chaque fichier markdown de flux de travail comporte deux parties :

Rubrique	Purpose
Frontmatter YAML	Définit des déclencheurs (on), des autorisations, des sorties sécurisées et le moteur IA.
Corps en Markdown	Instructions en langage naturel que l’agent IA suit lorsque le flux de travail s’exécute.

Champs frontmatter clés :

Champ	Description
on	Le déclencheur d’événement (même syntaxe que les déclencheurs GitHub Actions).
permissions	Autorisations du dépôt accordées à l’agent. La valeur par défaut est read-all.
safe-outputs	Les opérations d’écriture que l’agent est autorisé à effectuer (par exemple, create-issue, add-comment, create-pull-request).
engine	Le moteur d’IA à utiliser (copilot est la valeur par défaut ; claude, codexet gemini sont également pris en charge).

Pour obtenir la référence complète du frontmatter, consultez la Flux de travail GitHub pilotés par des agents documentation du frontmatter.

Exemple de flux de travail agentique

L’exemple suivant est un rapport d’activité de problème hebdomadaire simplifié pour un référentiel.

---
on: weekly on monday

permissions:
  issues: read
  copilot-requests: write

network: defaults

tools:
  github:
    toolsets: [issues]

safe-outputs:
  create-issue:

---

# Weekly issue activity report

Review issue activity from the last 7 days in this repository.

Create a GitHub issue that includes:

- Total issues opened and closed this week.
- The top recurring themes from issue titles and descriptions.
- A short list of notable issues that still need attention.
- Two or three actionable recommendations for maintainers.

Keep the report concise and action-oriented.

Mise à jour d’un flux de travail

Pour mettre à jour un flux de travail existant :

1. Modifiez le fichier markdown du flux de travail dans .github/workflows/.

2. Recompilez pour actualiser le fichier de verrouillage :

   gh aw compile
   

3. Validez et envoyez (push) les deux fichiers mis à jour.

4. Ouvrez une pull request et vérifiez les contrôles GitHub Actions.

Pour obtenir des conseils d’édition détaillés, consultez Modification des flux de travail.

Réutilisation des flux de travail

Vous pouvez également importer des flux de travail à partir de référentiels externes auxquels vous pouvez accéder. Par exemple, vous pouvez ajouter un flux de travail à partir de githubnext/agentics:

gh aw add-wizard githubnext/agentics/daily-repo-status

Pour une installation en mode non interactif, vous pouvez utiliser gh aw add et, si vous le souhaitez, fixer une version.

Lorsque vous importez un flux de travail, GitHub CLI stocke une source: valeur dans frontmatter afin de pouvoir effectuer une mise à jour en amont ultérieurement avec gh aw update.

Importez uniquement des flux de travail à partir de sources approuvées et passez en revue ce qu’un flux de travail fait avant de l’ajouter à votre référentiel. Les flux de travail marqués private: true ne peuvent pas être importés dans d’autres référentiels.

Lorsque vous mettez à jour un flux de travail importé, GitHub CLI tente de conserver les modifications locales. S’il y a des conflits de fusion, résolvez-les et exécutez gh aw compile à nouveau.

Pour plus d’informations, consultez Réutilisation des flux de travail.

Étapes suivantes

• Pour obtenir des exemples de flux de travail, des modèles avancés, des guides et des informations de dépannage, consultez le Flux de travail GitHub pilotés par des agents site de documentation.