WeKnora 0.9.0: 지식 관리 어시스턴트, 조정형 RRF 검색

1. 화면에서 검색 결과 결합을 조정

검색 설정은 검색 후보 수집, 결과 결합, 재순위 조정의 세 탭으로 나뉜다. 재순위 조정은 결과 순서를 다시 매기는 기능이다. 관리자는 결과 결합 탭에서 벡터·키워드 검색 결과의 반영 비중을 바꿀 수 있다. 설정은 자동 저장되며, API로 지정한 값도 다른 설정을 저장할 때 유지된다.

RRF는 서로 다른 검색 결과를 순위에 따라 하나의 목록으로 합치는 방식이다. 평활화 상수는 상위 결과에 주는 우위를 조절하며, 값을 높이면 그 우위가 줄어든다. 가중치는 각 검색 방식이 최종 결과에 얼마나 기여할지 정한다. 기존에는 이 항목을 API로 설정했지만 이제 화면에서 조정할 수 있다.

표: RRF 검색 설정의 서버 기본값

조건: 값 0은 각 항목의 기본값 선택이며, 두 가중치의 합을 1로 맞출 필요는 없다.

단위: 평활화 상수·가중치(단위 없음)

잘못된 숫자 입력은 반영하지 않는다.

2. 작업 목록을 바탕으로 관리 업무 수행

내장 WeKnora 어시스턴트는 할 수 있는 작업을 찾아 실행하고, 기존 권한 검사와 검증, 감사 기록을 따른다. 사용자가 여러 관리 화면을 찾아다니는 대신 대화로 작업을 요청하는 구조다.

실행할 작업은 사용자 권한으로 실제 요청 처리 경로를 거치며, 허용 목록, 실행 가능한 항목만 모은 목록은 실행 파일에 포함된 API 설명서인 Swagger 문서에서 시작할 때 구성한다. 작업을 추가하는 핸들러, 요청을 받아 처리하는 코드의 주석 예시는 다음과 같다.

// @x-agent      {"id":"knowledge.delete","risk":"destructive","target":"knowledge.get","label":"title"}
// @x-agent-hint "Removes the document with its chunks, embeddings and graph data. Cannot be undone."
// @Param        id   path      string  true  "知识ID"  extensions(x-agent=knowledge_id)

처음에는 지식 베이스·문서 조회와 재파싱, 원문을 다시 분석하는 작업, 삭제, 위키 통계와 링크 재구축 등을 지원한다. 이후 지식 베이스와 자주 묻는 질문, 태그, 문서 묶음 관리, 에이전트와 확장 기능인 스킬, 어시스턴트 기능을 확장하는 도구의 관리까지 작업 범위가 확장됐다.

실행 중인 버전의 안내 문서를 검색하고 읽을 수도 있다.

3. 현재 화면과 역할에 맞춘 사용

어시스턴트는 사이드바, 명령 검색, 문서 화면 등에서 열 수 있으며, 현재 문서나 위키 페이지를 대화 맥락으로 전달한다. 사용자는 어시스턴트가 옆에 붙는 형태나 떠 있는 패널로 사용할 수 있고, 실행 기록은 일반 대화 기록과 별도 관리된다.

접근 단계는 읽기 전용, 확인 후 실행, 자동 쓰기로 구성되며 기본값은 확인 후 실행이다. 관리자는 작업공간의 최대 단계를 정하고, 실제 실행에는 사용자 설정과 관리자 상한 중 더 제한적인 단계가 적용된다. 자동 쓰기에서도 파괴적 작업과 스킬 설치는 확인을 요구한다.

역할별 기본 기준은 읽기에 뷰어, 쓰기와 파괴 작업에 기여자 권한이다. 실행할 수 없는 작업은 필요한 역할이나 읽기 전용 상태 등 사유와 함께 표시돼, 사용자가 실행되지 않는 이유를 알 수 있다.

4. 예약 실행과 비용의 이동

작업을 일정에 맞춰 실행하는 자동화도 추가됐다. 일정은 크론 형식, 반복 실행 시점을 규칙으로 적는 표기 또는 한 번 실행으로 정하고 시간대를 지정할 수 있으며, 최소 간격은 5분이다. 실행은 소유자 권한으로 이뤄지고 승인 대기 알림이 앱 안에 표시된다. 연속 세 차례 실패하면 자동화가 멈추며 API 키로 자동화를 만들 수 없다.

기존에는 확인 없이 실행되던 위키 수정도 기본 접근 단계에서는 확인 카드를 거친다. 대화로 요청한 수정도 실행 전에 사용자가 확인하는 절차가 생긴 셈이다.

자동화 기록과 실행이 데이터베이스에 저장되므로 업그레이드에는 마이그레이션, 저장 구조 변경을 적용하는 절차도 필요하다. 릴리스 안내가 제시한 마이그레이션 버전은 PostgreSQL 000134, SQLite 000051이다.

0.9.0의 핵심은 검색 결합은 설정 화면으로, 지식 관리 실행은 대화로 옮기고 권한과 승인을 자동화의 제어 장치로 함께 둔 점이다.