-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ
Q: 사용자마다 Ollama를 설치해야 하나요? 아닙니다. Ollama는 서버에만 설치하면 됩니다. 사용자는 웹 브라우저로 서버에 접속하기만 하면 됩니다. 개별 PC에 AI 모델이나 특별한 프로그램을 설치할 필요가 없습니다.
Q: Ollama를 왜 Docker에 넣지 않나요? GPU 사용과 메모리 관리 때문입니다. Docker 안에서 GPU를 쓰려면 복잡한 설정(NVIDIA Container Toolkit 등)이 필요하고, 컨테이너 메모리 제한에 걸리면 모델 로딩이 실패할 수 있습니다. 시스템 서비스로 실행하면 GPU를 직접 사용하고, 메모리도 효율적으로 관리됩니다.
Q: Docker를 몰라도 되나요? 설치할 때 명령어 몇 개만 입력하면 됩니다. Docker 자체를 다룰 필요는 없습니다.
Q: 인터넷이 안 되는 환경에서도 쓸 수 있나요? 최초 설치 시에만 인터넷이 필요합니다 (프로그램과 AI 모델 다운로드). 이후에는 인터넷 없이 동작합니다. 이미지 처리용 DINOv2 모델도 최초 실행 시 자동 다운로드되어 캐시됩니다.
Q: GPU가 없어도 되나요? 됩니다. 다만 LLM 응답이 느립니다 (1분~5분+). 처음에 CPU로 써보고, 유용하면 GPU를 추가하는 걸 추천합니다. CPU로 사용시에는 gemma2:2b 와 같은 경량 모델을 추천합니다.
Q: Ollama 말고 다른 AI 모델도 쓸 수 있나요? 예. 인터넷이 가능한 환경이라면 OpenAI, Anthropic 등 상용 모델을 사용할 수 있습니다. 질의 분석(오케스트레이터)과 데이터 처리(에이전트)에 각각 다른 모델을 지정하는 것도 가능합니다. 웹 UI의 설정 페이지에서 재시작 없이 변경할 수 있습니다.
Q: 어떤 모델을 추천하나요?
| 환경 | 추천 |
|---|---|
| 폐쇄망 + GPU |
exaone3.5:7.8b (한국어 최적) |
| 폐쇄망 + CPU |
gemma2:2b (경량, 빠름) |
| 인터넷 가능 |
gpt-4o-mini 또는 Anthropic Claude |
Q: 기존 공유 폴더 구조를 바꿔야 하나요?
아닙니다. 기존 폴더 구조 그대로 사용하면 됩니다. 해당 폴더를 "감시"만 하므로 기존 파일이나 구조에 영향을 주지 않습니다. 공유 폴더는 읽기 전용(:ro)으로 마운트됩니다.
Q: 엑셀 파일을 수정하면 DB도 업데이트되나요? 파일이 변경되면 감지하여 DB를 갱신합니다.
Q: 이미지 파일도 처리할 수 있나요? 예. JPG, PNG 등 이미지를 공유 폴더에 넣으면 AI(DINOv2)가 자동으로 특징을 분석합니다. "비슷한 사진 찾아줘", "중복 사진 확인해줘" 같은 질의가 가능하며, 촬영 정보(카메라, 날짜, GPS 등)도 EXIF에서 자동 추출됩니다.
Q: 외부 DB(ERP 등)에 연결할 수 있나요?
예. 외부 PostgreSQL에 읽기 전용으로 연결할 수 있습니다. .env에서 EXTERNAL_DB_ENABLED=true로 설정하고 접속 정보를 입력하면, 관리자 페이지에서 스키마 동기화 후 채팅에서 외부 DB 데이터를 자연어로 조회할 수 있습니다. 플러그인 구조로 설계되어 향후 MySQL 등 다른 DB도 추가할 수 있습니다.
Q: 특정 이벤트가 발생하면 알림을 받을 수 있나요? 예. 파일 등록, 마트 생성, 배치 실패, 승인 요청 등 이벤트 발생 시 Webhook, Slack, Teams로 알림을 전송할 수 있습니다. 관리자 페이지 > 알림 설정에서 구독을 등록하면 됩니다.
Q: 데이터가 많아지면 느려지나요? v0는 수만~수십만 행 규모를 고려하고 구현하였습니다. 그 이상의 데이터를 다뤄야 할 경우에는 다른 서비스를 고려해보시는 것을 추천드립니다.
Q: 로그인이 필요한가요?
예. 웹 UI에 접속하면 로그인 화면이 나타납니다. 초기 관리자 계정은 .env의 ADMIN_PASSWORD로 설정되며, 관리자가 일반 사용자 계정을 추가할 수 있습니다.
Q: 에이전트가 실수로 데이터를 날릴 수 있나요?
없습니다. 에이전트는 SELECT만 실행할 수 있고, DROP/DELETE 등 파괴적 SQL은 원천 차단됩니다. 마트 생성이나 리소스 삭제는 반드시 관리자 승인이 필요합니다.
Q: 데이터를 삭제하면 바로 지워지나요? 웹 UI에서 삭제를 요청하면 관리자 승인이 필요합니다. 관리자가 승인하면 DB, 검색 인덱스, 카탈로그에서 모두 삭제됩니다. 다만 공유 폴더에서 파일을 직접 삭제하면 즉시 정리됩니다 (승인 불필요).
Q: 여러 명이 동시에 쓸 수 있나요? 채팅 UI에 여러 명이 동시 접속할 수 있습니다.
Q: 배치 작업이 실패하면 어떻게 되나요?
실행 이력과 에러 로그가 batch_job_history 테이블에 저장되며, 채팅에서 "배치 실행 이력 보여줘"로 확인할 수 있습니다. 실패한 배치는 자동 재시도하지 않으며, 원인 확인 후 수동으로 재실행할 수 있습니다.
Q: 우리는 이걸 관리할 만한 개발자도 없는데, 관리 작업도 AI에게 넘길 수 있을까요? 현재 시스템은 관리자가 SQL이나 인프라 구조를 어느 정도 이해한다는 전제하에 설계되었습니다. 모르더라도 운영 자체는 가능하겠지만, 문제가 생겼을 때 해결하기는 어려울 수 있습니다.
Q: FTP/SFTP로 데이터를 받고 있는데 연동할 수 있나요?
Webhook API를 통한 FTP/SFTP 연동은 구현 예정입니다. 현재는 FTP 업로드 디렉토리를 WATCH_DIR에 직접 지정하면 훅 없이 자동 감지됩니다.