{"meta":{"title":"Personnaliser des flux de travail d’agent avec des hooks","intro":"Exécutez des contrôles automatisés, tels que le linting, le formatage ou les analyses de sécurité, à des étapes clés de l'exécution de l'agent afin de garantir le respect des normes de qualité.","product":"GitHub Copilot","breadcrumbs":[{"href":"/fr/copilot","title":"GitHub Copilot"},{"href":"/fr/copilot/how-tos","title":"Procédures"},{"href":"/fr/copilot/how-tos/copilot-on-github","title":"Copilot sur GitHub"},{"href":"/fr/copilot/how-tos/copilot-on-github/customize-copilot","title":"Personnaliser Copilot"},{"href":"/fr/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent","title":"Personnaliser cloud agent"},{"href":"/fr/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/use-hooks","title":"Utiliser des crochets"}],"documentType":"article"},"body":"# Personnaliser des flux de travail d’agent avec des hooks\n\nExécutez des contrôles automatisés, tels que le linting, le formatage ou les analyses de sécurité, à des étapes clés de l'exécution de l'agent afin de garantir le respect des normes de qualité.\n\nLes hooks vous permettent d’étendre et de personnaliser le comportement de GitHub Copilot agents en exécutant des commandes shell personnalisées aux points clés pendant l’exécution des agents. Pour obtenir une vue d’ensemble conceptuelle des hooks, y compris les détails des déclencheurs de hook disponibles, consultez [À propos des crochets pour GitHub Copilot](/fr/copilot/concepts/agents/hooks).\n\n## Création d’un hook dans un référentiel sur GitHub\n\n1. Créez un `NAME.json` fichier (où `NAME` décrit l’objectif du fichier) dans le `.github/hooks/` dossier de votre dépôt.\n\n > \\[!IMPORTANT]\n > Le fichier de configuration des hooks **doit être présent** sur la branche par défaut de votre référentiel à utiliser par Copilot cloud agent.\n\n2. Dans votre éditeur de texte, copiez et collez le modèle de hook suivant. Supprimez les éléments que vous ne prévoyez pas d’utiliser dans le tableau `hooks`.\n\n ```json copy\n {\n \"version\": 1,\n \"hooks\": {\n \"sessionStart\": [...],\n \"sessionEnd\": [...],\n \"userPromptSubmitted\": [...],\n \"preToolUse\": [...],\n \"postToolUse\": [...],\n \"errorOccurred\": [...]\n }\n }\n ```\n\n3. Configurez la syntaxe de votre hook sous les clés `bash` et `powershell`, ou référencez directement les fichiers de script que vous avez créés.\n\n > \\[!NOTE]\n > Incluez à la fois une clé `bash` (avec un script pour Linux et macOS) et une clé `powershell` (pour un script pour Windows) afin d’autoriser les hooks à s’exécuter sur les trois systèmes d’exploitation.\n > Copilot utilise la clé appropriée en fonction du système d’exploitation de l’utilisateur.\n\n * Cet exemple exécute un script qui génère la date de début de la session dans un fichier journal à l’aide du `sessionStart` hook :\n\n ```json copy\n \"sessionStart\": [\n {\n \"type\": \"command\",\n \"bash\": \"echo \\\"Session started: $(date)\\\" >> logs/session.log\",\n \"powershell\": \"Add-Content -Path logs/session.log -Value \\\"Session started: $(Get-Date)\\\"\",\n \"cwd\": \".\",\n \"timeoutSec\": 10\n }\n ],\n ```\n\n * Cet exemple appelle un script externe `log-prompt` :\n\n ```json copy\n \"userPromptSubmitted\": [\n {\n \"type\": \"command\",\n \"bash\": \"./scripts/log-prompt.sh\",\n \"powershell\": \"./scripts/log-prompt.ps1\",\n \"cwd\": \"scripts\",\n \"env\": {\n \"LOG_LEVEL\": \"INFO\"\n }\n }\n ],\n ```\n\n Pour obtenir une référence complète sur l’entrée JSON à partir de sessions d’agent, ainsi que des exemples de scripts, consultez [Références sur les hooks GitHub Copilot](/fr/copilot/reference/hooks-reference).\n\n4. Validez le fichier dans le référentiel et fusionnez-le dans la branche par défaut. Vos hooks s’exécuteront désormais pendant les sessions de l’agent.\n\n## Résolution des problèmes\n\nSi vous rencontrez des problèmes à l’aide de crochets, utilisez le tableau suivant pour résoudre les problèmes.\n\n| Problème | Action |\n| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Les hooks ne s’exécutent pas | |\n\\| Les crochets expirent | |\n\\| Sortie JSON non valide | |\n\n## Débogage\n\nVous pouvez déboguer des hooks à l’aide des méthodes suivantes :\n\n* **Activez la journalisation détaillée** dans le script pour inspecter les données d’entrée et tracer l'exécution du script.\n\n ```shell copy\n #!/bin/bash\n set -x # Enable bash debug mode\n INPUT=$(cat)\n echo \"DEBUG: Received input\" >&2\n echo \"$INPUT\" >&2\n # ... rest of script\n ```\n\n* **Testez les hooks localement** en redirigeant l’entrée de test dans votre hook pour valider son comportement :\n\n ```shell copy\n # Create test input\n echo '{\"timestamp\":1704614400000,\"cwd\":\"/tmp\",\"toolName\":\"bash\",\"toolArgs\":\"{\\\"command\\\":\\\"ls\\\"}\"}' | ./my-hook.sh\n\n # Check exit code\n echo $?\n\n # Validate output is valid JSON\n ./my-hook.sh | jq .\n ```\n\n## Lectures complémentaires\n\n* [Références sur les hooks GitHub Copilot](/fr/copilot/reference/hooks-reference)\n* [À propos de GitHub Copilot agent cloud](/fr/copilot/concepts/agents/cloud-agent/about-cloud-agent)\n* [À propos de GitHub Copilot CLI](/fr/copilot/concepts/agents/copilot-cli/about-copilot-cli)\n* [Configurer l’environnement de développement](/fr/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment)"}