1
데이터 소스 후보 정리
Onyx Connector는 외부 시스템 업데이트를 Onyx로 동기화하고 metadata/signals를 가져오는 역할입니다.
주의: 무엇을 연결할지 없이 Connector만 켜면 품질 검증 질문을 만들 수 없습니다.
Onyx v4 operator lesson 04 · standalone operator lesson
지식 연결과 RAG 검색
Connectors가 문서를 가져오고, 색인 상태와 답변 근거가 연결되는지 단계별로 확인합니다.
이 lesson의 목적
Connectors가 문서를 가져오고, 색인 상태와 답변 근거가 연결되는지 단계별로 확인합니다.
주 대상: 지식관리 담당자, 문서/권한 관리자, RAG 품질을 검증하는 PoC 담당자
언제 이 절차를 쓰나
- 회사 문서·앱 데이터를 Onyx 답변 근거로 쓰려 할 때
- 파일 업로드를 넘어 지속 동기화가 필요한 지식원을 붙일 때
- 권한 보존과 answer citation이 운영 리스크가 되는 환경일 때
시작 전에 준비할 것
- Standard 배포 또는 connector/RAG가 가능한 구성이 필요합니다.
- 연결할 데이터 소스의 관리자 권한과 접근 정책이 준비되어야 합니다.
- 테스트용 문서와 expected answer/citation 질문을 미리 만듭니다.
대표 작업 순서와 확인값
2
권한 모델 확인
권한을 보존하는 구성에서는 사용자가 볼 수 없는 문서가 답변에 섞이면 안 됩니다. 권한 보존 지원 범위는 사용하는 Onyx 플랜과 설정에서 다시 확인합니다.
주의: 권한 보존 여부를 확인하지 않으면 지식검색이 보안 리스크가 됩니다.
3
Connector 또는 API/File Upload 선택
지원 Connector가 있으면 connector, 없으면 ingestion API 또는 File Upload를 검토합니다.
주의: 일회성 파일 업로드를 지속 동기화처럼 설명하지 않습니다.
4
색인 상태 확인
문서 수, 마지막 sync 시간, 실패 로그, metadata 반영 여부를 확인합니다.
주의: 검색 답변 하나가 맞아 보여도 전체 sync 성공은 아닙니다.
5
내부 검색 질문 실행
테스트 문서에서만 답할 수 있는 질문을 던지고, 답변과 인용/근거가 연결되는지 봅니다.
주의: LLM 일반지식으로 답할 수 있는 질문은 RAG 검증이 아닙니다.
6
권한 차이 질문 실행
권한이 다른 사용자 또는 그룹에서 같은 질문의 접근 결과가 달라지는지 봅니다.
주의: 관리자 계정 하나로만 보면 실제 사용자 노출을 알 수 없습니다.
7
운영 기준 기록
sync 주기, 실패 대응, 삭제/권한 변경 반영, 품질 재검증 주기를 문서화합니다.
주의: 초기 ingest 성공만으로 운영 기준이 생기지 않습니다.
자주 나는 실수
- LLM이 그럴듯하게 답했다고 RAG가 된 것으로 보는 것
- sync 실패와 권한 실패를 같은 검색 품질 문제로 뭉개는 것
- 삭제/권한 변경 반영 시간을 확인하지 않는 것
검증과 readback
- 질문별 expected source 문서와 실제 citation을 비교합니다.
- sync status와 실패 로그 확인 위치를 기록합니다.
- 관리자/일반 사용자 권한 차이를 별도 케이스로 남깁니다.
근거 문서
아래 문서는 이 정적 lesson의 작성 근거입니다. 실제 화면 라벨이나 배포 성공은 별도 현장 검증이 필요합니다.
다음 판단 / 분기
- 반복 업무용 Agent를 만들려면 05로 이동합니다.
- 운영 감시/백업/업그레이드 기준은 06으로 이동합니다.
검증 경계
이 페이지는 RAG 검증 방법을 설명합니다. 실제 문서 내용, 권한 보존, citation 정확성은 연결한 조직 데이터로만 확인할 수 있습니다.