Modelos: guardar, aplicar, duplicar, exportar e importar la configuración de un bot

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.

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.

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
• Dónde se usa cada bot
• Base de conocimiento y ontología
• DeepSeek como proveedor de modelo del bot
• Herramientas de Maestro por módulo