RU Asking the Base - VVG-web/aurora-studio GitHub Wiki

Спросить базу

Wiki · см. также: Доверие · Агент · Ассистенты, MCP и скиллы

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

Способ Когда Результат
раздел Спросить / agent:ask нужен ответ своими словами ответ только по карточкам, ссылка на каждое утверждение, проверка Момусом
ctx:context <тема> проверенный контекст вставляется в любой запрос или инструмент выборка карточек с заголовками доверия и основаниями
сервер MCP ассистент сам ищет в базе, пока работает поиск, чтение карточки, сборка пакета — только чтение

Спросить

В разделе Спросить напишите вопрос как коллеге. Движок собирает контекст из карточек; модель отвечает только по ним и ставит ссылку на каждое утверждение; затем ответ проверяет Момус: утверждение либо подтверждено цитатой, либо помечено «без опоры». Разговор хранится в AuroraKnowledgeDB/meta/ask/ обычным Markdown и уходит в git вместе с базой: что спрашивала команда и что ответила база — общее знание. Разговор, показавший пробел в базе, — повод завести карточку.

  • Уточнить, не теряя контекста: agent:ask --thread <id> (панель продолжает открытый разговор).
  • Выбрать модель: --backend N спрашивает один шлюз из кольца (1 — основной).
  • Выбрать, что учитывать: режимы — только доверенное; всё, включая черновики; только встречи; доверенное и встречи. Сказанное на встрече не проходит в «только доверенное»: встреча — не подписанный документ.
  • Не вести журнал: --no-journal пропускает файл разговора (так вызывает сервер MCP: он только читает).
  • «Почему мы выбрали X? Почему не Y?» — ctx:ask <вопрос> отвечает с цитатами, включая отклонённые и заменённые Decision Records.

Пакеты контекста

ctx:context <тема> отбирает карточки и печатает каждую с заголовком доверия и основанием — не «черновик», а «PRJ-123 в работе». Полезные флаги: --mode generate|review|ask|evaluate|meetings|trusted_meetings, --max-cards, --budget, --save (в Artifacts/drafts/). В режиме generate попадает доверенное знание и принятые Decision Records (пока база молода — bootstrap — и помеченные черновики): требования строят только на доверенном; ask добавляет отклонённые и заменённые.

Правило любого ручного пути: сначала соберите контекст, не подсовывайте ассистенту страницы Confluence как истину. Разница между «карточкой со статусом knowledge и основанием» и «страницей из вики» — это разница между фактом и слухом.

Когда база не знает

Решает сам движок, без обращения к модели. Он считает, сколько слов вопроса (с весом по редкости) вместе находят пять лучших доверенных карточек, — число абсолютное, а не доля от лучшего совпадения:

  • Достаточно — обычный пак.
  • Частично — пак открывается пометкой «Слабая опора» и перечнем слов, которых в базе нет; отвечать только по найденному и назвать, чего не хватило (kb:question). agent:ask помечает такой ответ weak_basis и печатает строку «Слабая опора» в отчёте.
  • Почти ничего, и нет ни близости по смыслу, ни точного номера — пака нет: «в базе этого нет» со списком недостающих слов. Так судятся только вопросы; длинная постановка задачи — нет, а agent:make и контекст бота зовут поиск с abstain=0: им нужен пак из частично совпавшего. Пак из одного справочника аббревиатур выдачей не считается.

Если лучшие кандидаты скрыты фильтром доверия (карточка draft в режиме generate), пак или отказ говорят об этом: сколько, с какими статусами и лучшее имя — без тела. Прочитать их можно, повторив в evaluate. Пороги — ключи weak и abstain в RETRIEVAL (abstain=0 выключает отказ); ops:search-quality --compare показывает, какая доля промахов — фильтр статуса или релиза, а не сам поиск.

Документ agent:make, сославшийся на непроверенную карточку (молодая база, bootstrap), остаётся status: draft, а в шапке — basis_unverified и строка в «Допущениях».

Как работает поиск

Поиск сочетает слова со смыслом: семантический индекс (kb:embed) держит вектор на карточку и лежит вне git (пересобирается по требованию). Заготовки (placeholder) и архив исключены. К выборке могут присоединиться связанные и ссылающиеся соседи; свёрнутый сосед несёт суть, а не тело.

Два сторожа держат ранжирование честным:

Команда Измеряет
ops:retrieval какие карточки приходят первыми по реальным вопросам аналитиков и что изменилось с прошлого раза
ops:search-quality находит ли база сама себя: тезис карточки как вопрос, правильный ответ известен по построению — R@1, R@5, MRR

Чему верить в ответе

Ответ хорош ровно настолько, насколько хорошо его основание: читайте заголовок (knowledge или draft и почему), предпочитайте утверждения с цитатой и считайте «без опоры» задачей для человека, а не фактом. → Доверие


Эта wiki собирается из папки wiki/ репозитория — правьте страницы там, изменения, сделанные здесь, будут перезаписаны. · Home

⚠️ **GitHub.com Fallback** ⚠️