## Visión general

Un **Modelo** — así llama la pantalla a una configuración de bot guardada — es la configuración de
un bot almacenada para reutilizarla: persona, instrucciones, modelo de lenguaje, herramientas
habilitadas, guardrails, política de transferencia, secuencia de atención y todo lo demás que
ajustaste.

La biblioteca está en **Configuración → Bots**, justo debajo de la lista de bots — y aparece incluso
cuando la cuenta todavía no tiene ningún bot, porque importar un Modelo es una de las formas de
conseguir el primero.

| Acción | Dónde está | Qué hace |
|---|---|---|
| **Guardar como Modelo** | en el formulario del bot | Guarda la configuración en la biblioteca de esta cuenta. |
| Aplicar un Modelo | en el formulario del bot, en **Plantillas rápidas** | Trae la configuración guardada al formulario; la revisas y guardas el bot. |
| **Duplicar** | en la lista de Modelos | Crea una **copia del Modelo** en esta cuenta, editable. |
| **Editar** | en la lista de Modelos | Cambia el nombre, el sector y la descripción. **No** toca la configuración guardada. |
| **Eliminar** | en la lista de Modelos | Quita el Modelo. Los bots ya creados a partir de él siguen funcionando. |
| **Exportar** / **Importar** | en la lista de Modelos | Genera y lee un archivo `.maestro-template.json` que otra instalación puede abrir. |

> **Lee esto antes de migrar:** un Modelo **no** es una copia íntegra del bot. Dos clases de cosas se
> quedan atrás por diseño — **secretos** y **referencias locales**. Cada vez que algo se guarda,
> exporta o importa, el panel **Lo que no viajó** dice exactamente qué se eliminó o se vació. Nunca
> supongas «importó al 100%».

## Requisitos previos

- **Maestro habilitado** y al menos un bot configurado (o un archivo de Modelo para importar).
- Permiso de **administrador** para guardar, duplicar, editar, eliminar, exportar e importar.
- Para importar en otra instalación: acceso de administrador **allí también**.

## Paso a paso

### Guardar un bot como Modelo

1. Ve a **Configuración → Bots** y abre el bot que ya está como lo quieres.
2. En el bloque **Plantillas rápidas**, usa **Guardar como Modelo**.
3. Rellena **Nombre** y, opcionalmente, **Sector (opcional)** y **¿Para qué sirve este Modelo?
   (opcional)**. Ponle un nombre que describa el uso, no el cliente.
4. Confirma con **Guardar Modelo**. Aparece arriba en la lista de Modelos.

**Atención — son dos comportamientos, y el diálogo dice cuál se aplica:**

- **El bot ya está guardado:** guarda la configuración que el bot está **ejecutando ahora**, no los
  cambios sin guardar de este formulario. Si acabas de cambiar algo, **guarda el bot antes**.
- **El bot todavía no existe:** como no hay bot, la configuración **en pantalla** se guarda tal cual.

### Aplicar un Modelo a un bot

Este es el camino de Modelo a bot — duplicar no crea ningún bot.

1. Abre un bot existente o empieza a crear uno nuevo.
2. En el bloque **Plantillas rápidas**, abre el selector **Agente por vertical**. Los Modelos de tu
   cuenta (y los de la biblioteca de la instalación) aparecen **delante** de los presets listos del
   producto.
3. Elige el Modelo y usa **Aplicar**. El aviso indica cuántos ajustes trajo: aplicar combina **solo
   los campos que el Modelo lleva** — el resto del formulario se queda como estaba.
4. Revisa la configuración, **guarda el bot** y vincúlalo a las bandejas de entrada donde debe
   atender.

### Buscar, duplicar, editar y eliminar

1. Usa el campo **Buscar Modelos** para filtrar por nombre, descripción o sector. **Limpiar
   búsqueda** vuelve a la lista completa.
2. **Duplicar** crea una **copia del Modelo** en esta cuenta, ya editable (el aviso lo confirma:
   «Duplicado como …»). Así se personaliza un Modelo **Compartido**, que es de solo lectura.
3. **Editar** cambia **Nombre**, **Sector** y **Descripción** — la configuración guardada no se
   toca. Para cambiar la configuración en sí, aplica el Modelo a un bot, ajústalo y usa **Guardar
   como Modelo** de nuevo.
4. **Eliminar** quita el Modelo de la biblioteca. Los bots creados a partir de él siguen
   funcionando: un Modelo es un punto de partida, no un vínculo.

### Exportar e importar entre instalaciones

1. En el Modelo, elige **Exportar**. El navegador descarga un archivo `.maestro-template.json`.
2. En la instalación de destino, usa **Importar** y elige el archivo.
3. **Lee el panel «Lo que no viajó»** — enumera, ítem por ítem, qué se eliminó o se vació.
4. Reconfigura lo que marcó el panel (claves, equipos, base de conocimiento, medios).
5. Aplica el Modelo a un bot, revísalo y **guarda**.

## Configuración y opciones

### Dos ámbitos: Modelos de la cuenta y biblioteca de la instalación

La lista muestra los dos juntos, y se comportan de forma distinta a propósito:

- **Modelos de la cuenta** — los que guardaste, duplicaste o importaste. Son **editables** y se
  pueden **eliminar**.
- **Biblioteca de la instalación** — llevan el sello **Compartido** y son de **solo lectura**: no
  ofrecen **Editar** ni **Eliminar**. Para personalizar uno, usa **Duplicar**: la copia nace en esta
  cuenta, editable, sin alterar el original.

Publicar un Modelo para **toda la instalación** es una acción del **operador de la plataforma** y no
tiene camino en el panel de la cuenta: el efecto atraviesa todas las cuentas de la caja, y
restringir es reversible mientras que despublicar del mundo no lo es.

### El panel «Lo que no viajó»

Aparece después de guardar, editar, exportar o importar un Modelo, y enumera **solo** lo que no se
pudo llevar — las referencias reencontradas por el nombre no entran, para que el panel siga
valiendo la pena leerlo. **Descartar** lo cierra.

### Lo que NUNCA viaja: los secretos

Ni los **valores** ni los **nombres**. El nombre de un secreto ya es un mapa de dónde están las
credenciales.

Se eliminan al guardar en la biblioteca **y** al exportar:

- Las **claves de proveedor** del bot y el espejo de las claves nativas de la cuenta.
- Los **secretos** registrados y la **lista de sus nombres**.
- Credenciales escritas **literalmente** dentro de herramientas HTTP y servidores MCP — cabeceras
  como `Authorization`, `Cookie`, y cualquier campo cuyo nombre parezca `api_key`, `token`,
  `password`, `secret`.
- Credencial incrustada en la **URL** (`https://usuario:contrasena@host/...`). Solo sale el
  `usuario:contrasena`; host, ruta y query se conservan para que la herramienta siga reconfigurable.

La política es una **lista de denegación**: todo viaja **excepto** lo que esté nombrado como secreto
o referencia local. Un campo nuevo cuyo **nombre** parezca credencial se elimina automáticamente. Así
el error posible es «viajó de menos», nunca «se filtró un secreto».

**Una excepción importante y útil:** una referencia con el formato `{{secret.NOMBRE}}` **sobrevive**
— apunta a un secreto, no es uno. Del otro lado basta registrar un secreto con ese nombre y la
herramienta vuelve a funcionar sin reescribir nada. **Usa siempre esa forma** en las herramientas
HTTP.

### Lo que NO viaja: las referencias locales

Un `equipo 7` en la instalación de destino apunta a un equipo que no existe — o, peor, a un equipo
**distinto**. Por eso cada referencia se exporta con el **nombre** que tenía, se **reencuentra por el
nombre** al importar, y se **vacía** cuando nada coincide. Nada se inventa: un bot apuntando al
equipo 1 solo porque el 1 existe es peor que un bot sin equipo.

| Ítem | Al importar |
|---|---|
| **Equipo de transferencia** | Remapeado por nombre; **vaciado** si no existe un equipo con ese nombre. |
| **Subagentes (delegación)** | Remapeados por nombre. |
| **Base de conocimiento** | Llega **apagada** — el contenido ya ingerido no viaja. Reingiere y vuelve a activarla. |
| **Medios de la biblioteca** | **Descartados** — las URLs apuntan al almacenamiento de origen. Vuelve a subirlos en el destino. |
| **Base de datos / voz clonada** | El recurso no viaja; la capacidad llega **apagada** y nombrada en el panel. |
| **Atributos de contacto** | Verificados contra los que la cuenta de destino realmente define. |

Una capacidad cuyo recurso no pudo viajar llega **desactivada** a propósito: dejarla encendida
entregaría un bot que responde «consulté nuestra base de conocimiento» contra una base vacía.

### El archivo

- Extensión `.maestro-template.json`, con un marcador de formato y una versión.
- Un archivo **sin** el marcador no se trata como Modelo: se **rechaza**, no se adivina.
- Una versión que esta instalación no conoce también se rechaza — **nunca** se lee a medias. Un
  Modelo leído a medias es un bot que parece configurado y no lo está.

## Casos de uso

- **Estandarizar la atención** — un Modelo «Soporte nivel 1» aplicado a varios bots.
- **Probar una variante** — duplica el Modelo, aplica la copia a un bot de prueba y compara.
- **Entorno de pruebas → producción** — configura con calma en pruebas, exporta e importa.
- **Agencia / multicliente** — un Modelo por vertical, exportado e importado en cada cuenta.
- **Respaldo de configuración** — exporta antes de un cambio grande.
- **Migración de instalación** — lleva tus bots sin reconfigurar todo a mano.

## Consejos, límites y buenas prácticas

- **Lee siempre el panel «Lo que no viajó».** Es tu lista de tareas del otro lado.
- Después de importar, haz una **prueba real** en una conversación antes de poner el bot en tráfico
  vivo.
- Prefiere `{{secret.NOMBRE}}` a pegar la credencial: es la única forma que sobrevive al viaje.
- Nombra los Modelos por **uso** («Clínica — agendamiento»), no por cliente.
- **Editar no cambia el comportamiento**: solo toca la etiqueta (nombre, sector, descripción).
- **Duplica antes de experimentar** — así el Modelo que ya funciona queda intacto.
- El Modelo es una **fotografía**: cambiar el bot después **no** actualiza el Modelo, ni al revés.

## Solución de problemas

- **«Dupliqué y no apareció ningún bot»** — duplicar copia el **Modelo**, no crea un bot. Para tener
  un bot, abre el formulario del bot, aplica el Modelo en **Agente por vertical**, guarda y
  vincúlalo a las bandejas de entrada.
- **«Este Modelo no tiene Editar ni Eliminar»** — viene de la instalación (sello **Compartido**) y es
  de solo lectura. Usa **Duplicar** para tener una copia editable en esta cuenta.
- **«Ya existe un Modelo con esta clave»** — estás importando un archivo que ya está en la
  biblioteca. Duplica el que ya tienes, o renómbralo antes de importar de nuevo.
- **«El archivo fue rechazado al importar»** — no es un `.maestro-template.json` válido, o lo generó
  una versión que esta instalación no puede leer.
- **«El bot transfiere al equipo equivocado»** — no existía un equipo con el mismo nombre; el panel
  lo marcó como vaciado. Crea el equipo y selecciónalo.
- **«Dice que consultó la base y no encontró nada»** — la base llega apagada y **vacía**. Reingiere
  el contenido y actívala.
- **«Las herramientas HTTP dan error de autenticación»** — las credenciales no viajan. Registra los
  secretos en el destino.
- **«Faltan los medios»** — los archivos no viajan; vuelve a subirlos en la biblioteca de medios del
  destino.
- **«Apliqué el Modelo y no cambió todo»** — aplicar combina solo los campos que el Modelo lleva, y
  el aviso muestra cuántos ajustes entraron. El resto se queda como ya estaba el formulario.

## Ver también

- [Qué son Maestro IA y el Cerebro de la Cuenta](/hc/ajuda/articles/maestro-brain-overview-es)
- [Dónde se usa cada bot](/hc/ajuda/articles/maestro-brain-onde-cada-robo-e-usado-es)
- [Base de conocimiento y ontología](/hc/ajuda/articles/maestro-brain-base-de-conhecimento-e-ontologia-es)
- [DeepSeek como proveedor de modelo del bot](/hc/ajuda/articles/maestro-brain-provedor-deepseek-es)
- [Herramientas de Maestro por módulo](/hc/ajuda/articles/maestro-brain-ferramentas-maestro-por-modulo-es)