문서 인덱싱

라이브러리 문서 사이트나 사내 문서 폴더를 이 컴퓨터에 색인하고, 에이전트가 search_docs로 찾아 출처와 함께 답하게 하는 방법.

무엇을 하나

에이전트는 학습한 시점 이후에 바뀐 API나 사내 규칙을 모릅니다. 문서 도구에서 문서를 색인해 두면 에이전트가 추측하는 대신 search_docs 도구로 해당 구절을 찾아 읽고, 출처 URL이나 파일 경로를 붙여 답합니다. 색인한 문서 목록은 시스템 프롬프트에도 들어가서, 에이전트가 언제 찾아봐야 하는지 압니다.

문서 추가

사이트 추가: 문서의 시작 주소(예: https://docs.example.com/guide/)를 넣습니다. 같은 사이트의 같은 경로 아래 페이지만, 최대 200페이지까지 가져옵니다. 사이트의 robots.txt(Disallow, Crawl-delay)를 지킵니다.
폴더 추가: 사내 문서 폴더를 고릅니다. .md, .mdx, .txt, .rst, .adoc, .html 파일을 최대 2,000개(파일당 1MB)까지 읽고, node_modules, .git, dist 같은 폴더는 건너뜁니다.

색인 중에는 진행 상황(페이지 수, 조각 수)이 보이고, 끝나면 "준비됨"으로 바뀝니다. 문서가 바뀌면 다시 인덱싱을 누릅니다.

검색 방식

페이지는 약 1,200자 단위 조각으로 나뉘고, 조각마다 BM25 점수로 검색합니다. 한국어는 단어 안의 두 글자 묶음으로도 찾기 때문에 띄어쓰기가 달라도 맞습니다. 임베딩 모델이나 서버를 쓰지 않으므로 비용이 없고, 색인과 검색 모두 이 컴퓨터에서 일어납니다. 색인은 ~/.level11/docs에 저장됩니다.

화면 아래의 검색 테스트로 에이전트가 받게 될 결과를 미리 볼 수 있습니다.

에이전트별로 끄기

에이전트 편집에서 "인덱싱한 문서를 search_docs로 검색하게 함"을 끄면 그 에이전트는 문서 검색 도구를 받지 않습니다.

한계

자바스크립트로만 내용을 그리는 문서 사이트는 본문이 비어 있을 수 있습니다. 그런 사이트는 저장소의 문서 폴더를 대신 색인하세요.
로그인이 필요한 페이지는 가져오지 못합니다.