User Manual
제품 사용 매뉴얼
한의원 AI 솔루션의 주요 기능을 단계별로 안내합니다.
궁금한 점이 있으시면 게시판에 남겨주세요.
시작하기 전 먼저 OpenAI API 키를 발급 받으세요. (platform.openai.com)
로그인 및 시작하기
대시보드에 처음 접속하는 방법을 안내합니다.
브라우저에서 hantreeai.com/dashboard/ 에 접속합니다.
발급받은 이메일과 비밀번호를 입력하고 로그인합니다.
로그인 후 대시보드 메인 화면이 표시됩니다.
환자 등록 및 예약
환자 등록과 예약은 대시보드와 연동되는 환자용 앱에서 이루어집니다. 환자가 앱에서 예약을 완료하면 대시보드 캘린더에 자동으로 반영됩니다.
환자용 앱 URL
hantreeai.com/app/
환자용 앱 사용 흐름
환자가 앱에 접속하면 한의원 코드 입력 팝업이 나타납니다. 한의원에서 안내받은 코드를 입력합니다.
이름과 전화번호를 입력하고 개인정보 수집 동의에 체크한 뒤 확인을 누릅니다. 처음 입력 시 환자로 자동 등록되고, 이후 방문 시에는 같은 이름·전화번호로 자동 로그인 됩니다.
메인 메뉴에서 예약하기를 선택합니다. 날짜를 고르면 오전·오후 시간 슬롯(30분 단위, 08:00~21:00)이 표시됩니다. 원하는 시간을 선택한 뒤 예약 등록을 누릅니다.
예약 완료 후 체질 문진과 변증 문진을 순서대로 진행하도록 안내합니다. 문진 결과는 대시보드에 자동으로 연동됩니다.
로그아웃을 원하면 우상단에 나오는 환자 이름을 클릭하세요.
대시보드 화면 구성
대시보드는 여러 패널로 구성되어 있으며, 각 패널에서 독립적으로 정보를 확인할 수 있습니다.
▲ 대시보드 전체 레이아웃 (클릭하면 크게 보입니다)
좌측 패널 — 등록된 환자 목록이 표시됩니다. 캘린더에는 해당일 예약 환자 수가 표시되고, 날짜를 클릭하면 해당일 환자가 예약 환자 목록에 나타납니다. 예약 환자의 이름을 클릭하면 해당 환자의 문진 결과가 중앙·우측 패널에 자동으로 연동되어 표시됩니다.
중앙 패널 — 위쪽에는 체질 문진 결과, 아래쪽에는 변증 문진 결과가 표시됩니다. 결과값을 다양한 그래프로 시각화해 환자 상태를 한눈에 파악할 수 있습니다. 변증 결과지를 더 넓게 보려면 체질 문진 영역을 축소하면 되고, 반대도 가능합니다. 체질 문진을 여러 번 시행한 경우 가장 최신 결과가 표시되며, 변증 문진은 과거 결과지를 전·후로 탐색해 볼 수 있습니다.
우측 패널 — AI 챗봇 — 선택한 환자의 문진 데이터가 대화에 자동으로 반영됩니다. 문진 결과 분석을 요청하면 원장님이 놓친 부분을 확인하는 데 활용할 수 있습니다. 맥진·설진·혈압 등 원장님이 직접 진료해 얻은 데이터를 함께 입력하면 환자의 모든 정보를 빠짐없이 정밀하게 분석할 수 있습니다. 해당 환자에 대하여 한의학적으로 깊이 있는 추론이 필요하거나, 보유하신 여러 처방집에서 환자에게 가장 적합한 처방을 찾을 때는 RAG 데이터베이스 검색을 함께 활용하세요.
환자 이름을 클릭하지 않은 상태에서는 AI 채팅창에 아무런 환자 정보가 입력되지 않습니다. 자유롭게 일반 상식과 한의학적 전문지식을 질문할 수 있습니다. 특히 RAG를 켜면 데이터베이스에 등록된 원전, 본초, 방제 등 AI가 사전 학습하지 못하는 많은 한의학 자료에 대하여 검색과 토론이 가능해져 학문적 깊이를 빠르게 확장할 수 있습니다.
LLM 모델 설정
AI 챗봇에서 사용할 언어 모델을 선택하는 방법을 안내합니다. RAG와 DB 검색의 임베딩 그리고 채팅까지 한번에 할 수 있어서 기본적으로 GPT 모델 사용을 권합니다. 만약 Claude 모델을 사용하실 분은 추가로 앤트로픽의 API 키를 발급 받으시기 바랍니다.
▲ 우측 처방 패널 상단의 모델 선택 드롭다운
채팅 입력창 위쪽 모델 바를 클릭하면 모델 선택 드롭다운이 열립니다.
목록에서 사용할 모델을 선택합니다. (Claude / GPT)
선택 즉시 적용됩니다. 이후 입력하는 메시지부터 선택한 모델로 응답합니다.
API 키가 없는 경우 발급 사이트로 가서 가입 → 지불 → Key 발급 과정을 거치십시오.
API Key 발급 사이트
· Claude (Anthropic) — console.anthropic.com
· GPT (OpenAI) — platform.openai.com
* 로컬 LLM 연결 안내 *
OpenAI 호환 엔드포인트를 지원하는 서버(LM Studio, Ollama 등)라면 서버 주소와 모델명만 입력하면 연결 가능합니다.
단, 아래와 같이 서버별로 CORS를 허용 설정을 해야 합니다.
· LM Studio — 서버 설정에서 CORS 활성화 버튼을 켜세요.
· Ollama — 환경변수 OLLAMA_ORIGINS=* 를 설정하고 서버를 재시작하세요.
(Windows: 시스템 환경 변수에 추가 / macOS·Linux: OLLAMA_ORIGINS=* ollama serve)
LLM 모델 활용법
대화 목적에 따라 최상위 모델과 일반 모델을 구분해 사용하면 비용을 절약하면서도 필요한 상황에서 최고의 성능을 발휘할 수 있습니다. Claude Opus 4.7을 이용하여 환자 한 명의 변증 분석과 처방 색인까지 한 번에 할 경우 대략 건당 $0.05 정도 소요됩니다.
채팅 내용은 법적인 이유로 저장되거나 서버에 전송되지 않습니다. 화면이 리프레시 되는 경우 채팅창에 있는 대화 내용 전체가 사라지니 중요한 내용은 즉시 복사해서 따로 관리 하시기 바랍니다. 같은 질문을 두 번 할 경우 비용도 두 배로 발생하니 특별히 유념하시기 바랍니다.
API 가격 안내 — 가격은 변동될 수 있으며 최신 가격은 각사 페이지에서 확인하세요.
· Claude (Anthropic) — claude.com/pricing#api
· GPT (OpenAI) — openai.com/api/pricing
최상위 모델 권장 — 변증·처방 추론, 깊이 있는 한의학 이론 분석, 복잡한 환자 케이스 종합 판단이 필요할 때 사용하세요. 높은 정확도와 추론 깊이가 필요한 작업에 적합합니다.
일반 모델 권장 — 일반 학술적 대화, 환자 교육·티칭 안내, RAG 문서나 DB 처방을 참고해서 일상적 추론을 할 경우에 적합합니다. 비용이 크게 절감됩니다.
하위 모델 권장 — "이 약재 효능이 뭐야?", "RAG 문서에서 A 내용 찾아줘", "처방 DB에 유사 처방 있어?" 같은 단순 검색 요청에 적합합니다.
시스템 프롬프트 설정
AI 챗봇의 기본 동작 방식과 응답 스타일을 한의원 환경에 맞게 설정할 수 있습니다. 시스템 프롬프트는 모든 대화에 공통으로 적용되는 지침입니다.
▲ 처방 패널의 시스템 프롬프트 입력란
채팅 전송 버튼 위쪽 기어 마크를 누르면 입력창이 팝업 됩니다.
추가 지시사항(선택) 란에 원하는 지침을 입력합니다. 예. 치료 원칙, 우선 순위, 체질 처방이나 상한 처방 우선 등.
입력 후 저장 버튼을 클릭하면 이후 대화부터 해당 지침이 모델에 전달됩니다.
처방 구성하기
처방 구성 기능 사용 방법을 안내합니다.
DB 검색
통합 DB 의미검색 기능 사용 방법을 안내합니다.
RAG 활용하기
RAG(Retrieval-Augmented Generation)는 업로드한 의료 문서를 AI 챗봇이 검색·참고하도록 하는 기능입니다. 원내 처방 프로토콜, 참고 문헌, 임상 가이드라인 등을 등록해 두면 보다 근거 있는 제안을 받을 수 있습니다.
▲ 지식베이스(RAG) 문서 업로드 및 관리 화면
채팅 입력창 위쪽 책 모양 버튼을 클릭하면 참고 자료 관리창이 팝업 됩니다. 파일 업로드를 눌러 내 PC에 있는 문서를 선택합니다. (현재 .txt와 .md 형식만 지원합니다. hwp 형식은 아래한글에서 다른 이름으로 저장하기를 눌러 텍스트 파일로 바꾸어서 올리세요. 500페이지 문서도 한 번에 업로드 가능합니다.)
업로드 완료 후 임베딩 생성 버튼을 클릭합니다. 문서 내용이 AI가 검색할 수 있는 형태로 변환됩니다.
문서 목록에서 각 문서 우측의 토글로 문서별 활성화/비활성화를 설정할 수 있습니다. 비활성화된 문서는 RAG 검색에서 제외됩니다.
우상단의 RAG 사용 토글을 켜면 이후 대화부터는 등록된 문서를 참고해서 답변합니다. 자료 참고를 원하지 않으면 토글을 끄세요.
(부록) 데이터 처리 방침
본 서비스가 수집·저장·전송하는 데이터 종류별 처리 현황을 안내합니다. 환자의 이름·전화번호 등 직접 식별 정보는 외부 AI 서버로 전송되지 않습니다.
| 데이터 종류 | 저장 위치 | 외부 AI 전송 | 보유 기간 | 비고 |
|---|---|---|---|---|
| 환자 이름·전화번호 | Supabase (DB) | ❌ 미전송 | 삭제 요청 시 | 담당 한의사만 열람 |
| 예약 정보 | Supabase (DB) | ❌ 미전송 | 삭제 요청 시 | |
| 체질감별 설문 결과 | Supabase (DB) | ✅ Anthropic·OpenAI (이름, 전화번호 제외) |
최대 30일 이내 삭제 (해당 회사 정책) |
처방 보조 기능 사용 시 전송 |
| 사강변증 설문 결과 | Supabase (DB) | ✅ Anthropic·OpenAI (이름, 전화번호 제외) |
최대 30일 이내 삭제 (해당 회사 정책) |
처방 보조 기능 사용 시 전송 |
| 환자 만족도 피드백 | Supabase (DB) | ❌ 미전송 | 삭제 요청 시 | |
| AI 대화 기록 | 브라우저 임시 저장 | ❌ 서버 미저장 | 탭 닫으면 자동 삭제 | 영구 저장 없음 |
| 저장된 한의사 처방전 (처방내용·처방명·약재·비고·의사 피드백) |
Supabase (DB) | ❌ 미전송 | 삭제 요청 시 | 한의사가 저장 버튼으로 확정한 처방 전체. 비고·피드백 자유텍스트 포함, 외부 AI 미전송 |
| DB 검색 활성화(임베딩) 시 | Supabase (벡터 DB) | ✅ OpenAI (임베딩 생성 시) |
무료 회원 — 삭제 요청 불가 유료 회원 — 삭제 요청 가능 |
통합 검색용 데이터는 익명화된 상태로 체질·변증·처방명·약재·비고·피드백 데이터만 벡터화 |
| 지식베이스(RAG) 문서 | Supabase (벡터 DB) | ✅ OpenAI (임베딩 생성 시) |
한의원 직접 삭제 | 한의원이 업로드한 문서 |
| 지식베이스(RAG) 또는 처방 DB를 AI 채팅에 이용할 경우 | 서버 저장 없음 | ✅ Anthropic·OpenAI | 최대 30일 이내 삭제 (해당 회사 정책) |
검색 결과 관련 단락이 프롬프트에 포함되어 전송. 채팅 종료 후 서버 미저장 |
| 가입 면허증 이미지 | Supabase Storage | ❌ 미전송 | 심사 완료 후 파기 | 관리자 심사용 |