테넌트 가이드

스페이스와 지식

격리가 어떻게 동작하는지, 그리고 검색이 예리하게 유지되도록 문서를 조직하는 방법.

스페이스: 프라이버시 경계

모든 엔드유저의 데이터는 스페이스에 삽니다. 스페이스는 세 가지를 스코프합니다: 채팅 세션, 문서, 장기 메모리. 스코핑은 애플리케이션 코드가 아니라 Postgres row-level security로 강제되므로, 한 고객의 대화가 다른 고객의 컨텍스트로 결코 샐 수 없습니다.

에이전트는 멤버로 추가됐을 때만 스페이스에 참여합니다. 빈 스페이스는 아무에게도 답하지 않습니다. 이는 의도적입니다("빈 스페이스 = 닫힌 스페이스").

실질적 결과:

  • 돌아온 고객은 떠난 곳에서 이어갑니다 — 같은 스페이스, 같은 메모리.
  • 동일한 질문을 하는 두 고객은 각자 자신의 이력에만 물든 답변을 받습니다.
  • 스페이스를 삭제하면 그 세션, 스페이스 문서, 메모리가 함께 제거됩니다.

검색이 동작하는 방식

당신이 업로드한 문서는 파싱되고, 청크로 나뉘고, 임베딩되고, 저장됩니다(청크 텍스트는 저장 시 필드 암호화됩니다). 질문 시점에 에이전트는 쿼리를 임베딩하고 당신의 지식에 대해 벡터 검색을 수행합니다 — 열린 인터넷 대신 당신의 문서에 답의 근거를 둡니다.

테넌트 지식 대 스페이스 문서

두 계층의 문서가 검색에 공급됩니다:

  1. 테넌트 지식 베이스 — 당신의 제품 시트, FAQ, 플레이북화된 답변. 콘솔에서 한 번 업로드되어, 연결한 모든 에이전트가 공유합니다.
  2. 스페이스 문서 — 특정 고객이 대화 중에 업로드하는 파일("여기 제 계약서요"). 그 스페이스 안에서만 보입니다.

검색을 예리하게 유지하기

  • 200페이지 개요서 하나보다 여러 개의 집중된 문서를 선호하세요 — 청크 경계는 당신의 문서 구조를 따릅니다.
  • 문서 이름을 서술적으로 지으세요; 제목은 검색 신호입니다.
  • 덧붙이지 말고 갱신하세요. 오래된 수수료 표 옆에 두 번째 버전을 업로드하는 대신 교체하세요 — 상충하는 두 버전은 검색 룰렛을 뜻합니다.
  • 지원 포맷: PDF, Word(.docx), HTML/웹 페이지, 그리고 일반 텍스트/Markdown.

메모리

문서를 넘어, 에이전트는 사용자-스페이스별로 장기 메모리를 씁니다: 진술된 선호, 핵심 사실, 한 약속. 메모리는 지식과 나란히 검색되어, 후속 조치를 심문이 아니라 이어짐처럼 느끼게 합니다. 콘솔에서 메모리를 검토하고 삭제할 수 있습니다.