Описание
JianShanAgent (见山) — это фреймворк для QQ-ботов с открытым исходным кодом, специально разработанный для сайтов MediaWiki. Он решает общую проблему в группах сообществ, таких как сообщества игроков в игры или фанатские вики, где пользователи часто задают вопросы о характеристиках персонажей, механике навыков, наградах за события или ищут информацию по скриншотам. Традиционные боты на основе ключевых слов ограничены фиксированными командами, в то время как универсальные большие языковые модели часто выдают несуществующие или неверные данные, специфичные для версии.
Читать далее
JianShanAgent преодолевает эти ограничения, интегрируя точные запросы с надежной проверкой больших языковых моделей. Он предлагает прямые структурированные запросы с использованием команд, таких как `/查` (запрос) и `/筛选` (фильтр), которые напрямую обращаются к API MediaWiki или структурированным данным сайта. Эти команды возвращают отформатированные карточки в течение 1-2 секунд, минуя большую языковую модель, чтобы обеспечить точность данных и предотвратить их искажение.
Для вопросов на естественном языке бот использует многоступенчатый процесс проверки, комбинируя генерацию с дополнением поиска (RAG) с независимым обзором. Сначала он разбивает вопрос и определяет псевдонимы, затем ищет доказательства в локальных векторных базах знаний и актуальном контенте вики. После генерации ответа этап независимого обзора фильтрует спекулятивную информацию или непроверенные ссылки, предоставляя только обоснованные факты с указанием источников.
Ключевые функции также включают обратный поиск изображений, который использует векторную модель для индексации иллюстраций, скинов и значков на сайте, позволяя пользователям определять источники, загружая изображения. Часовой процесс `kbsync` автоматически выполняет инкрементальные обновления базы знаний, проверяя недавние изменения в MediaWiki. Фреймворк поставляется с предварительно скомпилированной веб-административной панелью, что исключает необходимость установки Node.js. Эта консоль позволяет пользователям просматривать полную цепочку извлечения и проверки для каждого вопроса и ответа, отлаживать разговоры напрямую и горячо обновлять конфигурации и переключатели плагинов.
В настоящее время JianShanAgent развернут в производственных экземплярах для Huiji Onmyoji Wiki и BWiki Onmyoji Story Encyclopedia, индексировав примерно 9,000 документов, 19,000 фрагментов знаний и 3,000 изображений. Проект полностью с открытым исходным кодом под лицензией MIT, его основной фреймворк, плагины для сайтов и шаблоны развертывания доступны на GitHub.
- КатегорияКонструкторы AI-чат-ботов
- Модель ценообразованияОткрытый исходный код
- РазвёртываниеPython Native, Docker Compose
- ПлатформыMediaWiki
Основные функции JianShanAgent
Фреймворк для QQ-ботов с открытым исходным кодом для сайтов MediaWiki
Точные структурированные запросы на основе команд
Многоступенчатый RAG с независимой проверкой ответов
Обратный поиск изображений для иллюстраций и ресурсов на сайте
Часовая инкрементальная синхронизация базы знаний
Встроенная веб-консоль для администрирования, отладки и конфигурации
Поддержка пользовательских плагинов и расширений для сайтов
Прямая интеграция с API MediaWiki для извлечения данных
Локальная векторная база знаний для эффективного поиска
Автоматическое распознавание псевдонимов для запросов на естественном языке
Варианты развертывания: нативный Python или Docker Compose
Шаблонные экземпляры для быстрой настройки бота
Лицензия MIT для всего кода репозитория
Поддерживает несколько платформ MediaWiki (например, Huiji, BWiki)
Как использовать JianShanAgent?
Создать экземпляр: Используйте `template-instance`, чтобы создать новый репозиторий для вашего бота.
Настроить параметры: Заполните адрес API MediaWiki в `config/core.wiki.yaml` и ключи для большой языковой модели/QQ-бота в `config/secrets.yaml`.
Выбрать метод запуска: Запустите нативно с Python (`uv sync && uv run jianshanagent`) или используйте Docker Compose (`docker compose up -d --build`).
Доступ к веб-админке: Откройте `http://127.0.0.1:8080` в вашем браузере, получите токен для входа и протестируйте вопросы и ответы в разделе 'Web Dialogue'.
Построить базу знаний: Выполните команды `knowledge run / embed / load` в административной консоли для полного извлечения векторов.
Варианты использования JianShanAgent
- Автоматизация вопросов и ответов в сообществе
- Извлечение данных из MediaWiki
- Проверка базы знаний
- Идентификация источников изображений
- Синхронизация контента вики
- Управление ботом и отладка
- Пользовательская интеграция вики






