El modelo de plantillas
Las plantillas se componen con {% include 'name' %} de Liquid: el layout incluye el cuerpo, el cuerpo incluye cada respuesta, una respuesta incluye las tarjetas de referencia, y así sucesivamente. Sobrescribe cualquier nombre de ese árbol y todo lo que lo incluye usará tu versión.
Las plantillas que más vas a usar
| Nombre de plantilla | Renderiza |
|---|---|
layout | El contenedor exterior (botón flotante, panel principal, búsqueda, vista previa). |
search | El cuadro de entrada, el botón de enviar/detener y el texto de ejemplo. |
body | Un único intercambio: la pregunta del usuario más la respuesta del asistente. |
assistantResponse | Una respuesta del asistente: el markdown de la respuesta, las reacciones y las referencias. |
userQuery | La burbuja con la pregunta del visitante. |
highlighted | Una única tarjeta de referencia (la cita que se muestra con una respuesta). |
hints / hint | Las tarjetas de preguntas sugeridas que se muestran antes de la primera consulta. |
welcome / description / avatarInfo | El saludo, la descripción y la cabecera con avatar y nombre. |
loading / error / noResults | El esqueleto de carga, el error y los estados vacíos. |
dynamicForm + fields/* | Los formularios de captación de leads y cada tipo de campo. |
Parte de la plantilla por defecto, no empieces de cero
En el Advanced editor, abre una plantilla para ver su Liquid actual, cópialo y cambia solo lo que necesites. Así conservas todo el cableado (helpers, clases, atributos de datos) del que depende el resto del asistente.
Ejemplo de composición
Una plantilla de respuesta incluye la tarjeta de referencia de cada fuente que ha usado:
{% for reference in result.payload.references %}
{% include 'highlighted' %}
{% endfor %}Sobrescribe highlighted y cambian las tarjetas de todas las respuestas: en todas partes, a la vez.