← Wróć do czatu

Wiki funkcjonalności YCA

Ten przewodnik pokazuje najważniejsze funkcje YCA z perspektywy użytkownika i podpowiada, jak z nich korzystać w codziennej pracy na budowie.

Architektura narzędziowa YCA Next

  • YCA działa w architekturze tool-based: model LLM pełni rolę orkiestratora, a nie głównego źródła logiki biznesowej.
  • Model analizuje intencję, rolę użytkownika i kontekst projektu, a następnie uruchamia deterministyczne narzędzia.
  • Za rejestr narzędzi, kontrolę uprawnień i audyt wykonania odpowiada Tool Execution Gateway.

1. Zarządzanie projektem i etapami realizacji

  • Projekt to główny kontener pracy — porządkuje dokumenty, rozmowy i obliczenia.
  • Podczas tworzenia projektu ustawiasz kluczowe dane: identyfikator, lokalizację, powierzchnię użytkową i typ inwestycji.
  • Statusy cyklu życia pomagają kontrolować postęp: przygotowanie, realizacja, odbiory oraz zakończenie/archiwizacja.
  • Możesz dodawać podprojekty (np. kuchnia, łazienka), aby uzyskać bardziej precyzyjne rekomendacje dla danego obszaru.

2. Inteligentna biblioteka dokumentów

  • Biblioteka obsługuje trzy zakresy: globalny, projektowy i konwersacyjny.
  • Dodajesz PDF, DOCX i obrazy (do 50 MB), a system wykonuje OCR i ekstrakcję tabel.
  • Dokumenty można filtrować po producencie, kategorii i statusie przetwarzania.
  • Dla plików dostępna jest historia zmian i wcześniejsze wersje.

3. Zaawansowany chat AI (Łajka)

  • Łajka działa jako asystent branżowy oparty o narzędzia i źródła dokumentowe, a nie ogólne domysły.
  • Odpowiedzi są kontekstowe — uwzględniają rolę użytkownika i stan projektu.
  • Nowi użytkownicy mogą testować system anonimowo (do 5 wiadomości), a potem założyć konto i zachować historię.
  • Obsługiwany jest tryb głosowy oraz cytowanie źródeł (np. DWU/TDS), co zwiększa transparentność decyzji.

4. Weryfikacja zgodności i produktów

  • Możesz zapytać: „czy ten produkt mogę legalnie zastosować w tym miejscu?”.
  • System porównuje zastosowanie z wymaganiami (m.in. WT-2021 i CPR UE) i pokazuje dowody z dokumentów.
  • Panel dowodowy zawiera cytaty z DWU i TDS, które potwierdzają lub wykluczają użycie produktu.
  • Dostępne jest porównanie produktów różnych producentów, także przy różnych nazwach tych samych parametrów.

5. Listy zakupowe i narzędzia obliczeniowe

  • Na podstawie rozmowy możesz wygenerować ustrukturyzowaną listę zakupową.
  • Lista zawiera m.in. nazwę elementu, ilość szacunkową i notatki techniczne.
  • Wyniki możesz eksportować do PDF lub CSV.
  • Wbudowany kalkulator wspiera przeliczenia jednostek i zapotrzebowania materiałowego z pełnym śladem obliczeń.

6. Artefakty i zatwierdzanie

  • YCA tworzy artefakty: wersjonowane i niezmienne wyniki, np. raporty odbiorowe i podsumowania zgodności.
  • Gotowe artefakty można przekazać do akceptacji przełożonego.
  • Po zatwierdzeniu dokument trafia do trwałego, audytowalnego rejestru projektu.

Narzędzia systemowe i przykładowe struktury JSON

Compliance Verification Tool (`verify_compliance`)

Sprawdza, czy produkt może być legalnie i technicznie zastosowany w konkretnym użyciu; status: Compliant / Not Compliant / Conditionally Compliant.

Request JSON

{
  "tool": "verify_compliance",
  "product_name": "Ceresit CR 65",
  "use_case": "hydroizolacja balkonu",
  "regulations": [
    "WT-2021",
    "CPR 305/2011"
  ],
  "project_id": "proj_001"
}

Response JSON

{
  "status": "Conditionally Compliant",
  "summary": "Wymagane jest zastosowanie warstwy systemowej i zachowanie zakresu temperatur z TDS.",
  "evidence": [
    {
      "source": "DWU",
      "quote": "Produkt do uszczelnień mineralnych...",
      "page": 2
    }
  ]
}

Calculate Tool (`calculate`)

Wykonuje deterministyczne obliczenia (przeliczenia jednostek, ilości materiału, obliczenia powierzchni/objętości) z pełnym śladem obliczeń.

Request JSON

{
  "tool": "calculate",
  "formula": "material_quantity",
  "input": {
    "area_m2": 16,
    "layers": 2,
    "consumption_kg_per_m2": 1.5,
    "waste_factor": 0.1
  }
}

Response JSON

{
  "result": {
    "total_kg": 52.8,
    "rounded_bags_25kg": 3
  },
  "provenance": [
    "16 * 2 * 1.5 = 48 kg",
    "48 * 1.1 = 52.8 kg"
  ]
}

Product & Material Tool (`compare`)

Porównuje produkty i zwraca różnice parametrów wraz z oceną podobieństwa wspierającą zamienniki materiałowe.

Request JSON

{
  "tool": "compare",
  "products": [
    "weberep R2",
    "Sopro RS 462"
  ],
  "dimensions": [
    "class",
    "layer_thickness",
    "substrate",
    "temperature_range"
  ]
}

Response JSON

{
  "similarity_score": 0.84,
  "comparison": {
    "class": {
      "left": "R2",
      "right": "R2"
    },
    "layer_thickness": {
      "left": "2-30 mm",
      "right": "3-30 mm"
    }
  }
}

Product & Material Tool (`check`)

Weryfikuje, czy pojedynczy produkt spełnia zadane kryteria aplikacyjne (np. podłoże, temperatura, wilgotność, zastosowanie).

Request JSON

{
  "tool": "check",
  "product_name": "ATLAS WODER E",
  "criteria": {
    "substrate": "beton",
    "min_temp_c": 5,
    "zone": "wet"
  }
}

Response JSON

{
  "passed": true,
  "details": [
    {
      "criterion": "substrate",
      "passed": true
    },
    {
      "criterion": "min_temp_c",
      "passed": true
    }
  ]
}

Regulation Audit Tool (`regulation_audit`)

Wykonuje audyt kompletności dokumentów produktu względem regulacji (np. CPR 305/2011) i generuje checklistę audytową.

Request JSON

{
  "tool": "regulation_audit",
  "product_name": "ATLAS SILKON BA",
  "doc_type": "DWU",
  "checklist_id": 1
}

Response JSON

{
  "audit_status": "incomplete",
  "checklist": [
    {
      "code": "dwu.01",
      "required": true,
      "present": true
    },
    {
      "code": "dwu.08",
      "required": false,
      "present": false
    }
  ]
}

retrieve_project_decision (`retrieve_project_decision`)

Pobiera historyczne decyzje projektowe z audytu wraz z uzasadnieniem, ryzykami i listą dokumentów źródłowych.

Request JSON

{
  "tool": "retrieve_project_decision",
  "project_id": "proj_001",
  "scope": "hydroizolacja",
  "limit": 10
}

Response JSON

{
  "status": "ok",
  "decisions": [
    {
      "decision_id": "dec_1",
      "title": "Dobor systemu hydroizolacji",
      "justification": "Zgodnosc z DWU",
      "sources": [
        "DWU",
        "TDS"
      ]
    }
  ]
}

assess_product_replacement (`assess_product_replacement`)

Ocenia, czy zamiennik produktu jest technicznie uzasadniony dla danego zastosowania i wskazuje ryzyka braku równoważności.

Request JSON

{
  "tool": "assess_product_replacement",
  "original_product": "ATLAS WODER E",
  "replacement_product": "Ceresit CR 65",
  "intended_application": "hydroizolacja balkonu"
}

Response JSON

{
  "status": "ok",
  "verdict": "conditionally_acceptable",
  "key_differences": [
    "zakres temperatur aplikacji"
  ]
}

verify_as_built_documentation (`verify_as_built_documentation`)

Sprawdza kompletność dokumentacji powykonawczej (prawnej i producenta) dla produktów użytych w zakresie robót.

Request JSON

{
  "tool": "verify_as_built_documentation",
  "products": [
    {
      "name": "Ceresit CR 65",
      "application": "hydroizolacja balkonu"
    }
  ],
  "scope_of_works": "odbior prac hydroizolacyjnych",
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "overall_status": "partial",
  "products": [
    {
      "name": "Ceresit CR 65",
      "legal_docs": {
        "missing": [
          "CPR"
        ]
      },
      "manufacturer_docs": {
        "available": [
          "TDS"
        ]
      }
    }
  ]
}

compare_systems (`compare_systems`)

Porównuje dwa systemy budowlane na podstawie dokumentacji i zwraca wyłącznie faktyczne różnice oraz braki danych.

Request JSON

{
  "tool": "compare_systems",
  "system_a_name": "W112",
  "system_a_manufacturer": "Knauf",
  "system_b_name": "W112",
  "system_b_manufacturer": "Norgips",
  "intended_use": "sciana dzialowa"
}

Response JSON

{
  "status": "ok",
  "comparison": {
    "documented_differences": [
      "grubosc systemu"
    ],
    "missing_data": []
  }
}

work_continuation_assessment (`work_continuation_assessment`)

Ocenia, czy prace mogą być kontynuowane w danym zakresie na podstawie udokumentowanych warunków, ryzyk i wymagań.

Request JSON

{
  "tool": "work_continuation_assessment",
  "scope": "hydroizolacja balkonu",
  "products": [
    {
      "name": "ATLAS WODER E",
      "vendor": "Atlas"
    }
  ],
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "can_continue": false,
  "risks": [
    "zbyt niska temperatura"
  ],
  "required_conditions": [
    "min. +5C"
  ]
}

generate_inspection_note (`generate_inspection_note`)

Generuje neutralną notatkę/protokół odbioru z ustaleniami opartymi na dowodach i cytatach ze źródeł.

Request JSON

{
  "tool": "generate_inspection_note",
  "scope": "hydroizolacja balkonu",
  "products": [
    {
      "name": "Ceresit CR 65",
      "pg_product_id": 101
    }
  ],
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "note": {
    "summary": "Stwierdzono braki w warunkach aplikacji",
    "findings": [
      {
        "type": "non_compliance",
        "evidence_source": "TDS"
      }
    ]
  }
}

identify_work_continuation_basis (`identify_work_continuation_basis`)

Wskazuje udokumentowane podstawy do kontynuacji lub wstrzymania robót w zadanych warunkach wykonania.

Request JSON

{
  "tool": "identify_work_continuation_basis",
  "product_or_system": "Sopro BDS 851",
  "execution_conditions": "temperatura 3C, wilgotne podloze"
}

Response JSON

{
  "status": "ok",
  "basis": [
    {
      "requirement": "minimalna temperatura",
      "documented": true,
      "source": "TDS"
    }
  ]
}

diagnose_failure (`diagnose_failure`)

Wykonuje diagnostykę po awarii: mapuje objawy na ostrzeżenia, wykluczenia i zasady aplikacji opisane w dokumentacji.

Request JSON

{
  "tool": "diagnose_failure",
  "symptom_description": "pecherze i odspojenia po 3 dniach",
  "products_used": [
    "Ceresit CR 65"
  ],
  "application_context": "hydroizolacja balkonu",
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "possible_causes": [
    "wilgotne podloze"
  ],
  "evidence": [
    {
      "source": "TDS",
      "quote": "Stosowac na suchym podlozu"
    }
  ]
}

generate_dispute_defense (`generate_dispute_defense`)

Buduje ranking argumentów dla jednej strony sporu na podstawie dowodów z dokumentów.

Request JSON

{
  "tool": "generate_dispute_defense",
  "claim_description": "Inwestor twierdzi, ze izolacja byla niezgodna",
  "counterparty_position": "Wykonawca stosowal sie do instrukcji",
  "counterparty_role": "wykonawca",
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "strength": "medium",
  "arguments": [
    {
      "rank": 1,
      "claim": "Zgodnosc z warunkami TDS",
      "evidence_source": "TDS"
    }
  ]
}

generate_shopping_list (`generate_shopping_list`)

Generuje ustrukturyzowaną listę zakupową na podstawie opisu zadania i wskazanych materiałów.

Request JSON

{
  "tool": "generate_shopping_list",
  "project_description": "remont lazienki 12m2",
  "materials_mentioned": [
    "hydroizolacja",
    "klej do plytek"
  ],
  "vendors_preferred": [
    "Atlas"
  ],
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "items": [
    {
      "product_name": "ATLAS WODER E",
      "qty_estimate": "2 x 10kg",
      "reason": "hydroizolacja stref mokrych"
    }
  ]
}

retrieve_warnings_and_conditions (`retrieve_warnings_and_conditions`)

Zwraca checklistę zapobiegania błędom: wymagania podłoża, warunki aplikacji, typowe pomyłki i ostrzeżenia.

Request JSON

{
  "tool": "retrieve_warnings_and_conditions",
  "product_name": "Ceresit CR 65",
  "scope_of_work": "hydroizolacja balkonu",
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "checklist": {
    "conditions": [
      "min. +5C"
    ],
    "common_mistakes": [
      "brak gruntowania"
    ],
    "warnings": [
      "nie stosowac przy opadach"
    ]
  }
}

get_contractor_profile (`get_contractor_profile`)

Zwraca profil wykonawcy: specjalizacje, preferencje oraz wnioski i lekcje z poprzednich realizacji.

Request JSON

{
  "tool": "get_contractor_profile"
}

Response JSON

{
  "status": "ok",
  "profile": {
    "specializations": [
      "hydroizolacje"
    ],
    "preferred_vendors": [
      "Atlas"
    ],
    "lessons_count": 12
  }
}

generate_defensive_note (`generate_defensive_note`)

Generuje krótką notatkę obronną dla decyzji produktowej wraz z dowodami i znanymi ograniczeniami.

Request JSON

{
  "tool": "generate_defensive_note",
  "product_name": "Ceresit CR 65",
  "decision_context": "wybor produktu do hydroizolacji",
  "intended_application": "hydroizolacja balkonu",
  "pg_product_id": 101,
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "note": "Decyzja oparta o TDS/DWU przy zachowaniu warunkow aplikacji.",
  "limitations": [
    "brak danych dla temperatur <5C"
  ]
}

get_project_history (`get_project_history`)

Pobiera historię projektów użytkownika, w tym statusy, decyzje i zapisane artefakty.

Request JSON

{
  "tool": "get_project_history",
  "limit": 10,
  "lifecycle_status": "completed"
}

Response JSON

{
  "status": "ok",
  "projects": [
    {
      "project_id": "proj_001",
      "project_type": "renovation",
      "lifecycle_status": "completed",
      "artifact_count": 4
    }
  ]
}

create_lesson_from_failure_diagnostics (`create_lesson_from_failure_diagnostics`)

Tworzy nową lekcję (lessons learned) na podstawie wybranego artefaktu diagnostyki awarii.

Request JSON

{
  "tool": "create_lesson_from_failure_diagnostics",
  "artifact_id": "art_998"
}

Response JSON

{
  "status": "ok",
  "lesson_id": "lesson_321",
  "created": true
}

get_weather_conditions (`get_weather_conditions`)

Pobiera pogodę dla lokalizacji budowy i opcjonalnie ocenia warunki aplikacji produktu (GO/CAUTION/NO-GO).

Request JSON

{
  "tool": "get_weather_conditions",
  "location": "Warszawa",
  "product_name": "Ceresit CT 190"
}

Response JSON

{
  "status": "ok",
  "weather": {
    "temperature_c": 7,
    "relative_humidity_pct": 78,
    "precipitation_mm": 0
  },
  "product_assessment": {
    "verdict": "CAUTION",
    "catalog_hit": true
  }
}

analyze_dispute (`analyze_dispute`)

Tworzy neutralne podsumowanie techniczne sporu na podstawie dokumentacji: wymagania udokumentowane vs obszary nieokreślone.

Request JSON

{
  "tool": "analyze_dispute",
  "disputed_scope": "sporna hydroizolacja balkonu",
  "products_involved": [
    {
      "name": "Ceresit CR 65",
      "pg_product_id": 101
    }
  ],
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "summary": "Czesc wymagan jest udokumentowana, czesc nie jest jednoznaczna.",
  "documented_requirements": [
    "gruntowanie podloza"
  ],
  "not_defined_by_docs": [
    "dokladny czas schniecia przy 3C"
  ]
}

rules_evaluator (`rules_evaluator`)

Ocenia treść względem zestawu reguł i zwraca wynik pass/fail dla każdej reguły oraz łączny poziom zgodności.

Request JSON

{
  "tool": "rules_evaluator",
  "content": "Deklaracja wlasciwosci uzytkowych...",
  "rule": {
    "id": 1,
    "rule_details": [
      {
        "name": "dwu.01",
        "rule_description": "Identyfikacja wyrobu",
        "score": 1
      }
    ]
  }
}

Response JSON

{
  "status": "ok",
  "compliance_score": 1,
  "violations": [],
  "checks": [
    {
      "rule": "dwu.01",
      "passed": true
    }
  ]
}

generate_dispute_arguments (`generate_dispute_arguments`)

Generuje ukierunkowane argumenty dla wskazanej strony sporu budowlanego na podstawie dowodów z DWU/TDS.

Request JSON

{
  "tool": "generate_dispute_arguments",
  "counterparty_role": "wykonawca",
  "claim_description": "Inwestor kwestionuje dobor zaprawy",
  "counterparty_position": "Produkt dobrany zgodnie z dokumentacja",
  "products_involved": [
    "ATLAS WODER E"
  ],
  "language": "pl"
}

Response JSON

{
  "status": "ok",
  "strength": "high",
  "arguments": [
    {
      "rank": 1,
      "thesis": "Produkt dopuszczony do zastosowania",
      "evidence_source": "DWU"
    }
  ]
}

Uwaga: YCA jest zoptymalizowane pod urządzenia mobilne i PWA, dzięki czemu możesz wygodnie korzystać z systemu bezpośrednio na budowie.