{"meta":{"title":"Hooks de session","intro":"Les hooks vous permettent d’intercepter et de personnaliser le comportement des sessions Copilot aux points clés du cycle de vie de la conversation. Utilisez des crochets pour :","product":"GitHub Copilot","breadcrumbs":[{"href":"/fr/copilot","title":"GitHub Copilot"},{"href":"/fr/copilot/how-tos","title":"Procédures"},{"href":"/fr/copilot/how-tos/copilot-sdk","title":"Kit de développement logiciel (SDK) Copilot"},{"href":"/fr/copilot/how-tos/copilot-sdk/hooks","title":"Utiliser des crochets"},{"href":"/fr/copilot/how-tos/copilot-sdk/hooks/hooks-overview","title":"Vue d’ensemble des hooks"}],"documentType":"article"},"body":"# Hooks de session\n\nLes hooks vous permettent d’intercepter et de personnaliser le comportement des sessions Copilot aux points clés du cycle de vie de la conversation. Utilisez des crochets pour :\n\n\n\n\n\n* **Exécution de l’outil de contrôle** : approuver, refuser ou modifier des appels d’outil\n* **Transformer les résultats** - modifier les sorties de l’outil avant qu’elles ne soient traitées\n* **Ajouter un contexte** - injecter des informations supplémentaires au début de la session\n* **Gérer les erreurs** - Implémenter la gestion des erreurs personnalisée\n* **Audit et journal** - suivre toutes les interactions pour la conformité\n\n## Crochets disponibles\n\n| Hook | Déclencheur | Cas d’usage |\n| --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------- |\n| [Hook exécuté avant l’utilisation d’un outil](/fr/copilot/how-tos/copilot-sdk/hooks/pre-tool-use) | Avant qu'un outil ne s'exécute | Contrôle d’autorisation, validation des arguments |\n| [Hook exécuté après l’utilisation d’un outil](/fr/copilot/how-tos/copilot-sdk/hooks/post-tool-use) | Une fois qu’un outil s’exécute (réussite uniquement) | Transformation des résultats, journalisation |\n| [Hook exécuté après l’utilisation d’un outil](/fr/copilot/how-tos/copilot-sdk/hooks/post-tool-use#failure-variant) | Après une exécution d’outil dont le résultat était un échec | Ajouter des instructions de nouvelle tentative, journaliser les échecs |\n| [Hook déclenché à la soumission d’un prompt utilisateur](/fr/copilot/how-tos/copilot-sdk/hooks/user-prompt-submitted) | Lorsque l’utilisateur envoie un message | Modification de l’invitation, filtrage |\n| [Hook transformé par l’utilisateur](/fr/copilot/how-tos/copilot-sdk/hooks/user-prompt-transformed) | Après la transformation de l’invite d’exécution | Examiner ou remplacer le contenu destiné au modèle |\n| [Hooks du cycle de vie de la session](/fr/copilot/how-tos/copilot-sdk/hooks/session-lifecycle#session-start) | La session commence | Ajouter un contexte, configurer une session |\n| [Hooks du cycle de vie de la session](/fr/copilot/how-tos/copilot-sdk/hooks/session-lifecycle#session-end) | Fin de session | Nettoyage, analyse |\n| [Hook de gestion des erreurs](/fr/copilot/how-tos/copilot-sdk/hooks/error-handling) | Une erreur se produit | Gestion des erreurs personnalisée |\n| [Hooks du cycle de vie de la session](/fr/copilot/how-tos/copilot-sdk/hooks/session-lifecycle#agent-stop) | L’agent de niveau supérieur s’arrête naturellement | Valider l’achèvement ou demander un autre tour |\n\n## Démarrage rapide\n\n
\n
TypeScript
\n\n```typescript\nimport { CopilotClient } from \"@github/copilot-sdk\";\n\nconst client = new CopilotClient();\n\nconst session = await client.createSession({\n hooks: {\n onPreToolUse: async (input) => {\n console.log(`Tool called: ${input.toolName}`);\n // Allow all tools\n return { permissionDecision: \"allow\" };\n },\n onPostToolUse: async (input) => {\n console.log(`Tool result: ${JSON.stringify(input.toolResult)}`);\n return null; // No modifications\n },\n onSessionStart: async (input) => {\n return { additionalContext: \"User prefers concise answers.\" };\n },\n },\n});\n```\n\n
\n\n
Python
\n\n```python\nfrom copilot import CopilotClient\nfrom copilot.session import PermissionHandler\n\nasync def main():\n client = CopilotClient()\n await client.start()\n\n async def on_pre_tool_use(input_data, invocation):\n print(f\"Tool called: {input_data['toolName']}\")\n return {\"permissionDecision\": \"allow\"}\n\n async def on_post_tool_use(input_data, invocation):\n print(f\"Tool result: {input_data['toolResult']}\")\n return None\n\n async def on_session_start(input_data, invocation):\n return {\"additionalContext\": \"User prefers concise answers.\"}\n\n session = await client.create_session(on_permission_request=PermissionHandler.approve_all, hooks={\n \"on_pre_tool_use\": on_pre_tool_use,\n \"on_post_tool_use\": on_post_tool_use,\n \"on_session_start\": on_session_start,\n })\n```\n\n
\n\n
Go
\n\n```golang\npackage main\n\nimport (\n \"context\"\n \"fmt\"\n copilot \"github.com/github/copilot-sdk/go\"\n)\n\nfunc main() {\n client := copilot.NewClient(nil)\n\n session, _ := client.CreateSession(context.Background(), &copilot.SessionConfig{\n Hooks: &copilot.SessionHooks{\n OnPreToolUse: func(input copilot.PreToolUseHookInput, inv copilot.HookInvocation) (*copilot.PreToolUseHookOutput, error) {\n fmt.Printf(\"Tool called: %s\\n\", input.ToolName)\n return &copilot.PreToolUseHookOutput{\n PermissionDecision: \"allow\",\n }, nil\n },\n OnPostToolUse: func(input copilot.PostToolUseHookInput, inv copilot.HookInvocation) (*copilot.PostToolUseHookOutput, error) {\n fmt.Printf(\"Tool result: %v\\n\", input.ToolResult)\n return nil, nil\n },\n OnSessionStart: func(input copilot.SessionStartHookInput, inv copilot.HookInvocation) (*copilot.SessionStartHookOutput, error) {\n return &copilot.SessionStartHookOutput{\n AdditionalContext: \"User prefers concise answers.\",\n }, nil\n },\n },\n })\n _ = session\n}\n```\n\n
\n\n
.NET
\n\n```csharp\nusing GitHub.Copilot;\n\nvar client = new CopilotClient();\n\nvar session = await client.CreateSessionAsync(new SessionConfig\n{\n Hooks = new SessionHooks\n {\n OnPreToolUse = (input, invocation) =>\n {\n Console.WriteLine($\"Tool called: {input.ToolName}\");\n return Task.FromResult(\n new PreToolUseHookOutput { PermissionDecision = \"allow\" }\n );\n },\n OnPostToolUse = (input, invocation) =>\n {\n Console.WriteLine($\"Tool result: {input.ToolResult}\");\n return Task.FromResult(null);\n },\n OnSessionStart = (input, invocation) =>\n {\n return Task.FromResult(\n new SessionStartHookOutput { AdditionalContext = \"User prefers concise answers.\" }\n );\n },\n },\n});\n```\n\n
\n\n
Java
\n\n```java\nimport com.github.copilot.*;\nimport com.github.copilot.rpc.*;\nimport java.util.concurrent.CompletableFuture;\n\ntry (var client = new CopilotClient()) {\n client.start().get();\n\n var hooks = new SessionHooks()\n .setOnPreToolUse((input, invocation) -> {\n System.out.println(\"Tool called: \" + input.getToolName());\n return CompletableFuture.completedFuture(PreToolUseHookOutput.allow());\n })\n .setOnPostToolUse((input, invocation) -> {\n System.out.println(\"Tool result: \" + input.getToolResult());\n return CompletableFuture.completedFuture(null);\n })\n .setOnSessionStart((input, invocation) -> {\n return CompletableFuture.completedFuture(\n new SessionStartHookOutput(\"User prefers concise answers.\", null)\n );\n });\n\n var session = client.createSession(\n new SessionConfig()\n .setHooks(hooks)\n .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n ).get();\n}\n```\n\n
\n\n
\n\n## Contexte d’appel de hook\n\nChaque hook reçoit un `invocation` paramètre avec le contexte de la session active :\n\n| Champ | Catégorie | Description |\n| ----------- | --------- | ----------------------- |\n| `sessionId` | string | ID de la session active |\n\nCela permet aux hooks de maintenir l’état ou d’effectuer une logique spécifique à la session.\n\n## Modèles courants\n\n### Journalisation de tous les appels d’outils\n\n```typescript\nconst session = await client.createSession({\n hooks: {\n onPreToolUse: async (input) => {\n console.log(`[${new Date().toISOString()}] Tool: ${input.toolName}, Args: ${JSON.stringify(input.toolArgs)}`);\n return { permissionDecision: \"allow\" };\n },\n onPostToolUse: async (input) => {\n console.log(`[${new Date().toISOString()}] Result: ${JSON.stringify(input.toolResult)}`);\n return null;\n },\n },\n});\n```\n\n### Blocage des outils dangereux\n\n```typescript\nconst BLOCKED_TOOLS = [\"shell\", \"bash\", \"exec\"];\n\nconst session = await client.createSession({\n hooks: {\n onPreToolUse: async (input) => {\n if (BLOCKED_TOOLS.includes(input.toolName)) {\n return {\n permissionDecision: \"deny\",\n permissionDecisionReason: \"Shell access is not permitted\",\n };\n }\n return { permissionDecision: \"allow\" };\n },\n },\n});\n```\n\n### Ajout d’un contexte utilisateur\n\n```typescript\nconst session = await client.createSession({\n hooks: {\n onSessionStart: async () => {\n const userPrefs = await loadUserPreferences();\n return {\n additionalContext: `User preferences: ${JSON.stringify(userPrefs)}`,\n };\n },\n },\n});\n```\n\n## Guides de fixation\n\n* **[Hook exécuté avant l’utilisation d’un outil](/fr/copilot/how-tos/copilot-sdk/hooks/pre-tool-use)** - Contrôler les autorisations d’exécution de l’outil\n* **[Hook exécuté après l’utilisation d’un outil](/fr/copilot/how-tos/copilot-sdk/hooks/post-tool-use)** - Transformer les résultats de l’outil\n* **[Hook déclenché à la soumission d’un prompt utilisateur](/fr/copilot/how-tos/copilot-sdk/hooks/user-prompt-submitted)** - Modifier les invites de l’utilisateur\n* **[Hook transformé par l’utilisateur](/fr/copilot/how-tos/copilot-sdk/hooks/user-prompt-transformed)** - Remplacer les prompts destinés au modèle\n* **[Hooks du cycle de vie de la session](/fr/copilot/how-tos/copilot-sdk/hooks/session-lifecycle)** - Début et fin de session\n* **[Hooks du cycle de vie de la session](/fr/copilot/how-tos/copilot-sdk/hooks/session-lifecycle#agent-stop)** - Valider que l’opération est terminée avant que l’agent ne s’arrête\n* **[Hook de gestion des erreurs](/fr/copilot/how-tos/copilot-sdk/hooks/error-handling)** - Gestion des erreurs personnalisée\n\n## Voir aussi\n\n* [Créez votre première application avec Copilot](/fr/copilot/how-tos/copilot-sdk/getting-started)\n* [Créez votre première application avec Copilot](/fr/copilot/how-tos/copilot-sdk/getting-started#step-4-add-a-custom-tool)\n* [Guide de débogage](/fr/copilot/how-tos/copilot-sdk/troubleshooting/debugging)"}