Prisma · AI Proposal Engine

Ako funguje Prisma AI Proposal Engine

Proces sa skladá z dvoch fáz: jednorazové nastavenie Partnera (znalostná databáza firmy) a opakovaná pipeline tvorby ponuky pre každého potenciálneho klienta. Celý cyklus je iteratívny – ak návrh nevyhovuje, dajú sa upraviť vstupy a vygenerovať nový návrh.

Príprava Partnera (jednorazovo)

Vytvor Partnera

Zaregistruj účtovnú firmu. Každý partner má vlastnú znalostnú databázu.

POST/api/partners/

Nahraj dokumenty

Cenníky, metodiky, ukážky ponúk, interné usmernenia. Formáty: PDF, DOCX, XLSX, EML, MSG.

POST/api/partners/{id}/documents/

DELETE/api/partners/{id}/documents/{doc}/

GET/api/partners/{id}/documents/{doc}/download/

Build Knowledge

AI prečíta všetky dokumenty a vytvorí znalostný string. Spúšťa sa automaticky pri každej zmene alebo manuálne.

POST/api/partners/{id}/build-knowledge/

✓

Partner

pripravený

Dokumenty sa dajú kedykoľvek doplniť alebo odstrániť – znalostná databáza sa automaticky prebuduje.

Tvorba cenovej ponuky (opakovaný proces)

Kroky 1–3 · Príprava podkladov

Vytvor cenovú ponuku

Priradí sa k Partnerovi, zadá sa meno klienta. Systém vygeneruje unikátne 8-znakové UID.

POST/api/quotes/

Nahraj prílohy klienta

voliteľné

Voliteľné doplnkové dokumenty špecifické pre túto ponuku (napr. existujúca zmluva, dotazník, finančné výkazy).

POST/api/quotes/{uid}/documents/

DELETE/api/quotes/{uid}/documents/{doc}/

Nahraj žiadosť

Hlavný vstup pre AI: email alebo dokument od klienta s popisom požiadaviek. Vždy max 1 súbor – nový nahradí starý.

POST/api/quotes/{uid}/request-file/

DELETE/api/quotes/{uid}/request-file/

GET/api/quotes/{uid}/request-file/download/

Kroky 4–6 · AI generovanie

Generuj doplňujúce otázky

voliteľné

AI analyzuje žiadosť + prílohy + znalostnú DB partnera. Vráti 0–10 cielených otázok pre spresnenie ponuky.

POST/api/quotes/{uid}/generate-questions/

Odpovedz na otázky

voliteľné

Obchodník vyplní odpovede. Prázdne odpovede sú povolené. Odpovede sa zarátajú do kontextu pri generovaní návrhu.

POST/api/quotes/{uid}/answer-questions/

Generuj návrh cenovej ponuky

AI vytvorí štruktúrovaný JSON návrh: odporúčaná cena, rozpad, jednorazové poplatky, text pre klienta, riziká, confidence.

POST/api/quotes/{uid}/generate-proposal/

Krok 7 · Ľudské hodnotenie

Stiahni / pozri návrh

Vráti hotový JSON návrh. Ak návrh ešte nebol vygenerovaný, vráti 404.

GET/api/quotes/{uid}/proposal/

👤 Ľudská revízia

Partner / obchodník skontroluje navrhovanú cenu, odôvodnenie, text ponuky, riziká a confidence skóre. Na základe revízie sa rozhodne o ďalšom postupe.

Rozhodnutie a koniec životného cyklu

✅

Návrh je hotový → ľudská revízia

Vygenerovaný návrh (cena, odôvodnenie, text, riziká, confidence) je finálny výstup tohto backendu. Schválenie, odoslanie klientovi a vyhodnotenie výsledku (won/lost) rieši ARVENA (ETL) – Prisma už nedrží stavový automat.

GET/api/quotes/{uid}/proposal/ → JSON návrh

🔄

Návrh nevyhovuje → upraviť a opakovať

Dajú sa upraviť ľubovoľné kroky – žiadosť, prílohy, odpovede na otázky – a celá pipeline sa spustí znova. Počet iterácií nie je obmedzený.

↺

Zmeniť žiadosť · nahradiť request-file → automaticky reset AI výstupov

↺

Pridať / odstrániť prílohy · quotes/{uid}/documents/

↺

Generovať nové otázky · generate-questions → vyplniť nové odpovede

↺

Generovať nový návrh · generate-proposal → nový JSON výstup

Odvodený stav (flagy)

Quote nemá stavový automat. Stav je plne odvodený z reálnych dát a vracia sa v poliflags – nikdy sa nemôže rozsynchronizovať. Všetko okrem partnera a čitateľnej žiadosti je voliteľné.

has_request_fileje nahraná žiadosť

request_file_readabležiadosť je čitateľná (true/false/null)

quote_documents_countpočet príloh k žiadosti

quote_documents_readable_countz toho čitateľných

questions_generatedboli generované otázky

questions_countpočet otázok

questions_answeredbolo odpovedané

answers_countpočet odpovedí

has_proposalexistuje návrh

partner_documents_countpočet súborov partnera

partner_has_knowledgepartner má znalostnú bázu

can_generate_proposalpripravená na generovanie návrhu

Jediná tvrdá podmienka na vygenerovanie návrhu je can_generate_proposal (= partner + čitateľná žiadosť). Generovanie je donekonečna opakovateľné.

Kompletný zoznam endpointov

Partner management

GET

/api/partners/Zoznam partnerov

POST

/api/partners/Vytvor partnera

GET

/api/partners/{id}/Detail partnera

DELETE

/api/partners/{id}/Zmaž partnera

POST

/api/partners/{id}/build-knowledge/Prebuduj znalostnú databázu

GET

/api/partners/{id}/documents/Zoznam dokumentov partnera

POST

/api/partners/{id}/documents/Nahraj dokument partnera

DELETE

/api/partners/{id}/documents/{doc_id}/Zmaž dokument partnera

GET

/api/partners/{id}/documents/{doc_id}/download/Stiahni dokument

Quote management

GET

/api/quotes/Zoznam cenových ponúk

POST

/api/quotes/Vytvor novú ponuku (→UID)

GET

/api/quotes/{uid}/Detail ponuky (vrátane flags)

PATCH

/api/quotes/{uid}/Premenuj klienta (client_name)

DELETE

/api/quotes/{uid}/Zmaž ponuku

POST

/api/quotes/{uid}/request-file/Nahraj / nahraď žiadosť

GET

/api/quotes/{uid}/request-file/Info o žiadosti

DELETE

/api/quotes/{uid}/request-file/Zmaž žiadosť

GET

/api/quotes/{uid}/request-file/download/Stiahni žiadosť

GET

/api/quotes/{uid}/documents/Zoznam príloh ponuky

POST

/api/quotes/{uid}/documents/Nahraj prílohu ponuky

DELETE

/api/quotes/{uid}/documents/{doc_id}/Zmaž prílohu ponuky

GET

/api/quotes/{uid}/documents/{doc_id}/download/Stiahni prílohu

POST

/api/quotes/{uid}/generate-questions/AI: generuj doplňujúce otázky

POST

/api/quotes/{uid}/answer-questions/Ulož odpovede na otázky

POST

/api/quotes/{uid}/generate-proposal/AI: generuj návrh ponuky

GET

/api/quotes/{uid}/proposal/Vráti JSON návrh (alebo 404)