{"meta":{"title":"후크 사용","intro":"GitHub Copilot SDK의 각 세션 후크에 대한 자세한 API 참조입니다.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/how-tos","title":"방법"},{"href":"/ko/copilot/how-tos/copilot-sdk","title":"코필로트 SDK"},{"href":"/ko/copilot/how-tos/copilot-sdk/hooks","title":"후크 사용"}],"documentType":"subcategory"},"body":"# 후크 사용\n\nGitHub Copilot SDK의 각 세션 후크에 대한 자세한 API 참조입니다.\n\n## Links\n\n* [오류 처리 후크](/ko/copilot/how-tos/copilot-sdk/hooks/error-handling)\n\n  onErrorOccurred 세션 실행 중에 오류가 발생할 때 후크가 호출됩니다. 이를 사용하여 다음을 수행합니다.\n\n* [세션 후크](/ko/copilot/how-tos/copilot-sdk/hooks/hooks-overview)\n\n  후크를 사용하면 대화 수명 주기의 주요 지점에서 Copilot 세션의 동작을 가로채고 사용자 지정할 수 있습니다. 후크를 사용하여 다음을 수행합니다.\n\n* [사후 도구 사용 후크](/ko/copilot/how-tos/copilot-sdk/hooks/post-tool-use)\n\n  onPostToolUse 도구가 성공적으로 실행된 후 후크가 호출됩니다. 이를 사용하여 다음을 수행합니다.\n\n* [사전 도구 사용 후크](/ko/copilot/how-tos/copilot-sdk/hooks/pre-tool-use)\n\n  onPreToolUse 도구가 실행되기 전에 후크가 호출됩니다. 이를 사용하여 다음을 수행합니다.\n\n* [세션 수명 주기 후크](/ko/copilot/how-tos/copilot-sdk/hooks/session-lifecycle)\n\n  세션 수명 주기 후크를 사용하면 세션 시작 및 종료 이벤트에 응답할 수 있습니다. 이를 사용하여 다음을 수행합니다.\n\n* [사용자 프롬프트 제출 후크](/ko/copilot/how-tos/copilot-sdk/hooks/user-prompt-submitted)\n\n  onUserPromptSubmitted 사용자가 메시지를 제출할 때 후크가 호출됩니다. 이를 사용하여 다음을 수행합니다.\n\n* [변환된 사용자 프롬프트 훅](/ko/copilot/how-tos/copilot-sdk/hooks/user-prompt-transformed)\n\n  userPromptTransformed 후크는 런타임이 생성된 컨텍스트를 제출된 프롬프트에 추가한 후 실행되지만 결과 콘텐츠가 세션 기록에 유지되거나 모델로 전송되기 전에 실행됩니다."}