# 한의학 아틀라스 에이전트 사용 안내

이 문서는 검색·질의응답·연구 보조 에이전트가 한의학 아틀라스의 공개 자료를 정확히 찾고 인용하기 위한 안내입니다.

## 권장 탐색 순서

1. 새 지식의 지속 동기화에는 `GET /agent-feed.json?since={ISO-8601}`을 먼저 확인합니다. 이 피드는 사람용 본문이 재작성되기 전의 그래프·근거 변화도 알립니다.
2. `GET /api/v1/search?q={query}&limit=10`으로 대표 항목을 찾습니다.
3. 검색 결과의 `slug`로 `GET /api/v1/pages/ko/{slug}`를 조회합니다.
4. 문서의 `sources`, `relations`, `formulaRecords`, `passageRecords`, `curation`을 함께 읽습니다. `relations`는 읽기용 대표 투영이며 전체 수와 다음 조회 경로는 `relationSummary`에서 확인합니다.
5. 더 많은 관계는 `GET /api/v1/graph?slug={slug}&limit=100&offset=0`을 offset으로 넘겨 가며 조회합니다.
6. 답변에는 `https://atlas.baekrokdam.com/wiki/{slug}` 형식의 정규 문서 URL과 문서 제목을 인용합니다.

## 항목을 혼동하지 않는 법

- `formula`는 대표 처방이고 `formula_record`는 특정 의서에 실린 처방 기록입니다.
- `herb`는 약재 항목이며 처방 안의 재료 표기·용량은 별도 기록입니다.
- `work`는 의서 전체이고 `passage`는 출전 위치가 있는 개별 조문입니다.
- 이름이 같아도 출전·구성·판본이 다르면 먼저 별도 기록으로 다룹니다.

## 근거와 인용

- `sources`가 비어 있으면 외부 근거가 아직 공개 투영되지 않은 문서일 수 있습니다.
- `verificationStatus`와 `curation.maturityStage`는 최종 진리 판정이 아니라 현재 검토 상태입니다.
- 원문, 번역, 해설, 현대 의학적 판단을 서로 바꾸어 인용하지 마십시오.
- 전통 문헌의 기록을 개인별 진단·효능·복용 지침으로 제시하지 마십시오.

## 공개 베타와 대량 이용

공개 API는 사람이 읽는 과정에서 필요한 소규모·순차 조회를 위한 읽기 전용 베타입니다. 전체 목록 탐색에는 사이트맵, 검색 색인, JSON-LD 스냅숏을 우선 사용하고 같은 질의를 반복 호출하지 마십시오. 반복 수집, 지속 동기화, 다단계 그래프 탐색에는 향후 연구 프로젝트용 API 키가 필요합니다.

## 발견 문서

- Agent discovery: https://atlas.baekrokdam.com/.well-known/agent.json
- Graph change feed: https://atlas.baekrokdam.com/agent-feed.json
- OpenAPI 3.1: https://atlas.baekrokdam.com/openapi.json
- LLM index: https://atlas.baekrokdam.com/llms.txt
- Full public index: https://atlas.baekrokdam.com/llms-full.txt
- AI usage policy: https://atlas.baekrokdam.com/ai.txt
- Sitemap: https://atlas.baekrokdam.com/sitemap.xml
- Search index: https://atlas.baekrokdam.com/search-index.json
- Knowledge graph: https://atlas.baekrokdam.com/knowledge-graph.jsonld