Legalka KB

O produkcie

Legalka KB to baza wiedzy i darmowy bot Telegram dla każdego, kto przechodzi legalizację pobytu w Polsce. Kluczowa różnica wobec zwykłego chatbota jest taka, że on nie zmyśla. Każda odpowiedź pochodzi wyłącznie ze zweryfikowanej bazy wiedzy, a jeśli w bazie nie ma odpowiedzi, bot uczciwie mówi «nie wiem», zamiast wymyślać numery kont, terminy i adresy urzędów.

Baza ma dwie warstwy, których nigdy się nie miesza: «norma» — to, czego wymaga prawo, z odnośnikiem do źródła przy każdym fakcie — oraz «praktyka» — realne terminy i obserwacje wnioskodawców, zawsze z datą ważności. Każdy fakt w odpowiedzi jest oznaczony jako «norma» lub «praktyka», zawiera oficjalne linki do samodzielnej weryfikacji, a sama odpowiedź przychodzi w języku Twojego pytania. Pokrycie: pobyt i praca (karta pobytu), wizy, banki, zatrudnienie, nieruchomości, podatki, ZUS, obywatelstwo, łączenie rodzin, edukacja, ochrona międzynarodowa — wszystko dla Polski.

Pytania nie trzeba pisać — można je podyktować głosem, a każdą odpowiedź bot potrafi odczytać na głos. Pod odpowiedzią są wygodne przyciski: oceń 👍/👎, pokaż polski adres na mapie, zamień odpowiedź w osobistą listę kontrolną albo zaproponuj poprawkę. Interfejs i odpowiedzi są dostępne w pięciu językach — rosyjskim, ukraińskim, białoruskim, polskim i angielskim — a bot pamięta kilka równoległych rozmów, więc możesz prowadzić osobne wątki bez mieszania kontekstu.

Za kulisami warstwa praktyczna wypełniana jest półautomatycznie: osobny potok przetwarza czaty diaspory, anonimizuje dane i porządkuje fakty według tematów, a kurator sprawdza i zatwierdza każdą stronę przez lokalny panel z agentem AI do poprawek. Jakość odpowiedzi jest mierzona na zestawie pytań kontrolnych, a nie zakładana. Cały stos można uruchomić na własnym serwerze, podmieniając modele chmurowe na lokalne — co ma znaczenie przy wrażliwych danych relokacyjnych.

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 / BE / 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 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

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