🔑 1. Activation – Inserimento licenze
In questa sezione si inseriscono:
• Licenza Pricelist AI
• Data di scadenza AI
• Licenza componente WhatsApp (se acquistato)
• Data di scadenza componente WhatsApp

👉 Serve solo per abilitare funzionalità AI aggiuntive.

Se la licenza WhatsApp non è attiva, le funzioni WhatsApp non compaiono.

⚙️ 2. Setup – Impostazioni generali

🔧 Modalità (Mode)
• Hai due modalità: Master e Slave.
• In pratica vengono usate nei sistemi multi-sito o multi-istanza.
Se non sai quale usare → si lascia in Master (default).

🔐 OpenAI API Key
Qui va inserita la chiave API fornita al cliente.

Serve a generare:
• contenuti AI,
• riempimento automatico dei prompt,
• elaborazione topic/keywords,
• funzioni Caspar automatiche.

🌐 Allowed Hosts (separati da 😉
Serve a indicare quali domini sono autorizzati a chiamare l’AI.

Esempio tipico:
https://miosito.it;https://admin.miosito.it

🔎 Usato anche per evitare chiamate AI da siti duplicati o ambienti di test.

⚡ Enhanced Mode
Opzione interna che abilita funzioni avanzate.
Se attivata:
• abilita debug avanzato,
• abilita log dettagliati,
• abilita alcune ottimizzazioni interne.

👈 Normalmente disattivato, si usa solo per test.

🤖 3. Melchior – Gestione AI del listino
È la parte più importante. È suddivisa in 4 tab.

📌 3.1 Prompt Generator
Da qui si selezionano i listini su cui l’AI deve generare o aggiornare contenuti.
• L’AI lavorerà solo sui listini selezionati.
• Questo serve per clienti che hanno listini multipli (es. 2024, 2025) e vogliono che l’AI risponda solo con uno specifico listino.
👉 Seleziono “Listino 2025” → L’AI risponde esclusivamente con i prezzi del listino 2025.

🔔 Qui vengono mostrati anche:
• errori,
• topic mancanti,
• blocchi non configurati.

📊 3.2 Topic Stats
Mostra statistiche generate dall’AI:
• numero totale prompt per topic,
• prompt riservati,
• prompt non riservati,
• eventuali mancanze.

📌 I topic provengono dai blocchi Gutenberg del sito.

🏷️ 3.3 Keywords
Ogni topic ha una lista di parole chiave usate per riconoscere sezioni del listino.
• Qui l’AI memorizza le associazioni create automaticamente.
• Puoi modificarle manualmente (tasto Edit Keywords).

🔎 È usato per aiutare l’AI a capire:
• categorie,
• collezioni,
• modelli,
• segmenti del listino.

🔄 3.4 RAG – Melchior RAG Sync
Qui puoi avviare la sincronizzazione RAG.

📌 A cosa serve?
Crea una memoria vettoriale dei listini → l’AI può rispondere in modo coerente e recuperare informazioni direttamente dal database pricelist.
Ha due pulsanti:
• ▶️ Run RAG
• ⛔ Force Stop (per forzare il blocco)

📦 4. Caspar – Cursori standard
Pagina dove l’utente definisce i tag dei dati tecnici.
Esempio:
• Larghezza →
• Peso lordo →
• Numero colli →

👉 Questi tag vengono usati nei prompt AI.
👉 L’AI li popola automaticamente quando genera contenuti tecnici.
⚠️ Qui è fondamentale usare solo tag di articoli, non di intestazione.

🚀 5. Production – Modalità di produzione
Una volta che tutto è pronto:
• si passa alla modalità Production
• blocca le modifiche critiche
• garantisce stabilità per uso reale
Usato quando il listino è definitivo.

Il blocco Pricelist AI permette di creare prompt personalizzati direttamente all’interno delle pagine WordPress, così che l’intelligenza artificiale possa apprendere istruzioni aggiuntive e restituire risposte coerenti in base ai contenuti del sito e ai listini configurati.

Viene utilizzato per:
• dare informazioni aggiuntive all’AI;
• insegnare dettagli non presenti nei dati strutturati (codici, tabelle, prezzi, immagini, ecc.);
• collegare il prompt a un topic in modo da renderlo parte del sistema di apprendimento;
• definire priorità e comportamento del prompt durante la generazione delle risposte

🧩 Campi del blocco

1. Content 📝
In questo campo puoi inserire testo libero che verrà utilizzato dall’AI come base istruttiva.
Può includere:
• spiegazioni aggiuntive;
• precisazioni;
• note tecniche;
• descrizioni testuali di elementi non presenti nei dati del listino (come un’immagine, una particolarità del prodotto, eccezioni, vincoli, ecc.).

⚠️ Importante:
In questo blocco non è possibile usare tag come , , ecc.
È uno spazio puramente descrittivo.

2. Load Saved Prompt / Save Prompt 💾
Queste due funzioni lavorano insieme al campo “Content”.
• Save Prompt: salva il contenuto scritto in “Content” in modo da poterlo recuperare in futuro.
• Load Saved Prompt: carica rapidamente un prompt salvato in precedenza.
Sono comode quando:
• si riutilizzano spesso le stesse istruzioni;
• si creano varianti dello stesso prompt;
• si lavora su molte pagine simili.

3. Topic 🔖
Ogni blocco AI deve essere associato a un topic.
Il topic determina a quale area semantica appartiene il prompt (es. basi, pensili, modello, collezione ecc.).

Questo permette al sistema AI di:
• organizzare il materiale appreso;
• sapere quando utilizzare quel prompt in base alla domanda dell’utente finale;
• migliorare la precisione delle risposte.

👉 Un blocco può avere un solo topic selezionato.

4. Priority ⭐
La priorità serve a definire l’ordine con cui l’AI considera i vari prompt legati allo stesso topic.
Esempio:
• Priority 0 = prompt principale
• Priority 1, 2, 3… = prompt di supporto o integrativi

Maggiore è la priorità, maggiore è l’importanza del prompt durante la generazione della risposta.

5. Reserved 🔒
Indica come il prompt deve essere trattato dal sistema AI:

• No → il prompt è “generale” e può essere utilizzato liberamente.
• Yes → il prompt è riservato, quindi viene usato solo in contesti specifici (ad esempio test interni, logiche particolari del listino, prezzi o informazioni sensibili).

Questo sistema aiuta a mantenere separati:
• i prompt destinati alle risposte per l’utente finale;
• i prompt destinati ai test, alle descrizioni tecniche private, o ai dati non pubblici.