> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spott.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Template Builder

> Convierte tu propio documento de Word con tu marca en una plantilla de CV o de shortlist, con un agente de IA que la construye y una vista previa con un candidato real antes de que tu equipo la use.

**Template Builder** convierte un documento de Word con tu estilo en una plantilla
reutilizable para [CV con formato y shortlists](/es/docs/candidates/client-documents). Subes un
archivo `.docx`, un agente de IA averigua qué partes deben rellenarse con información del
candidato y construye la plantilla, y tú compruebas el resultado con un candidato real antes
de publicarla para tu equipo.

<Note>
  **Template Builder no está activado por defecto.** Si no lo ves en **Settings →
  Templates**, pide a Customer Support en [support@spott.io](mailto:support@spott.io)
  que lo active para tu workspace.
</Note>

Una vez activado, pueden usarlo los administradores y cualquier persona cuyo rol tenga
el permiso **Manage Templates**. Consulta [gestionar el
acceso](/es/docs/settings/managing-access).

## Prepara tu archivo de Word

El agente trabaja a partir de un archivo de Word normal. Puede ser cualquiera de estos dos:

* **Un CV de ejemplo con tu estilo**, por ejemplo un CV real que ya tenía el formato con el
  que los envías a los clientes. El agente deduce la estructura por sí solo.
* **Una plantilla que has preparado tú**, con marcadores e instrucciones escritas en el
  documento.

Qué mejora el resultado:

* **Usa Word `.docx`.** Ni `.doc`, ni Pages, ni un PDF de la plantilla.
* **Incluye todas las secciones, en el orden que quieras.** El agente rellena texto y no
  cambia tu formato, así que la maquetación que subes es la maquetación que obtienes. Añadir,
  quitar o reordenar secciones es más fácil en Word antes de subir el archivo.
* **Escribe tus reglas en el documento.** Por ejemplo *"muestra esta sección solo cuando el
  candidato tenga certificados"*, *"cuando esté anonimizado, muestra la región en lugar de la
  ciudad"*, cómo deben escribirse las fechas (`Jan 2024 - Mar 2025`) o si una sección va en
  viñetas o en texto seguido. Es opcional: cuando algo no está claro, el agente pregunta, y
  puedes afinarlo todo después.
* **Mantén una maquetación sencilla.** Las maquetaciones a una columna funcionan mejor. Evita
  los cuadros de texto, los marcos flotantes y SmartArt; las tablas y las imágenes en línea no
  dan problemas.

No hace falta que describas la maquetación en sí. El agente la lee del documento.

## Abre Template Builder

Ve a **Settings → Templates** y haz clic en **Template Builder**. La página tiene dos listas:

* **Templates in progress**: las plantillas que todavía estás construyendo con el agente.
  Abre una para seguir donde lo dejaste. Esta lista es personal, así que no ves en qué están
  trabajando tus compañeros.
* **Published templates**: todas las plantillas activas del workspace, tanto de CV como de
  shortlist, las haya publicado quien las haya publicado.

## Crea una plantilla

Haz clic en **+ New template** y elige:

1. **Template type**

   * **CV**: una plantilla para el CV de un candidato cada vez.
   * **Candidate shortlist**: una plantilla para un documento de shortlist que reúne a varios
     candidatos seleccionados.

   Los dos tipos siguen exactamente los mismos pasos.
2. **Starting point**
   * **New template**: sube uno o varios archivos `.docx` y construye una plantilla desde cero.
   * **Existing template**: parte de una plantilla que ya tienes. Consulta
     [cambiar una plantilla publicada](#cambiar-una-plantilla-publicada).
3. Haz clic en **Start**.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-new.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=f6b7481e65816a5eb5cbba8cee97c126" alt="La página New template con el tipo de plantilla y el punto de partida" width="1402" height="1037" data-path="images/settings/template-builder-new.webp" />
</Frame>

### Cambiar una plantilla publicada

Una plantilla publicada no se puede editar directamente. Para cambiarla, crea una plantilla
nueva con **Existing template** como punto de partida, elige la plantilla de la que partir y
describe en **Instructions** qué debe cambiar. El agente trabaja a partir de esa plantilla, y
tú publicas el resultado como una versión nueva. Mientras tanto, la plantilla actual sigue
funcionando, y puedes volver a la versión anterior.

## Responde a las preguntas del agente

Al hacer clic en **Start** se abre el **Template Studio**, donde el agente lee tu documento y
se pone a trabajar. Primero te hace unas cuantas preguntas para entender qué quieres. Siempre
pregunta qué aspecto deben tener los CV anonimizados, salvo que tu documento ya lo explique.
Elige una de las respuestas sugeridas o escribe la tuya.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-question.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=9211a94f701503268f172593a101d926" alt="El agente preguntando qué aspecto debe tener el documento anonimizado, con respuestas sugeridas" width="576" height="768" data-path="images/settings/template-builder-question.webp" />
</Frame>

Según el documento, puede haber más preguntas. Respóndelas y envíalas. No tienen que ser
perfectas: puedes concretar más cuando veas una vista previa.

## Deja que el agente construya la plantilla

Construir una primera versión suele llevar **de 2 a 5 minutos**, según lo compleja que sea tu
plantilla. Mientras trabaja, el panel del agente a la derecha muestra lo que está haciendo.

No tienes que esperar en la página. Vuelve a tu trabajo y regresa más tarde: la plantilla
aparece como **Running** en **Templates in progress** y no se pierde nada.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-running.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=27802d771a19a3eff00a88ea0f13e00a" alt="Una plantilla que todavía se está construyendo, con el estado Running en Templates in progress" width="1402" height="339" data-path="images/settings/template-builder-running.webp" />
</Frame>

## Revisa la plantilla

Cuando el agente termina, el Template Studio tiene tres paneles:

* **A la izquierda, Settings y Components**: los ajustes de toda la plantilla y cada uno de
  sus componentes, cada uno con su propia configuración.
* **En el centro, Template y Preview**: tu documento con todos los marcadores resaltados. Las
  pestañas alternan entre la plantilla y una vista previa.
* **A la derecha, Agent**: un resumen de lo que ha construido el agente y un cuadro de chat
  para pedir cambios.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-studio.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=ec1320458c41559de8fc7b06206ee57b" alt="El Template Studio con los componentes a la izquierda, la plantilla en el centro y el agente a la derecha" width="2298" height="1373" data-path="images/settings/template-builder-studio.webp" />
</Frame>

### Ajustes de la plantilla

Arriba a la izquierda hay dos ajustes que se aplican a toda la plantilla:

* **Anonymization**: las instrucciones que se usan cada vez que se genera un documento con
  **Anonymize output** marcado. El agente las redacta a partir de tu respuesta a su pregunta.
  Léelas y cámbialas si hace falta, editando el texto o pidiéndoselo al agente.
* **Verbatim**: cuando está activado, todas las secciones copian el texto exactamente como
  aparece en el CV original del candidato, para que no tengas que repetir "usa la redacción
  exacta" en cada instrucción.

### Componentes

**Haz clic en cualquier parte del documento** en el panel central y se abre a la izquierda el
componente correspondiente, que muestra cómo se rellena esa parte. Un componente es o bien un
campo suelto, como el nombre del candidato, o bien una sección que agrupa varios.

Cada componente tiene:

* **Instructions**: cómo debe rellenarse el contenido.
* **Verbatim**: copia el texto exactamente como está escrito en el CV original, solo para este
  componente. Por ejemplo, mantén la formación, la experiencia y los certificados al pie de la
  letra, pero deja que se reescriba el resumen del perfil: desactiva Verbatim solo en ese y
  describe en sus instrucciones cómo debe leerse.
* **Anonymization**: reglas de anonimización adicionales para este componente, además de las
  de la propia plantilla.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-component.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=7245b057c4709d87e1677e9b0292b6a1" alt="Un componente de perfil con su interruptor Verbatim, sus instrucciones y sus reglas de anonimización" width="506" height="992" data-path="images/settings/template-builder-component.webp" />
</Frame>

Una **sección** tiene además un interruptor **Conditional**, para que toda la sección aparezca
solo cuando se cumple una condición. Escribe la condición como una frase, por ejemplo
*"La fuente contiene certificados o certificaciones."* Así, un CV sin certificados
simplemente no tiene sección de certificados, en lugar de un encabezado vacío.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-conditional.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=6948913d30e994ec3609bfeea6d0eb94" alt="La sección Certificates configurada como condicional, con su condición escrita" width="506" height="678" data-path="images/settings/template-builder-conditional.webp" />
</Frame>

Los iconos de la lista de componentes muestran de un vistazo los ajustes clave: un icono de
**filtro** marca una sección condicional, y un icono de **comillas** marca contenido literal.
Los bloques que se repiten una vez por elemento, como uno por puesto o por titulación, llevan
un icono de **dos flechas**.

### Secciones dinámicas

El CV de un candidato suele contener información para la que tu plantilla no tiene sección.
Una **sección dinámica**, como *Additional Information* al final, la recoge: Spott busca en
el CV todo lo relevante que no esté cubierto en otra parte y añade cada elemento como su
propia sección con su propio encabezado, por ejemplo *Skills* o *Languages*.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-dynamic-section.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=69f1e228e94ba4fb1aeb0580990b3f49" alt="Una vista previa en la que la sección dinámica generó las secciones separadas Profile, Skills y Additional Information" width="1126" height="563" data-path="images/settings/template-builder-dynamic-section.webp" />
</Frame>

### Trabaja con el agente

Cambia lo que quieras a mano, o pídeselo al agente en el cuadro de chat abajo a la derecha.
Por ejemplo, después de desactivar Verbatim en el perfil, pídele que *"actualice la
instrucción del perfil para que se redacte en tercera persona"*. Actualiza la instrucción y
explica qué ha cambiado. Tú y el agente podéis trabajar en la misma plantilla: cuando editas
algo tú, al agente se le indica exactamente qué ha cambiado y no lo sobrescribe.

Los cambios más grandes funcionan igual, como quitar una sección. Cuando el agente termina,
vuelve a generar la plantilla para comprobar el resultado.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-chat.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=14ac59eb387b357166e92220f514db5a" alt="El agente quitando la sección Profile a petición y comprobando el resultado generado" width="576" height="589" data-path="images/settings/template-builder-chat.webp" />
</Frame>

## Previsualiza con un candidato real

Abre la pestaña **Preview**, elige un candidato y haz clic en **Preview template**. Sirve
cualquier candidato de tu base de datos, así que elige uno cuyo perfil sepas que está
completo. Para una plantilla **Candidate shortlist**, elige varios candidatos.

La vista previa es la mejor comprobación que tienes. Si algo no está bien, dile al agente qué
cambiar directamente desde la vista previa y vuelve a previsualizar. Ese ciclo,
**previsualizar, dar feedback, comprobar, volver a previsualizar**, es lo que hace buena una
plantilla.

Cuando la plantilla cambia después de una vista previa, la vista previa se marca como
**stale**. Vuelve a ejecutarla antes de publicar: **Publish** no está disponible hasta que la
vista previa corresponda a la plantilla.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-stale-preview.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=fdba070d778a3d0260f38348924cfd6b" alt="Una vista previa desactualizada con el aviso que pide volver a ejecutarla" width="1702" height="864" data-path="images/settings/template-builder-stale-preview.webp" />
</Frame>

### Qué rellena la vista previa

La información del candidato se rellena a partir del perfil, junto con campos como la fecha.
Todo aquello para lo que Spott no tiene datos aparece entre paréntesis, por ejemplo
`(INSTITUTION)` en una titulación sin centro en la ficha, o `(CONSULTANT NAME)` en un pie de
página. Es deliberado: el documento te muestra lo que falta en lugar de inventarlo.

## Publica

Cuando la vista previa esté bien, haz clic en **Publish** arriba a la derecha. Ponle un nombre
a la plantilla, activa si quieres **Set as default template** para que sea la plantilla por
defecto de tu workspace, y haz clic en **Save**.

<Frame>
  <img src="https://mintcdn.com/spott-docs/VpxcUxryU8u7UMcM/images/settings/template-builder-publish.webp?fit=max&auto=format&n=VpxcUxryU8u7UMcM&q=85&s=42015240775a4df5289ff3ea7b75f3a1" alt="El cuadro Template Name con el interruptor Set as default template" width="640" height="316" data-path="images/settings/template-builder-publish.webp" />
</Frame>

La plantilla aparece en **Published templates** y tu equipo puede usarla de inmediato. Para
hacerla la predeterminada más adelante, haz clic en la **estrella** que hay junto a ella. Para
generar un documento con ella, consulta
[CV y documentos para el cliente](/es/docs/candidates/client-documents).

## Referencia rápida

| Ajuste o icono | Qué hace |
| - | - |
| **Verbatim**, a nivel de plantilla | Todas las secciones copian el texto exactamente como está escrito en el CV original. |
| **Verbatim**, a nivel de componente, icono de comillas | Este componente copia el texto exactamente como está escrito en el CV original. |
| **Anonymization** | Qué quitar o generalizar cuando un documento se genera anonimizado. |
| **Conditional**, icono de filtro | La sección solo aparece cuando se cumple su condición. |
| **Sección dinámica** | Recoge la información relevante que no está cubierta en otra parte, como secciones separadas con sus propios encabezados. |
| **Vista previa desactualizada** (stale) | La plantilla ha cambiado desde la última vista previa. Vuelve a ejecutarla antes de publicar. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.