Il modello dei template
I template si compongono con {% include 'name' %} di Liquid: il layout include il corpo, il corpo include ogni risposta, una risposta include le schede dei riferimenti e così via. Sostituisci qualsiasi nome in questo albero e tutto ciò che lo include userà la tua versione.
I template che userai di più
| Nome del template | Cosa visualizza |
|---|---|
layout | Il contenitore esterno (pulsante flottante, pannello principale, ricerca, anteprima). |
search | Il campo di input, il pulsante invia/interrompi e il testo segnaposto. |
body | Un singolo scambio: la domanda dell’utente più la risposta dell’assistente. |
assistantResponse | Una risposta dell’assistente: il markdown della risposta, le reazioni e i riferimenti. |
userQuery | Il fumetto con la domanda del visitatore. |
highlighted | Una singola scheda di riferimento (la citazione mostrata con una risposta). |
hints / hint | Le schede con le domande suggerite mostrate prima della prima domanda. |
welcome / description / avatarInfo | Il saluto, la descrizione e l’intestazione con avatar e nome. |
loading / error / noResults | Gli stati di caricamento (skeleton), di errore e vuoto. |
dynamicForm + fields/* | I moduli di acquisizione contatti e ogni tipo di campo. |
Parti dal predefinito, non da zero
Nell’Advanced editor, apri un template per vederne il Liquid attuale, copialo e cambia solo ciò che ti serve. Così mantieni tutti i collegamenti (helper, classi, attributi data) da cui dipende il resto dell’assistente.
Esempio di composizione
Un template di risposta include la scheda di riferimento per ogni fonte usata:
{% for reference in result.payload.references %}
{% include 'highlighted' %}
{% endfor %}Sostituisci highlighted e le schede di ogni risposta cambiano: ovunque, in un colpo solo.