지식 검색 (RAG)

Subaya는 검색 가능한 지식 코퍼스를 유지합니다 — 큐레이션된 참조 자료와 사용자 자신의 프로젝트 콘텐츠입니다. suya rag 명령은 사용자와 에이전트가 이로부터 검색할 수 있게 해줍니다. pgvector + 어휘 인덱스에 대한 하이브리드 검색에 더해, 청크 읽기와 상태 확인을 제공합니다.

검색

자유 텍스트 쿼리로 코퍼스를 검색합니다.

suya rag search "<query>"

기본적으로 이것은 하이브리드 검색입니다(의미론적 벡터 유사도와 어휘 매칭을 결합). 유용한 옵션은 다음과 같습니다.

suya rag search "uart ring buffer" \
  --scope curated \
  --top-k 5 \
  --semantic-only

• --scope <scope> — 검색을 특정 스코프로 제한합니다. 큐레이션된 참조 코퍼스에는 curated를, 특정 프로젝트의 콘텐츠에는 project:<id>를 사용합니다. 이 플래그는 반복 가능하므로, 여러 스코프를 동시에 검색할 수 있습니다.
• --top-k <N> — 상위 N개의 결과를 반환합니다.
• --semantic-only — 하이브리드 검색의 어휘 쪽을 건너뛰고, 의미론적(벡터) 매칭으로만 제한합니다.

청크 읽기

검색 결과는 청크입니다. id로 큐레이션된 청크의 전체 본문을 읽습니다.

suya rag read <chunk-id>

상태

무엇이 인덱싱되어 있는지 확인합니다 — 스코프별 청크 수와 마지막 인제스트 타임스탬프.

suya rag status

다음 단계

• Workspaces & projects — 검색을 위한 프로젝트 스코프.
• CLI: rag — 전체 suya rag 레퍼런스.