핸들러 내부

핸들러의 인자는 클라이언트에서 옵니다. 그 밖에 핸들러가 읽을 수 있는 것, 그리고 실행 중에 할 수 있는 모든 것은 여기에서 다룹니다.

읽을 수 있는 것은 다음과 같습니다.

• Context는 어떤 핸들러든 요청할 수 있는 유일한 추가 매개변수입니다. 진행 중인 요청, 요청 헤더, 세션, 그리고 진행률 보고와 변경 알림 메서드를 제공합니다.
• 의존성은 모델이 절대 보지 못하는 매개변수로, Resolve를 사용해 직접 작성한 함수가 값을 채웁니다.
• Lifespan은 서버가 시작할 때 한 번 만들어 두는 상태와, 핸들러가 Context를 통해 그 상태에 접근하는 방법을 다룹니다.

실행 중에 할 수 있는 일은 다음과 같습니다.

• 엘리시테이션(elicitation)으로 사용자에게 추가 입력을 요청합니다. 이를 실어 나르는 2026-07-28 패턴은 다중 왕복 요청에서 다룹니다.
• 샘플링과 루트로 클라이언트에 LLM 완성이나 작업 공간 폴더를 요청합니다. 지원 중단 예정(deprecated)이지만 여전히 제공됩니다.
• 오래 걸리는 작업의 진행률을 보고합니다.
• 로깅으로 로그를 남깁니다(서버를 운영하는 사람을 위해 표준 오류로 출력됩니다).
• 구독으로 구독 중인 클라이언트에게 변경 사항을 알립니다.

아직 핸들러를 등록하지 않았다면 도구부터 시작하세요. 이 섹션의 모든 페이지는 핸들러가 하나 있다고 가정합니다.