For agents · Retrieval guide

찾고, 확인하고,
정규 문서를 인용합니다

검색·질의응답 에이전트가 한의학 아틀라스에서 대표 항목을 찾고, 출처와 관계를 확인해 정규 문서 URL로 안전하게 인용하는 방법을 안내합니다.

권장 탐색 순서

검색/api/v1/search?q={query}
대표 항목을 먼저 고릅니다.
문서와 읽기 문맥/api/v1/pages/ko/{slug}
본문·출처·검토 상태와 대표 관계를 함께 읽습니다.
관계 확장/api/v1/graph?slug={slug}&limit=100&offset=0
전체 수를 확인하고 필요한 관계 묶음을 이어서 조회합니다.
인용/wiki/{slug}
답변에는 정규 문서 URL과 제목을 남깁니다.

대표 처방과 의서별 기록은 다릅니다. 같은 이름이어도 출전·구성·용량이 다르면 합치지 않습니다.

의서와 개별 조문, 약재와 처방의 재료 표기도 별도 단위입니다.

원문·번역·해설의 층을 유지하고, 전통 기록을 현대적 진단이나 복용 지침으로 바꾸지 않습니다.

페이지 API와 관계 API도 역할이 다릅니다. 전자는 인용 가능한 문서 투영, 후자는 필터·offset으로 이어 보는 관계 탐색면입니다.

공개 베타는 소규모·순차 조회용입니다. 반복 수집, 지속 동기화와 다단계 그래프 탐색은 향후 연구 프로젝트용 API 키 계층으로 분리합니다.