Legalka KB

About this product

Legalka KB is a knowledge base and Telegram bot for legalisation in Poland. The base consists of two layers: normative (what the law requires, with references to articles) and practical (real timelines and tips from applicants). The bot only answers from the base, marks each fact as "norm" or "practice — applicant observations", and abstains if the question is not covered. No hallucinations.

Current coverage: temporary residence and work (karta pobytu), visas, banking, employment, real estate, taxes, ZUS, citizenship, family reunification, education, international protection — all for Poland.

Every statement cites a law article or official source. The bot responds in Ukrainian, English, Russian, and Polish. Deployed on VPS via GitHub Actions, with a local review panel for the knowledge base curator.

Key features

• Strict source binding — every statement cites a law article or official source
• Two content layers: normative (legally verified) and practical (community experience)
• Abstention: the bot says "I don't know" instead of hallucinating
• UA / EN / PL support — content in Russian, bot responds in any language
• Telegram bot deployed on VPS via GitHub Actions
• Local review panel — curator sees diff, AI agent chat for editing, approve button
• Practice collection pipeline from Telegram chats with PII filter and automatic staging
• Eval suite: citation ~99%, fact coverage ~97%, abstention 100%

Agent Architecture (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

Frequently asked questions

What is Legalka KB?

A Telegram bot and knowledge base for legalisation in Poland. It answers strictly from verified sources — with references to laws and real applicant experience. If there's no answer — it honestly says "I don't know".

What topics does the knowledge base cover?

Temporary residence (karta pobytu), work, visas, banking, employment, real estate, taxes, ZUS, citizenship, family reunification, education, international protection — all for Poland.

What languages does the bot support?

The bot understands and responds in Ukrainian, English, Russian, and Polish.

How is answer accuracy ensured?

Every fact is marked as "norm" (with a law article reference) or "practice — applicant observations". If a question is not covered by the base — the bot abstains. Eval suite shows: citation ~99%, fact coverage ~97%, abstention 100%.