Skip to content

README.ru.md

Latest commit

 

History

History
376 lines (264 loc) · 18.6 KB

README.ru.md

File metadata and controls

376 lines (264 loc) · 18.6 KB

Agent Debate Consensus

Платформа мультиагентных дебатов — AI-модели обсуждают, спорят и приходят к консенсусу, пока вы выступаете модератором.

🇬🇧 English | 🇷🇺 Русский | 🇺🇦 Українська

Next.js TypeScript Tailwind CSS License Version

v2.4.2 — Производительность: React.memo и мемоизация markdown-компонентов устраняют торможение браузера в длинных дебатах. Исправлено вертикальное выравнивание текста в поле ввода.

Почему Agent Debate Consensus?

Один AI дает вам одну точку зрения. Agent Debate Consensus дает вам четыре — одновременно, в реальном времени, с аргументами в прямом столкновении.

Разные модели обучены на разных данных, имеют разные предубеждения и разные стили рассуждения. Заставляя их дебатировать тему и защищать свои позиции друг против друга, вы получаете более полную картину, чем способна дать любая отдельная модель. Противоречия выходят на поверхность. Слабые аргументы оспариваются. Консенсус, когда он достигается, — это честный результат критического анализа.

Используйте платформу для:

  • Стресс-тестирования идей перед внедрением
  • Исследования противоречивых тем с разных углов
  • Преодоления предвзятости отдельной модели
  • Трансформации групповых решений в организации
  • Генерации креативного контента с разных перспектив

Возможности

  • Мультиагентные дебаты — До 8 AI-агентов (Nemotron 120B, Llama 3.3 70B, Mistral Small 3.1, Gemma 3 27B — все бесплатные). 400+ дополнительных моделей через OpenRouter
  • 3-фазный движок дебатов — Opening (все делятся мнением) -> Discussion (@mentions, ограничение 5 на модель / 8 всего) -> Summary (модератор подводит итоги)
  • AI-модератор как участник — Модератор делится своим мнением, оценивает аргументы других, задаёт вопросы через @mentions, и подводит итоги. До 3 циклов модерации
  • @ALL триггер — Обращение ко всем участникам одновременно. Все кто уже высказался — ответят
  • Автоматические ретрай — 3 повторных запроса при ошибке (5с, 15с, 30с) со статусными сообщениями в чате
  • Прикрепление файлов — Текстовые файлы (код, Markdown, CSV, JSON, до 100KB) включаются в контекст AI
  • Потоковая передача — Токен за токеном через SSE — без ожидания полного ответа
  • @упоминания — Автодополнение при вводе @, цветовое выделение, навигация клавиатурой
  • Контроль температуры — Creative (0.9), Balanced (0.7), Precise (0.3)
  • Веб-поиск — Иконка глобуса активирует :online режим OpenRouter
  • Расширенное мышление — Поддержка chain-of-thought (сворачиваемая секция)
  • Экспорт в Markdown — Заголовок с участниками и модератором, временные метки
  • Проактивная кнопка API Key — Добавьте свой ключ в любой момент для разблокировки платных моделей
  • Сессии дебатов — Сохранение, загрузка, удаление. Автосохранение
  • Обработка сбоев — Красные индикаторы, автоматическое переназначение модератора
  • Тёмная/светлая тема, регулировка шрифта, коллапс длинных сообщений, мобильная адаптивность
  • Публичный режим — Бесплатные модели без ключа; платные — с ключом пользователя

Как это работает

1. ПОСТАНОВКА ТЕМЫ
   ↓
   Вы вводите вопрос или тему. Все активные агенты получают её как контекст.

2. НЕЗАВИСИМЫЕ ПОЗИЦИИ
   ↓
   Каждый агент формулирует свою позицию, независимо от других.
   Они не видят друг друга в первом раунде.

3. ПЕРЕКРЁСТНОЕ ОПЫЛЕНИЕ
   ↓
   В последующих раундах каждый агент получает полные ответы других агентов.
   Это включает подлинную реакцию, контраргументы, уточнения.

4. МОДЕРАЦИЯ
   ↓
   Вы вмешиваетесь в любой момент: уточняете термины, оспариваете слабые аргументы,
   просите конкретного агента защитить свою позицию.

5. СХОДИМОСТЬ К КОНСЕНСУСУ
   ↓
   Через итеративный обмен агенты:
   • Уточняют свои позиции
   • Признают более сильные аргументы
   • Движутся к консенсусу

   Или раскрывают непримиримые разногласия, о которых стоит знать.

Установка

Вариант A: NPX (быстрый старт)

npx degit Lexus2016/Agent-Debate-Consensus my-debate
cd my-debate
npm install
cp .env.example .env.local   # Укажите ваш API-ключ
npm run dev

Вариант B: Git Clone

git clone https://github.com/Lexus2016/Agent-Debate-Consensus.git
cd Agent-Debate-Consensus
npm install
cp .env.example .env.local   # Укажите ваш API-ключ
npm run dev

Настройка окружения

Отредактируйте .env.local:

OPENROUTER_API_KEY=your_key_here
MAX_ACTIVE_MODELS=8

Получите API-ключ на openrouter.ai/keys.

Для публичного режима оставьте OPENROUTER_API_KEY пустым — пользователи будут вводить свои ключи.

Откройте http://localhost:3000 в браузере.

Обновление

Если устанавливали через Git Clone:

git pull origin main
npm install

Если устанавливали через NPX degit:

npx degit Lexus2016/Agent-Debate-Consensus my-debate-updated

Затем перенесите .env.local из старой директории в новую.

Установить конкретную версию:

npx degit Lexus2016/Agent-Debate-Consensus#v2.1.0 my-debate

Использование

Базовый сценарий

  1. Выберите агентов на боковой панели (минимум 2)
  2. Введите вопрос или тему, чтобы начать дебаты
  3. Наблюдайте за тем, как агенты обсуждают, спорят и развивают идеи друг друга
  4. Направляйте дискуссию с помощью @упоминаний для вопросов конкретным агентам
  5. Вмешивайтесь в любой момент, чтобы добавить контекст или изменить направление
  6. Наблюдайте за консенсусом — или за тем, как расходятся мнения

Продвинутые техники

Использование @упоминаний для фокусировки

@Claude, как вы ответите на возражение @Gemini о масштабируемости?

Назначение модератора Нажмите звёздочку рядом с моделью для установки её модератором. Модератор будет синтезировать точки зрения и подводить итоги раундов.

Регулировка температуры

  • Creative (0.9) — Для генерации новых идей и альтернативных подходов
  • Balanced (0.7) — Для обсуждений и дебатов (по умолчанию)
  • Precise (0.3) — Для фактических вопросов и технического анализа

Управление сессиями

  • Дебаты автоматически сохраняются в localStorage
  • Загружайте предыдущие сессии из истории
  • Экспортируйте дебаты в Markdown для документации

Доступные агенты

Основные модели

Агент Провайдер @Упоминание Специализация
Nemotron 3 Super 120B NVIDIA @Nemotron Бесплатная
Llama 3.3 70B Meta @Llama Бесплатная
Mistral Small 3.1 Mistral AI @Mistral Бесплатная
Gemma 3 27B Google @Gemma Бесплатная

Расширенный каталог

Используйте Agent Discovery для доступа к 400+ моделям из каталога OpenRouter:

  • Специализированные модели для разных доменов
  • Открытые модели для полного контроля
  • Экспериментальные модели для инноваций

Технологический стек

Компонент Технология Версия
Фреймворк Next.js (App Router, Turbopack) 16
Язык TypeScript 5
Стилизация Tailwind CSS v4
Управление состоянием Zustand (с persist middleware) —
AI-маршрутизация OpenRouter API (через OpenAI SDK) —
Потоковая передача Server-Sent Events (SSE) —

Команды

npm run dev      # Запуск сервера разработки
npm run build    # Продакшн-сборка
npm run start    # Запуск продакшн-сборки
npm run lint     # ESLint проверка

Переменные окружения

Переменная По умолч. Описание
OPENROUTER_API_KEY (пусто) API-ключ OpenRouter. Оставьте пустым для публичного режима.
APP_MODE private private — полный доступ с серверным ключом. public — бесплатные модели без ключа, платные — с ключом пользователя.
MAX_ACTIVE_MODELS 8 Макс. количество одновременно работающих агентов.

Примеры использования

Пример 1: Стресс-тестирование бизнес-идеи

Вопрос: "Стоит ли нам переходить на подписочную модель?"

@Kimi      → Аналитический взгляд на метрики дохода
@Gemini    → Творческие альтернативы и гибридные модели
@Claude    → Логический анализ рисков
@Grok      → Практические шаги реализации

Результат: Всесторонний анализ вместо однобокого мнения одного экспекта.

Пример 2: Исследование противоречивой темы

Вопрос: "Как AI влияет на занятость?"

Каждая модель:
• Развивает свою позицию
• Реагирует на контраргументы других
• Признает сильные точки оппонентов
• Уточняет свои выводы

Результат: Нюансированное понимание многогранной проблемы.

Пример 3: Креативная сессия

Вопрос: "Какие новые функции привлекут пользователей?"

Режим: Creative (0.9) для максимальной генерации идей

Результат: Множество инновационных идей, проверенных на практичность другими агентами.

Лучшие практики

Для организаций

  1. Групповое обсуждение — Используйте Agent Debate для подготовки к важным решениям
  2. Документирование — Экспортируйте дебаты как отчёты для тиража
  3. Обучение — Показывайте, как AI разные модели анализируют сложные проблемы

Для исследователей

  1. Верификация — Проверьте гипотезу через разные модели
  2. Обнаружение предвзятости — Выявите, где модели расходятся
  3. Публикация — Документируйте многоагентные дебаты для исследовательских работ

Для разработчиков

  1. API-дизайн — Обсудите компромиссы с разных сторон
  2. Архитектура — Получите мнения о масштабируемости, надёжности, простоте
  3. Инновация — Генерируйте идеи на основе разных парадигм

Как это помогает в принятии решений

Традиционный подход:

Вы консультируетесь с одним экспертом → одна перспектива → риск предвзятости

С Agent Debate Consensus:

Четыре модели обсуждают → разные взгляды выявляются → предвзятость снижается →
лучшие решения → более высокая уверенность в результате

Ключевые преимущества:

  • ✅ Снижение предвзятости за счёт множественных перспектив
  • ✅ Экономия времени — четыре дебата параллельно, не последовательно
  • ✅ Улучшение качества — моделями проверяются аргументы друг друга
  • ✅ Документирование процесса — весь анализ записан и экспортируется
  • ✅ Полный контроль — вы модератор, не слушатель

Тёмный режим и адаптивность

  • Оптимизирован для длительных сессий — Комфортный тёмный режим уменьшает усталость глаз
  • Мобильный-первый — Полная функциональность на телефонах и планшетах
  • Адаптивные шрифты — Настройте размер текста под ваши предпочтения
  • Тёмная тема — По умолчанию включена, легко переключается

Развёртывание

Локально

npm run dev
# Доступно на http://localhost:3000

На Vercel (рекомендуется для Next.js)

vercel deploy

На собственном сервере

npm run build
npm run start

Публичный режим

Для развёртывания без встроенного API-ключа:

  1. Оставьте OPENROUTER_API_KEY пусто в .env
  2. Пользователи вводят собственные ключи в интерфейс
  3. Дебаты запускаются с их учётными данными

Лицензия

MIT — см. LICENSE для деталей.

Автор: Lexus2016

Live демо: https://lryq.com

Поддержка и вклад

Имеете вопросы или идеи? Отправьте Issue или Pull Request в репозиторий.

Как помочь проекту

  • Тестирование — Используйте платформу и сообщайте о проблемах
  • Идеи — Предлагайте новые функции через Issues
  • Вклад в код — Fork, делайте изменения, отправляйте PR
  • Документация — Улучшайте README и примеры

Большое спасибо за внимание к Agent Debate Consensus! 🎯