Legalka KB

О продукте

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

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

Каждое утверждение цитирует статью закона или официальный источник. Бот отвечает на русском, украинском, английском и польском языках. Деплой на VPS через GitHub Actions, локальная панель ревью для куратора базы.

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

• Строгая привязка к источникам — каждое утверждение цитирует статью закона или официальный источник
• Два слоя контента: нормативный (юридически выверенный) и практический (опыт сообщества)
• Abstention: бот говорит «не знаю» вместо галлюцинаций
• Поддержка UA / 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 LR
        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 LR
        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 LR
        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

    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%.