RAGFlow v1.0.0 정식판은 문서를 찾아 답을 만드는 개발팀이 사용자의 접근 권한에 맞는 범위에서 검색하도록 보완했다. 문서 구조 보존과 에이전트 실행 오류도 수정해, 검색 결과로 답을 보완하는 절차에서 문서가 잘못 나뉘거나 실행 결과가 비는 문제를 다뤘다.

1. 검색 범위에 권한과 상한 적용

검색에서는 결과를 다시 정렬하는 재순위화와 내용이 가까운 문서를 찾는 근접 이웃 탐색의 후보 수에 상한을 뒀다. 최종 답변에 쓸 문서를 고르기 전에 검토할 후보 묶음부터 제한하는 방식이다.

대화 검색에서 데이터베이스에 조건을 요청하는 SQL 질의에는 사용자가 접근할 수 있는 지식베이스 조건을 결합하도록 고쳤다. 지식베이스는 문서를 저장하는 공간이다. 이 권한 조건이 검색할 수 있는 문서의 범위를 지킨다면, 후보 수 상한은 검토할 후보 묶음의 크기를 제한한다. 문서 조각인 청크를 삭제할 때도 문서를 묶어 관리하는 데이터셋의 지정 범위로 제한하고, 단일 청크 갱신 때 데이터셋과 문서 범위를 보존한다.

Dify 연동에서는 문서에 덧붙인 설명 정보인 메타데이터의 조건이 비어 있을 때 검색 범위를 좁히지 않도록 수정했다.

arxiv와 duckduckgo 등 릴리스에 명시된 네 도구의 응답 본문 상한은 4 MiB다. 도구에서 받아오는 응답 자체의 크기를 제한하는 변경이다.

목록 API의 페이지 크기 상한은 100이다. 한 번에 조회할 목록의 항목 수에 적용된다. 응답 본문 상한은 바이트 크기, 페이지 크기 상한은 항목 개수에 대한 별도 제한이므로 두 수치를 직접 비교할 수는 없다.

2. 문서 파싱과 분할의 오류 수정

PDF의 페이지 경계에서 문장이 끊기던 문제를 고쳤고, 표에서 누락되던 행과 병합 머리글도 보존하도록 손봤다. PDF 하위 청크가 서로 덮어쓰거나 원문 위치와 미리보기가 어긋나던 문제도 수정해, 검색에 들어가기 전 문서 구조를 다루는 단계의 오류를 줄였다.

문서 처리 지원은 파서 선택지, 수집 경로, 외부 API 호환이라는 서로 다른 층위에서 보완됐다. 문서 구조를 읽어내는 프로그램인 파서에는 PDF용 MiniCPM-OCR이 추가됐고, MonkeyOCR은 Go로 구현된 문서 수집 경로에서 PDF 처리를 지원한다. MinerU 파서는 4.1 작업 API에 맞춰 호환성을 보완했으며 시간 제한을 환경 설정으로 조정할 수 있다.

문서 처리 대기열의 전체 취소와 실행 중 작업 취소 기능도 추가됐다. 잘못된 작업이 쌓였을 때 대기 중인 문서를 일일이 취소하는 부담을 줄이는 변경이다.

3. 에이전트 실행과 외부 연결 보완

에이전트에서는 내부에 둔 하위 에이전트의 구성요소를 찾지 못하는 문제를 해결했다.

정해진 항목에 맞춰 결과를 내는 구조화 출력이 비어 있던 문제도 고쳤다.

실행 상태를 저장하는 지점에서 발생하던 충돌을 막고, 구성요소와 조건 분기의 오류를 호출한 쪽으로 전달하도록 바꿨다. 여러 단계를 잇는 작업에서는 어느 단계가 실패했는지 추적하는 데 도움이 되는 변경이다.

번역과 날씨 기능의 인증 정보는 노드 설정 또는 전용 환경 변수에서 가져오게 해 모델에 보이는 매개변수와 분리했다. 모델이 다루는 입력과 외부 서비스 접속 정보를 따로 관리하는 방식이다.

검색 권한과 입력 상한을 정비하면 검색·도구 호출의 범위를 관리하기 쉬워진다. 그 대신 큰 후보 묶음이나 응답을 전제로 구성한 팀에는 기존 설정과 요청 크기를 다시 확인하는 작업이 생긴다.

4. 명령줄 도구는 환경에 맞춰 설치

정식판 자산에는 운영체제와 프로세서 종류에 맞춘 명령줄 도구 6종과 설치 스크립트, 체크섬 파일이 포함됐다.

셸 설치 스크립트는 운영체제와 아키텍처를 판별해 해당 파일을 내려받고, SHA256SUMS와 대조해 체크섬, 파일 무결성 확인용 요약값을 확인한 뒤 설치한다. 기본 설치 위치는 /usr/local/bin이며, 아래 설정은 스크립트에서 그대로 가져왔다.

INSTALL_DIR="${INSTALL_DIR:-/usr/local/bin}"
GITHUB_REPO="${GITHUB_REPO:-infiniflow/ragflow}"
CLI_NAME="${CLI_NAME:-ragflow-cli}"
VERSION="${VERSION:-latest}"

설치 버전의 기본값은 최신 릴리스를 가리킨다. 이번 정식판에 고정하려면 버전 설정을 지정해 설치하고, 경로도 필요에 따라 바꿀 수 있다. 윈도용 설치 스크립트도 릴리스 자산으로 제공된다.

v1.0.0의 핵심은 검색·파싱·에이전트 경로를 더 예측 가능하게 다듬은 것으로, 업그레이드 전에는 강화된 범위 제한과 설치 방식을 함께 점검할 만하다.