1
평가 목표를 한 문장으로 제한
예: “내부 문서검색”이 아니라 “채팅 UI와 Agent 기본 응답 흐름을 본다”라고 적습니다.
주의: 목표가 넓으면 Lite PASS가 Standard 운영 승인처럼 오해됩니다.
Onyx v4 operator lesson 01 · standalone operator lesson
Lite 평가 배포
작게 띄워 채팅·Agent 중심 기능만 먼저 확인하고, RAG/Connector 검증으로 과장하지 않는 평가 절차입니다.
이 lesson의 목적
작게 띄워 채팅·Agent 중심 기능만 먼저 확인하고, RAG/Connector 검증으로 과장하지 않는 평가 절차입니다.
주 대상: 첫 도입 검토자, PoC 담당자, 운영 승인 전에 비용·리소스 경계를 확인하는 관리자
언제 이 절차를 쓰나
- 팀이 먼저 확인하려는 것이 “LLM 채팅이 우리 업무 질의에 쓸 만한가”일 때
- 문서 색인, 조직 지식 검색, 커넥터 동기화보다 빠른 설치와 낮은 리소스 사용이 우선일 때
- 나중에 Standard로 올릴 수 있다는 전제 아래, Lite의 한계를 명확히 적어둘 수 있을 때
시작 전에 준비할 것
- Git과 Docker Compose가 설치되어 있어야 합니다.
- LLM Provider를 연결할 키 또는 자체 추론 엔드포인트가 준비되어 있어야 합니다.
- Lite는 Vespa/vector DB, Redis, Celery workers, MinIO/S3, Connectors/RAG를 끄는 구성이므로 “문서검색 검증”을 목표로 삼지 않습니다.
대표 작업 순서와 확인값
2
소스와 compose 위치 확인
`git clone --depth 1 https://github.com/onyx-dot-app/onyx.git` 후 `onyx/deployment/docker_compose` 위치에서 작업합니다.
주의: 다른 디렉터리에서 compose를 실행하면 override 파일을 못 찾거나 전혀 다른 stack을 띄울 수 있습니다.
3
Lite override로 기동
`docker compose -f docker-compose.yml -f docker-compose.onyx-lite.yml up -d`를 사용합니다.
주의: 기본 `docker compose up -d`는 Lite 평가가 아니라 Standard 계열 구성을 띄울 수 있습니다.
4
기동 완료와 앱 접근을 분리 확인
컨테이너가 떠도 초기화가 끝나야 `localhost:3000` 접근이 의미 있습니다.
주의: 컨테이너 Up 상태만 보고 “Onyx 사용 가능”이라고 기록하지 않습니다.
5
Lite 제외 기능을 체크리스트로 표시
Connectors, RAG, vector DB, Redis, Celery, S3/MinIO가 검증 범위 밖인지 회의록에 적습니다.
주의: 없는 기능을 “나중에 확인”으로만 두면 PoC 결과가 과장됩니다.
6
LLM 연결 후 한두 개 질문만 확인
채팅 UI에서 응답 생성, 파일 업로드/프로젝트/Agent knowledge 같은 Lite 포함 기능만 확인합니다.
주의: 문서 색인 품질이나 조직 권한 보존을 이 단계에서 결론내리지 않습니다.
7
전환 기준 작성
RAG, Connector, 권한 기반 검색, 운영 안정성이 필요하면 Standard 평가로 이동한다고 결정합니다.
주의: Lite를 계속 보완해 Standard 대체물로 만들려 하지 않습니다.
자주 나는 실수
- Lite가 “작은 Standard”라고 생각하는 것 — 문서 색인/RAG/커넥터가 의도적으로 빠져 있습니다.
- 컨테이너 상태만 보고 사용자 기능 PASS로 쓰는 것 — 앱 초기화와 LLM 연결 확인이 별도입니다.
- PoC 결과표에 “문서검색 가능”이라고 적는 것 — Lite 범위 밖입니다.
검증과 readback
- compose 명령에 `docker-compose.onyx-lite.yml`이 포함되어 있는지 확인합니다.
- 평가표에 “검증함”과 “검증하지 않음”을 별도 칸으로 기록합니다.
- Standard 전환 조건이 최소 1개 이상 적혀 있어야 합니다.
근거 문서
아래 문서는 이 정적 lesson의 작성 근거입니다. 실제 화면 라벨이나 배포 성공은 별도 현장 검증이 필요합니다.
다음 판단 / 분기
- 채팅/Agent 기본 UX가 충분하면 03 LLM Provider 설정으로 넘어갑니다.
- 문서검색·커넥터가 필요하면 02 Standard 운영 배포와 04 지식 연결로 넘어갑니다.
검증 경계
이 페이지는 Lite 평가 절차입니다. 실제 Onyx 인스턴스 기동 성공, 브라우저 UI 라벨, 조직별 보안 설정은 현장 환경에서 다시 확인해야 합니다.