# KUMA GEST - Prompt Templates per AI Ingestion e RAG

## 1. RAG RETRIEVAL PROMPT
---
Sei un assistente esperto di KUMA GEST, il software gestione condomini italiano.
Usa SOLO le informazioni fornite nel contesto per rispondere.
Se la risposta non è nel contesto, rispondi: "Non ho informazioni sufficienti su questo argomento."

Contesto:
{context}

Domanda dell'utente: {query}

Rispondi in italiano, in modo chiaro e conciso. Se applicabile, includi:
- Passaggi specifici da seguire
- Il portale/modulo di riferimento
- Link alla documentazione pertinente
---

## 2. Q&A GENERATION PROMPT
---
Dato il seguente contenuto della documentazione KUMA GEST, genera 5 domande e risposte in formato FAQ.

Contenuto:
{document_chunk}

Requisiti:
- Domande in linguaggio naturale (come le porrebbe un utente)
- Risposte concise ma complete (max 100 parole)
- Include almeno 1 domanda "come fare" (how-to)
- Include almeno 1 domanda di confronto/valutazione
- Formato output: JSON array di {question, answer}
---

## 3. SUMMARIZATION PROMPT
---
Riassumi il seguente contenuto della documentazione KUMA GEST in massimo 3 frasi.
Mantieni: funzionalità chiave, benefici per l'utente, differenziatori.
Ignora: dettagli tecnici di implementazione, versioni specifiche.

Contenuto:
{document_chunk}

Output: Riassunto in italiano, max 3 frasi.
---

## 4. STEP-BY-STEP EXTRACTION PROMPT
---
Dal seguente contenuto, estrai una procedura passo-passo che un utente può seguire.

Contenuto:
{document_chunk}

Formato output:
1. [Azione specifica]
2. [Azione specifica]
...

Regole:
- Ogni step deve essere un'azione concreta e verificabile
- Includi il percorso di navigazione (Menu > Sezione > Pulsante)
- Massimo 10 step per procedura
- Se ci sono prerequisiti, elencali prima degli step
---

## 5. ENTITY EXTRACTION PROMPT
---
Estrai le entità strutturate dal seguente contenuto KUMA GEST.

Contenuto:
{document_chunk}

Entità da estrarre:
- features: [lista funzionalità menzionate]
- portals: [portali coinvolti: super_admin|amministratori|operatori|residenti|impresa]
- integrations: [servizi esterni menzionati]
- user_actions: [azioni che l'utente può compiere]
- legal_references: [riferimenti normativi citati]

Output: JSON con le chiavi sopra indicate.
---

## 6. CLASSIFICATION PROMPT
---
Classifica la seguente domanda dell'utente in una delle categorie KUMA GEST.

Domanda: {user_query}

Categorie:
- INTERVENTI: manutenzione, guasti, operatori, schede lavoro
- CONTABILITA: bilancio, rate, pagamenti, morosità, riconciliazione
- ASSEMBLEE: convocazione, votazione, quorum, verbale, deleghe
- FATTURAZIONE: fatture SDI, XML, sistema interscambio
- PORTALE_RESIDENTI: segnalazioni, documenti, comunicazioni
- PORTALE_IMPRESA: contabilità aziendale, KPI, ragione sociale
- AI_LEGAL: diritto condominiale, codice civile, normativa
- TECNICO: installazione, PWA, compatibilità, performance
- COMMERCIALE: prezzi, piani, prova gratuita

Output: {category: "...", confidence: 0.0-1.0, suggested_portal: "..."}
---

## 7. MULTI-LANGUAGE TRANSLATION PROMPT
---
Traduci il seguente contenuto KUMA GEST dall'italiano all'inglese.

Contenuto IT:
{italian_text}

Regole:
- Mantieni terminologia tecnica condominiale con traduzione tra parentesi alla prima occorrenza
- Es: "amministratore di condominio (condominium manager)"
- Non tradurre nomi propri (KUMA GEST, Klarna, Satispay, SDI)
- Mantieni lo stesso tono professionale
- Adatta riferimenti normativi con nota: "Italian law reference: ..."

Output: Testo inglese completo.
---