설명
JianShanAgent (见山)는 MediaWiki 사이트를 위해 특별히 개발된 오픈 소스 QQ 봇 프레임워크입니다. 이는 게임 플레이어 커뮤니티나 팬 위키와 같은 커뮤니티 그룹에서 사용자들이 캐릭터 통계, 기술 메커니즘, 이벤트 보상에 대한 질문을 자주 하거나 스크린샷에서 정보를 찾는 일반적인 문제를 해결합니다. 전통적인 키워드 기반 봇은 고정된 명령에 제한되며, 일반적인 대형 언어 모델은 종종 환각을 일으키거나 잘못된 버전 특정 데이터를 제공합니다.
더 읽기
JianShanAgent는 정밀한 쿼리와 강력한 대형 언어 모델 검증을 통합하여 이러한 한계를 극복합니다. `/查` (쿼리) 및 `/筛选` (필터)와 같은 명령을 사용하여 MediaWiki API 또는 구조화된 사이트 데이터에 직접 접근하는 정밀한 구조화된 조회를 제공합니다. 이러한 명령은 1-2초 이내에 형식화된 카드를 반환하여, 대형 언어 모델을 우회하여 데이터 정확성을 보장하고 조작을 방지합니다.
자연어 질문에 대해서는, 봇은 Retrieval-Augmented Generation (RAG)과 독립적인 검토를 결합한 다단계 검증 프로세스를 사용합니다. 먼저 질문을 분해하고 별칭을 식별한 후, 지역 벡터 지식 기반 및 실시간 위키 콘텐츠에서 증거를 검색합니다. 답변을 생성한 후, 독립적인 검토 단계가 추측 정보나 검증되지 않은 링크를 걸러내어 출처 인용이 포함된 사실만 제공합니다.
주요 기능으로는 이미지 역검색이 포함되어 있으며, 이는 벡터 모델을 사용하여 사이트 내 일러스트레이션, 스킨 및 아이콘을 인덱싱하여 사용자가 이미지를 업로드하여 출처를 식별할 수 있도록 합니다. 매시간 `kbsync` 프로세스가 자동으로 최근 MediaWiki 변경 사항을 확인하여 지식 기반에 점진적인 업데이트를 수행합니다. 이 프레임워크는 Node.js 설치가 필요 없는 미리 컴파일된 웹 관리 백엔드를 제공합니다. 이 콘솔을 통해 사용자는 각 Q&A에 대한 전체 검색 및 검증 체인을 보고, 대화를 직접 디버깅하며, 구성 및 플러그인 스위치를 핫 업데이트할 수 있습니다.
현재 JianShanAgent는 Huiji Onmyoji Wiki 및 BWiki Onmyoji Story Encyclopedia의 운영 인스턴스에 배포되어 있으며, 약 9,000개의 문서, 19,000개의 지식 조각 및 3,000개의 이미지를 인덱싱했습니다. 이 프로젝트는 MIT 라이센스 하에 완전히 오픈 소스이며, 핵심 프레임워크, 사이트 플러그인 및 배포 템플릿이 GitHub에서 제공됩니다.
- 카테고리AI 챗봇 빌더
- 요금제오픈 소스
- 배포Python Native, Docker Compose
- 플랫폼MediaWiki
JianShanAgent의 핵심 기능
MediaWiki 사이트를 위한 오픈 소스 QQ 봇 프레임워크
정밀한 명령 기반 구조화된 데이터 조회
독립적인 답변 검증을 통한 다단계 RAG
사이트 내 일러스트레이션 및 자산을 위한 이미지 역검색
매시간 점진적인 지식 기반 동기화
디버깅 및 구성을 위한 내장 웹 관리 콘솔
사용자 정의 사이트 플러그인 및 확장 지원
데이터 검색을 위한 MediaWiki API와의 직접 통합
효율적인 검색을 위한 로컬 벡터 지식 기반
자연어 쿼리를 위한 자동 별칭 인식
배포 옵션: Python 네이티브 또는 Docker Compose
빠른 봇 설정을 위한 템플릿 인스턴스
모든 리포지토리 코드에 대한 MIT 라이센스
다양한 MediaWiki 플랫폼 지원 (예: Huiji, BWiki)
JianShanAgent 사용 방법은?
인스턴스 생성: `template-instance`를 사용하여 봇을 위한 새로운 리포지토리를 생성합니다.
설정 구성: `config/core.wiki.yaml`에 MediaWiki API 주소를 입력하고, `config/secrets.yaml`에 대형 언어 모델/QQ 봇 키를 입력합니다.
시작 방법 선택: Python에서 네이티브로 실행(`uv sync && uv run jianshanagent`)하거나 Docker Compose를 사용(`docker compose up -d --build`)합니다.
웹 관리 접근: 브라우저에서 `http://127.0.0.1:8080`을 열고 로그인 토큰을 가져온 후, '웹 대화' 섹션에서 Q&A를 테스트합니다.
지식 기반 구축: 관리 콘솔에서 `knowledge run / embed / load` 명령을 실행하여 전체 벡터 검색을 수행합니다.
JianShanAgent의 사용 사례
- 커뮤니티 Q&A 자동화
- MediaWiki 데이터 검색
- 지식 기반 검증
- 이미지 출처 식별
- 위키 콘텐츠 동기화
- 봇 관리 및 디버깅
- 사용자 정의 위키 통합






