Legalka KB

О продукте

Legalka KB — это база знаний и бесплатный Telegram-бот для тех, кто проходит легализацию в Польше. Главное отличие от обычного чат-бота в том, что он не фантазирует. Все ответы бот берёт строго из проверенной базы знаний, а если ответа там нет — честно говорит «не знаю» вместо того, чтобы выдумывать номера счетов, сроки и адреса ужендов.

База состоит из двух слоёв, которые никогда не смешиваются: «норма» — то, что требует закон, со ссылкой на источник по каждому факту, и «практика» — реальные сроки и наблюдения заявителей, всегда с датой актуальности. Каждый факт в ответе помечен как «норма» или «практика», сопровождается официальными ссылками для самостоятельной проверки, а сам ответ приходит на языке вопроса. Покрытие: карта побыту и работа, визы, банки, трудоустройство, недвижимость, налоги, ZUS, гражданство, воссоединение семьи, образование, международная защита — всё для Польши.

Вопрос можно не печатать, а надиктовать голосом; любой ответ бот умеет зачитать вслух. Под ответом — удобные кнопки: оценить 👍/👎, показать польский адрес на карте, собрать из ответа личный чек-лист, предложить правку. Интерфейс и ответы доступны на пяти языках — русском, украинском, белорусском, польском и английском, — а бот помнит несколько параллельных диалогов, так что можно вести отдельные темы, не путая контекст.

За кулисами практический слой наполняется полуавтоматически: отдельный конвейер обрабатывает чаты диаспоры, обезличивает данные и раскладывает факты по темам, а куратор проверяет и одобряет каждую страницу через локальную панель с ИИ-агентом правок. Качество ответов измеряется на наборе контрольных вопросов, а не предполагается. Весь стек можно развернуть на собственном сервере и заменить облачные модели на локальные — для чувствительных данных о релокации это важно.

Ключевые возможности

• Строгая привязка к источникам — каждое утверждение цитирует статью закона или официальный источник
• Два слоя контента: нормативный (юридически выверенный) и практический (опыт сообщества)
• Abstention: бот говорит «не знаю» вместо галлюцинаций
• Поддержка UA / BE / EN / PL — контент на русском, бот отвечает на любом языке
• Telegram-бот с деплоем на VPS через GitHub Actions
• Локальная панель ревью — куратор видит diff, чат с AI-агентом для редактирования, кнопка «одобрить»
• Pipeline сбора практики из Telegram-чатов с PII-фильтром и автоматическим staging
• Eval-набор: citation ~99%, fact coverage ~97%, abstention 100%

Архитектура агентов (LangGraph)

flowchart TD
    U([Telegram Message]) --> BOT[Bot Front-end<br/>Language · Region · Commands]
    BOT --> R{Message type?}
    R -- Question --> RAG
    R -- /suggest --> SUG[Suggestion Flow<br/>PII guard → stage]
    R -- KB Review --> REV

    subgraph RAG [RAG Assistant · rag/]
        direction TB
        IDX[index.json<br/>kb/ embeddings] --> RET[Retrieve<br/>cosine top-K]
        RET --> J{Coverage?}
        J -- No --> ABS([Abstain<br/>не знаю])
        J -- Yes --> ANS[Answer<br/>норма · практика · citations]
    end

    subgraph REV [AI Revision Agent · LangGraph]
        direction TB
        L[loadPage] --> CI[classifyIntent]
        CI -- question --> AM[answerMsg]
        CI -- edit --> MP[makePlan]
        MP --> RB[reviseBody]
        RB --> CB[checkBody]
        CB -- invalid --> RB
        CB -- ok --> WF[writeFile]
        CB -- abort --> AB[abort]
    end

    subgraph PIPE [Practice Ingest Pipeline · LangGraph]
        direction TB
        IM[ingest_messages] --> TR[thread_reconstruct]
        TR --> EF[extract_facts · LLM]
        EF --> PG{pii_guard<br/>fail-closed}
        PG -- PII --> DROP([drop])
        PG -- clean --> CT[classify_topic]
        CT --> DM[dedup_merge]
        DM --> SF[stage_facts<br/>inbox/facts-*.md]
    end

    SF -. curator .-> IDX

    ANS --> END([Response + disclaimer])
    AM --> END
    WF --> END
    AB --> END
    SUG --> END

Часто задаваемые вопросы

Что такое Legalka KB?

Telegram-бот и база знаний для легализации в Польше. Отвечает строго из верифицированных источников — со ссылками на законы и реальный опыт заявителей. Если ответа нет — честно говорит «не знаю».

Какие темы покрывает база?

Временный вид на жительство (karta pobytu), работа, визы, банки, трудоустройство, недвижимость, налоги, ZUS, гражданство, воссоединение семьи, обучение, международная защита — всё по Польше.

На каких языках отвечает бот?

Бот понимает и отвечает на русском, украинском, английском и польском языках.

Как обеспечивается точность ответов?

Каждый факт маркирован как «норма» (со ссылкой на статью закона) или «практика — наблюдения заявителей». Если вопрос не покрыт базой — бот воздерживается. Eval-набор показывает: citation ~99%, fact coverage ~97%, abstention 100%.