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 dobrý → schváliť a odoslať

Ponuka sa schváli, odošle klientovi. Po výsledku rokovania sa označí ako úspešná alebo neúspešná. Koniec životného cyklu.

PATCH/api/quotes/{uid}/ → status: approved

PATCH/api/quotes/{uid}/ → status: sent

PATCH/api/quotes/{uid}/ → status: won / lost

🔄

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

Prehľad stavov Quote

createdQuote vytvorená

request_uploadedŽiadosť nahraná

questions_generatedOtázky vygenerované

answers_providedOdpovede poskytnuté

proposal_generatedNávrh vygenerovaný

approvedSchválená

sentOdoslaná klientovi

won✓ Úspešná

lost✗ Neúspešná

Automatické stavy: created → request_uploaded → questions_generated → answers_provided → proposal_generated · Manuálne (PATCH): approved → sent → won / lost

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 (všetky dáta)

PATCH

/api/quotes/{uid}/Manuálna zmena statusu

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)