AI 재활 코치 · 안전 경계가 있는 에이전트

코칭은 AI가, 안전 결정은 규칙이

운동 처방을 만든 LLM 연구 24편 중 14편(58%)이 금기 운동 같은 안전 결함을 보고했습니다(He et al., 2026). 그래서 VitalLens의 플래너는 도구로만 행동하고, 환자에게 가는 문장도 도구로만 보낼 수 있습니다. 모든 제안은 근거 기반의 결정론적 안전 커널을 먼저 통과합니다. 커널은 제안을 거부하거나 세션을 멈출 수 있고, 플래너는 그 결정을 뒤집을 수 없습니다.

기본 플래너는 규칙 기반(AI 아님)이라 키 없이 돌아갑니다. 같은 도구·커널로 Claude(내 API 키)나 외부 MCP 클라이언트(mcp/server.js)가 플래너 자리에 들어올 수 있습니다.

하네스 구조 — 모든 경로가 하나의 관문을 지납니다
플래너가 도구 호출과 환자에게 할 문장을 제안하면 안전 커널이 허용 또는 거부하고, 허용된 호출만 도구가 실행하며, 체크인 결과는 커널이 다시 평가해 계속·하향·재확인·중단을 결정합니다. 제안·판정·결과와 모델 메모가 해시 체인 감사 기록에 남습니다. 플래너 규칙 기반 · Claude · MCP 클라이언트 안전 커널 사전 관문: 형식·순서·범위·문장 사후 평가: 계속·하향·재확인·중단 근거 기반 규칙 · 결정론적 도구 안전 확인 · 운동 단계 정지 체크인 · STS · 안내 기록 해시 체인 감사 로그 FHIR R4 내보내기 제안 허용분만 체크인 결과 → 커널 재평가 거부 사유·허용 한계 반환 위에서 아래로: 플래너가 제안하면 안전 커널이 허용 또는 거부하고, 허용된 호출만 도구가 실행하며, 체크인 결과는 커널이 다시 평가합니다. 모든 단계가 기록에 남습니다. 플래너 규칙 기반 · Claude · MCP 제안 안전 커널 사전: 형식·순서·범위·문장 사후: 계속·하향·재확인·중단 허용분만 도구 체크인 결과는 커널이 재평가 기록 해시 체인 감사 · FHIR R4 거부되면 사유와 허용 한계가 플래너로 돌아갑니다

도구 정의는 MCP tools/list 응답 형식의 mcp/tools.json으로 공개하고, 같은 도구·커널을 여는 stdio MCP 서버(node mcp/server.js, 가상 환자)도 함께 둡니다. 같은 정의가 이 페이지의 에이전트를 구동합니다.

세션 설정

영문·숫자 12자 이내 가명(예: P01). 실명 금지. 검사 조건 감독 임상 조건

가상 환자 시나리오는 몇 초 만에 끝나며, 커널이 어떻게 개입하는지 보여줍니다.

진행 기록

세션을 실행하면 플래너의 제안, 커널의 판정, 측정 결과가 여기에 순서대로 나타납니다.

감사 기록 (0건)

각 기록은 직전 기록의 SHA-256 해시를 포함해 순서·내용의 우발적 변경과 단순 편집을 드러냅니다. 키 없는 해시 체인이라 파일을 가진 사람이 체인 전체를 다시 계산하는 위조는 막지 못하므로, 세션이 끝나면 머리 해시를 따로 보관하세요(FHIR 내보내기의 Provenance에도 들어갑니다).

머리 해시:

내려받은 감사 기록 파일 검증하기

감사 기록
#주체유형도구해시

안전 커널 규칙

수치는 가이드라인 출처와 함께 코드 한곳(SAFETY_RULES)에 있습니다. "설계 선택"이라고 적힌 값은 가이드라인 기준이 아니라 VitalLens가 보수적으로 정한 값입니다.

안전 규칙
규칙값출처

npm test가 안전 시나리오 19종, 스크립트로 만든 적대적 제안 6종(가짜 LLM 역할 — 실제 모델은 호출하지 않음), 규격 검사 6종(FHIR·MCP 형식·감사 체인)과 MCP 서버 프로토콜 검사를 자동으로 돌립니다. 실제 LLM이 이 커널을 우회하지 못한다는 증명은 아닙니다.

도구 목록 (MCP 도구 정의 형식)

도구
도구성격 · 설명

설계 근거

  • LLM 운동처방 연구의 58%에서 안전 결함 보고, 중·고위험 환자는 전문가 검토 필수 권고 — He et al., Biology of Sport, 2026. 원문 ↗
  • 사람이 AI 출력을 무시·무효화·중단할 수 있어야 한다는 인적 감독 요건 — EU AI Act 제14조. 조문 ↗
  • 식품의약품안전처, 「생성형 인공지능 의료기기 허가·심사 가이드라인」(2025-01-24). 원문 ↗
  • 심장재활에서 LLM의 적시 개입 결정 평가 — Haag et al., CHI 2025. arXiv ↗
  • 함께 읽기: 장시간 실행 에이전트를 위한 하네스 설계 — Anthropic Engineering, 2025. 글 ↗

이 페이지에서 "하네스"는 VitalLens의 작업 정의입니다: 플래너와 실제 세계 사이에서 도구 실행·권한 관문·감사 기록을 맡는 코드. 커널은 인적 감독을 대신하지 않습니다 — 중위험 환자는 의료진 승인과 실시간 감독이 있어야 세션이 열리고, 사람(환자·의료진)은 언제든 중지할 수 있습니다. 위 규정들이 "결정론적 규칙 계층"을 직접 요구하지는 않으며, 이는 인적 감독·위험 관리 요구에 대한 설계 대응입니다.

세션 전 안전 확인

오늘 운동해도 되는지, 문제가 생기면 어떻게 할지 먼저 확인합니다.

오늘 해당하는 것이 있으면 체크하세요
준비 확인

운동

0:00

정지 체크인

— 운동을 멈추고 카메라 가까이에서 얼굴을 타원 안에 맞춘 뒤 12초간 움직이지 마세요. 이 심박은 운동 직후 회복기 값이라 운동 중보다 낮게 나옵니다.

--bpm

지금 얼마나 힘든가요? (자각인지도, Borg 6–20)
지금 숨찬 정도는? (수정 Borg 0–10)
지금 다음 증상이 있나요?

30초 앉았다일어서기

팔걸이 없는 의자를 벽에 붙여 고정하세요. 팔짱을 끼고 30초 동안 완전히 일어섰다 앉기를 최대한 여러 번 반복합니다. 흉통·어지러움·심한 숨참이 생기면 즉시 멈추고 ‘증상이 있어요’를 누르세요.

0:30

안내

🛑 운동을 멈추세요