clinics 튜토리얼

clinics.csv를 설명하는 Markdown 문서를 지식 관리에 올리고 필요한 내용을 검색합니다. 이 실습은 CSV 데이터로 대시보드 만들기를 마친 뒤 진행하는 선택 실습입니다. 빠른 시작의 완료 범위에는 포함되지 않습니다.

준비 사항

• D.Hub 계정과 문서를 추가할 수 있는 컬렉션
• 빠른 시작에서 만든 my_first_project 컬렉션
• clinics 데이터 설명서

이 실습은 키워드 검색만으로도 결과를 확인할 수 있습니다. 시맨틱 검색도 사용하려면 지식 생성 화면에 임베딩 모델 선택지가 있어야 합니다. 채팅 단계는 사용할 수 있는 LLM 모델이 있을 때만 진행합니다.

실습용 합성 데이터

clinics.csv와 데이터 설명서는 D.Hub 기능을 익히기 위한 합성 데이터입니다. 실제 의료기관 정보나 검체 채취 가능 여부를 확인하는 데 사용하지 않습니다.

1. 샘플 내려받기

1. clinics 데이터 설명서를 내려받습니다.
2. 데이터 설명서가 clinics.csv의 필드와 20개 예시 행을 설명하는지 확인합니다.

CSV는 빠른 시작에서 데이터셋과 지도 대시보드를 만드는 데 사용합니다. 이 실습에서는 같은 데이터를 설명하는 Markdown 파일을 검색용 문서로 사용합니다.

2. 지식 만들기

1. 사이드바에서 AI → 지식 관리를 선택합니다.
2. 목록 오른쪽 위의 생성을 클릭합니다.
3. 이름에 clinics_guide를 입력하고 컬렉션에서 my_first_project를 선택합니다.
4. 검색 옵션에서 키워드 검색을 선택합니다.
5. 의미가 비슷한 표현도 검색하려면 시맨틱 검색을 함께 선택하고 임베딩 모델을 지정합니다.
6. 생성을 클릭합니다.

지식이 만들어지면 clinics_guide 상세 화면의 문서 탭이 열립니다.

3. Markdown 문서 올리기

1. 문서 탭에서 문서 추가 → 파일 업로드를 선택합니다.
2. 파일 업로드 단계에서 clinics-data-guide.md를 추가합니다. 자동으로 입력된 문서 이름을 확인하고 다음을 클릭합니다.
3. 청킹 설정 단계에서 기본 설정을 유지하고 청크 미리보기에 제목과 필드 설명이 표시되는지 확인한 뒤 다음을 클릭합니다.
4. 검토 및 제출 단계에서 파일, 청킹 설정, 검색 모드를 확인합니다. 키워드 검색만 활성화했다면 키워드 전용으로 표시됩니다.
5. 파일 업로드를 클릭합니다.

업로드 뒤에는 문서 목록으로 돌아갑니다. clinics-data-guide의 상태가 완료로 바뀔 때까지 기다립니다. 처리 중이 오래 유지되거나 실패로 바뀌면 문서 행에서 오류를 확인합니다.

4. 검색 결과 확인하기

1. 검색 탭을 선택합니다.
2. 다음 질문을 하나씩 입력하고 검색을 실행합니다.
3. 결과에 clinics-data-guide.md가 표시되는지 확인합니다.
4. 결과의 원문 청크를 열어 표에 적힌 내용과 일치하는지 확인합니다.

검색 질문	기대하는 내용
검체 채취 가능 여부를 확인하려면 어떤 필드를 봐야 하나요?	sample_available 필드와 Y·N의 의미가 표시됩니다.
지도에 기관 위치를 표시하려면 어떤 필드를 사용하나요?	latitude와 longitude 필드가 표시됩니다.
지역별로 필터링할 때 사용하는 필드는 무엇인가요?	sido, sigungu, dong 필드가 표시됩니다.

검색 결과가 없으면 문서 상태가 완료인지 먼저 확인합니다. 키워드 검색에서는 sample_available, latitude처럼 문서에 들어 있는 정확한 필드명으로 다시 검색합니다.

5. 채팅으로 답변 확인하기 (선택)

사용할 수 있는 LLM 모델이 있을 때만 이 단계를 진행합니다.

1. 채팅 탭을 선택합니다.
2. 검색에서 사용한 질문 중 하나를 입력합니다.
3. 답변 아래에 표시된 clinics-data-guide.md 출처 버튼을 클릭합니다.
4. 출처가 clinics-data-guide.md이고 인용 원문이 답변과 일치하는지 확인합니다.

채팅 모델이 없어도 검색 탭에서 세 질문의 결과와 원문 청크를 확인하면 실습이 끝납니다. 채팅 답변은 합성 데이터 설명을 요약한 결과입니다. 실제 의료 정보로 사용하지 않습니다.

완료 결과

• my_first_project 컬렉션에 clinics_guide 지식이 있습니다.
• 문서 탭에서 clinics-data-guide 상태가 완료로 표시됩니다.
• 검색 탭에서 필드 설명과 clinics-data-guide.md 원문을 확인할 수 있습니다.
• 채팅 모델이 있다면 답변의 인용에서 같은 원문을 확인할 수 있습니다.

검색 방식과 결과 범위를 더 조정하려면 검색 결과 확인하기와 청킹 및 검색 옵션을 확인합니다.