Legalka KB

O produkcie

Legalka KB to baza wiedzy i bot Telegram do legalizacji pobytu w Polsce. Baza składa się z dwóch warstw: normatywnej (co wymaga prawo, z odwołaniami do artykułów) i praktycznej (realne terminy i wskazówki od wnioskodawców). Bot odpowiada wyłącznie z bazy, oznacza każdy fakt jako „norma" lub „praktyka — obserwacje wnioskodawców" i powstrzymuje się, gdy pytanie nie jest pokryte. Zero halucynacji.

Aktualne pokrycie: tymczasowy pobyt i praca (karta pobytu), wizy, banki, zatrudnienie, nieruchomości, podatki, ZUS, obywatelstwo, łączenie rodzin, edukacja, ochrona międzynarodowa — wszystko dla Polski.

Każde stwierdzenie cytuje artykuł ustawy lub oficjalne źródło. Bot odpowiada po ukraińsku, angielsku, rosyjsku i polsku. Wdrożenie na VPS przez GitHub Actions, lokalny panel review dla kuratora bazy wiedzy.

Kluczowe funkcje

• Ścisłe powiązanie ze źródłami — każde stwierdzenie cytuje artykuł ustawy lub oficjalne źródło
• Dwie warstwy treści: normatywna (zweryfikowana prawnie) i praktyczna (doświadczenia społeczności)
• Abstencja: bot mówi „nie wiem" zamiast halucynować
• Obsługa UA / EN / PL — treść po rosyjsku, bot odpowiada w każdym języku
• Bot Telegram wdrożony na VPS przez GitHub Actions
• Lokalny panel review — kurator widzi diff, czat z agentem AI do edycji, przycisk „zatwierdź"
• Pipeline zbierania praktyki z czatów Telegram z filtrem PII i automatycznym stagingiem
• Zestaw ewaluacyjny: citation ~99%, fact coverage ~97%, abstention 100%

Architektura agentów (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

Najczęściej zadawane pytania

Czym jest Legalka KB?

Bot Telegram i baza wiedzy do legalizacji pobytu w Polsce. Odpowiada wyłącznie z zweryfikowanych źródeł — z odwołaniami do przepisów i realnych doświadczeń wnioskodawców. Jeśli nie ma odpowiedzi — uczciwie mówi „nie wiem".

Jakie tematy pokrywa baza wiedzy?

Tymczasowy pobyt (karta pobytu), praca, wizy, banki, zatrudnienie, nieruchomości, podatki, ZUS, obywatelstwo, łączenie rodzin, edukacja, ochrona międzynarodowa — wszystko dla Polski.

W jakich językach odpowiada bot?

Bot rozumie i odpowiada po ukraińsku, angielsku, rosyjsku i polsku.

Jak zapewniana jest dokładność odpowiedzi?

Każdy fakt oznaczony jest jako „norma" (z odwołaniem do artykułu ustawy) lub „praktyka — obserwacje wnioskodawców". Jeśli pytanie nie jest pokryte przez bazę — bot się powstrzymuje. Zestaw ewaluacyjny: citation ~99%, fact coverage ~97%, abstention 100%.