Plantillas

Las plantillas son archivos markdown que definen la personalidad de tu agente, tu perfil, instrucciones de herramientas y rutinas automatizadas. Editalas desde el dashboard para personalizar como se comportan tus agentes.

Que Son las Plantillas?

Cada agente lee cuatro archivos de plantilla al inicio de cada sesion. Piensa en ellos como manuales de instrucciones que tu agente siempre tiene abiertos:

  • SOUL.md — La personalidad de tu agente. Define quien es el agente: su voz, estilo de comunicacion, marco de decisiones y reglas estrictas. No "se util" — un personaje real con opiniones y limites.
  • USER.md — Un perfil sobre ti. Tu nombre, zona horaria, plataformas, horario, preferencias y contexto de negocio. Esto significa que tu agente sabe quien eres sin que tengas que explicarlo cada vez.
  • TOOLS.md — La hoja de referencia de tu agente. Claves API, objetivos de despliegue, detalles SSH, perfiles de navegador — todo lo que tu agente necesita para hacer cosas. Actualiza esto a medida que tu stack evoluciona.
  • HEARTBEAT.md — Rutinas automatizadas que tu agente verifica periodicamente. Calendario, email, tableros de tareas, monitoreo — un barrido unificado en lugar de cron jobs separados.

Como Editar Plantillas

  1. Ve a Plantillas en la barra lateral (o navega a Dashboard → Plantillas)
  2. Veras cuatro pestañas — una para cada archivo de plantilla. Haz clic en una pestaña para cambiar entre ellas.
  3. Edita el contenido en el editor de texto. Es un editor de texto plano optimizado para markdown — usa encabezados, viñetas, bloques de codigo, etc.
  4. Un contador de caracteres aparece en la parte inferior del editor para que puedas rastrear el tamaño del archivo.
  5. Cuando hayas hecho cambios, aparecen dos botones: "Guardar" y "Descartar Cambios".
  6. Haz clic en "Guardar" para aplicar. Esto reinicia el contenedor (~30 segundos) para que tus agentes tomen las nuevas plantillas.
Importante: Guardar plantillas reinicia tu contenedor. Tus agentes estaran brevemente no disponibles (~30 segundos) mientras el contenedor se reinicia con la nueva configuracion. Los datos de conversacion se preservan en almacenamiento persistente.

Plantillas de Usuario vs. Anulaciones por Agente

Las plantillas funcionan con un sistema de dos niveles:

  • Valores por defecto a nivel de usuario (editados desde la pagina de Plantillas) — Se aplican a todos tus agentes. Si tienes 3 agentes, todos leen el mismo SOUL.md, USER.md, etc.
  • Anulaciones por agente (editadas desde la pagina de detalle de un agente individual) — Anulan el valor por defecto para un agente especifico. Por ejemplo, tu agente investigador podria necesitar un SOUL.md diferente al de tu agente manager.

La anulacion es por archivo, no por linea. Si personalizas SOUL.md para un agente, ese agente usa la version personalizada completa — no se fusiona con la por defecto.

Como Configurar Anulaciones por Agente

  1. Ve a la pagina de detalle de un agente (haz clic en la tarjeta del agente en el dashboard)
  2. Desplazate hasta la seccion "Plantillas"
  3. Cada plantilla muestra una insignia: "Usando por defecto" o "Anulacion personalizada"
  4. Haz clic en "Personalizar" para crear una anulacion (comienza con una copia del valor por defecto)
  5. Edita el contenido y haz clic en "Guardar"
  6. Para volver al valor por defecto, haz clic en "Restablecer a Por Defecto"

Cuestionario de Incorporacion

Cuando te suscribes por primera vez, Autonomis te guia a traves de un cuestionario de incorporacion de 4 pasos que automaticamente llena tu USER.md y añade directivas de estilo a tu SOUL.md:

  • Paso 1: Sobre Ti — Nombre, profesion, zona horaria, ubicacion, rutina, hobbies
  • Paso 2: Estilo de Trabajo — En que necesitas ayuda, estilo de respuesta (conciso/detallado), tono (casual/formal/humoristico), preferencias de idioma
  • Paso 3: Limites — Contexto personal, temas a evitar, que necesita tu aprobacion, horas de silencio
  • Paso 4: Revision — Plataformas que usas, notas adicionales y una vista previa en vivo del USER.md generado

Puedes omitir el cuestionario y llenar las plantillas manualmente despues. Todo lo que genera el cuestionario puede editarse posteriormente desde la pagina de Plantillas.

Mejores Practicas

  • Se especifico en SOUL.md — "Se util" es inutil. En su lugar: "Hablas como un CTO directo y sin rodeos. Nunca uses frases de relleno. Si algo esta mal, dilo inmediatamente."
  • Manten USER.md actualizado — Actualizalo cuando cambien tu horario, proyectos o herramientas. Tu agente solo sabe lo que esta en el archivo.
  • Pon reglas importantes en archivos, no en el chat — Los archivos de plantilla sobreviven la compactacion de contexto (cuando la conversacion se hace larga). Los mensajes del chat pueden ser comprimidos y olvidados.
  • Usa anulaciones para agentes especializados — Tu agente investigador no necesita la misma personalidad que tu redactor de contenido. Dale a cada uno un SOUL.md adaptado.
  • Usa HEARTBEAT.md con moderacion — Cada sondeo de heartbeat cuesta tokens. Usa el modelo Haiku mas barato para agentes de heartbeat para mantener los costos bajos.

Siguientes Pasos