12.1 R-1. SOP·매뉴얼에서 절차 질의
result = client.call_tool("retriever",
query="신규 입사자 보안 교육 절차",
mode="smart", # 일상 화면 권장
top_k=10,
filter_metadata={
"doc_classification": "SOP", # 인입 시 부여한 분류
"hl_keywords": ["보안교육", "온보딩"],
},
)mode=smart(~0.9s) — 절차 안내는 균형 모드 충분filter_metadata.doc_classification으로 SOP·매뉴얼 도메인 한정- 응답 본문의
[1][2]인라인 시테이션 +metadata.references[]를 12.6 시테이션 UI로 표시
12.2 R-2. 계약·규제에서 다중홉 근거 검색
result = client.call_tool("retriever",
query="2026 1분기 NDA 만료 임박 계약과 갱신 책임자",
mode="deep", # 정밀도 우선
top_k=10,
)mode=deep(~3.2s) — 다중홉 + 재정렬.score[]에 청크 재정렬 점수 채워짐- 응답에 노드·엣지 단위 출처 동반 — Hybrid 검색 엔진 기반 다중홉 추론
12.3 R-3. 인입 → 검색 → UI 표시 end-to-end
# 1) 인입 — 디렉토리에 미리 배치된 파일을 단건 또는 전체 인입
result = client.call_tool("index_local_files",
filename="2026_marketing_plan.pdf",
engine_slug="default",
)
print(result["processed"], result["errors"])
# 2) 검색 — 인입 직후 즉시 가능
result = client.call_tool("retriever",
query="2026 1분기 마케팅 OKR 의 KPI 측정 책임자",
mode="deep",
top_k=10,
)
# 3) UI 시테이션 매핑 — 12.6
render_citation_cards(result["content"], result["metadata"]["references"])데이터 테이블 기반 배치 인입 (index_data_files) 패턴은 14.3 폴링 예시 참조.
12.4 R-4. 호스트 LLM의 도구 카탈로그 등록
| 도구 | 권장 등록 | 사용처 |
|---|---|---|
retriever | 필수 | 모든 검색 질의 |
index_local_files | 권장 | 사용자 파일 인입 |
get_rag_status | 권장 | 인입 진행 폴링 |
get_indexed_file | 옵션 | 인입 결과 확인 |
get_entity / get_entity_edges | 옵션 | 엔티티 페이지·그래프 탐색 UI |
search_graph_labels | 옵션 | 자동완성·태그 선택 UI |
delete_document | 운영 | 사용자 문서 철회 |
12.5 R-5. Smart / Deep 모드 선택 가이드
| 화면 / 의도 | 권장 mode | 이유 |
|---|---|---|
| 일반 챗봇 응답 | smart | 0.9s 부근 — 일상 응답 적합 |
| 자동완성·인용 | smart | 빠른 응답 우선 |
| 계약·규제·SOP 정밀 | deep | 다중홉 + 재정렬, 청크별 점수 |
| 보고서 작성 보조 | deep | 인용 정확도 우선 |
| 사용자가 ⚡/🧠 토글 | 토글 값 그대로 | 호스트 UI와 1:1 매핑 |
12.6 R-6. 인라인 시테이션 + 근거 카드 UI 구성
const indices = [...content.matchAll(/\[(\d+)\]/g)].map(m => m[1]);
const cards = indices.map(idx => {
const ref = references.find(r => r.reference_id === idx);
return {
index: idx,
fileName: ref.file_path,
page: ref.page,
deepLink: buildHostDeepLink(ref.file_path, ref.page),
};
});데모 단축 스키마 ↔ 정식 스키마 매핑은 6.4 참조.