가이드 / 검색
가이드 / search
검색
인용 id가 붙은 섹션 검색, 그리고 앱으로 넘기는 검색 실패.
수정 2026년 11월 20일편집 docs seed버전 1
동작 방식#
색인은 메모리에 있고 게시된 문서로 만들어요. 한국어(조사, 어미, 2글자 조각)를 이해하고, cms://docs/install#create-the-tables 같은 인용 id가 붙은 섹션을 돌려줘요.
const { hits } = await cms.search(actor, "설치 테이블", { collections: ["docs"] });REST로는 GET /api/cms/search?q=…&collections=docs,guides예요.
검색 실패#
검색 결과가 없으면 agent-cms가 앱에 알려 주고, 무엇을 저장할지는 앱이 정해요.
createCms({
onSearchMiss: async (e) => {
// { query, normalized, collections, actor, source, at, nearest }
if (e.actor.kind === "anonymous") return;
await saveMiss(e);
},
});호출하는 쪽이 요청했을 때만 불려요(search(…, { reportMiss: true }), GET /search?miss=1, read_for_answer). 기다리지 않고, 오류는 onError로 가요. normalized는 조사와 어순을 무시하니까 이 값으로 묶으세요.
tip
이 사이트는 검색 실패를 자기 테이블 site_search_misses에 모으고, extraNav로 더한 어드민 화면에서 보여 줘요.