Construir Factorías
Crea y configura una factoría al detalle — agentes, skills, hooks, conocimiento, herramientas y versiones.
Construir una factoría es definir un equipo de agentes completo: el agente principal y sus sub-agentes, sus habilidades (skills), hooks, comportamiento, la base de conocimiento y las herramientas externas con las que trabajan. Se hace con un asistente guiado (para crear desde cero) o desde el editor de una factoría ya existente. Cada guardado deja una versión en el historial.
Requiere el permiso Construir factorías. Es una función de perfiles avanzados o administradores de la plataforma. Lo que crees aquí queda disponible en Factorías.
Qué puedes hacer aquí
Crear con el asistente
5 pasos guiados, con sugerencias de Auroria.
Configurar agentes
Agente principal, sub-agentes, skills, hooks y comportamiento.
Base de conocimiento
Sube documentos y sigue su indexación.
Herramientas y fuentes
Conecta herramientas MCP y fuentes Azure AI Search.
El asistente de creación
Pulsa Crear factoría en el catálogo. El asistente (Crear nueva factoría) tiene cinco pasos, con una barra de progreso arriba. Puedes Guardar borrador en cualquier paso; si intentas salir con cambios sin guardar, aparece un diálogo para guardar y salir o descartar.
Información básica de la factoría. Defines la identidad:
| Campo | Detalle |
|---|---|
| Nombre de la factoría | Obligatorio, de 3 a 60 caracteres. Muestra una vista previa y verifica que no exista otro nombre similar. |
| Dominio | Obligatorio. Se elige de un catálogo (Legal, Finanzas, Tecnología…). |
| Tipo de outputs | Obligatorio, uno o más (Documentos técnicos, Análisis regulatorio, ADRs, Código fuente…). |
| Lenguaje principal del código | Aparece solo si eliges Código fuente. |
| Descripción | Opcional. Mejora las sugerencias de Auroria del paso 2. |
| Plantilla de línea de ensamblaje | Opcional. Asocia la factoría a una línea existente. |
Pulsa Siguiente para continuar.
Sugerencias de Auroria (sesión de creación asistida). Al entrar, Auroria analiza el dominio que definiste y propone una configuración inicial (verás «Auroria generó N sub-agentes…»). No es un chat libre: es una propuesta que tú revisas y editas.
- Cada sub-agente sugerido se puede editar o eliminar; puedes Agregar sub-agente manualmente.
- En Configuración de la ejecución ajustas el Patrón de ejecución (marcado «Sugerido por Auroria»), el Input esperado y el Output esperado — textos que describen qué recibe y qué debe producir la factoría, y que influyen en cada respuesta del agente.
Si el análisis falla, puedes Reintentar o Configurar manualmente.
Configurar Sub-agentes (hasta 5). Cada uno es un acordeón que puedes reordenar arrastrándolo. Dentro configuras:
- Datos básicos: nombre, modelo, descripción de rol y el interruptor Agente principal (solo puede haber uno).
- Herramientas MCP (hasta 5): nombre, qué hace, cuándo usarla, qué no hace, ejemplo de input y un JSON Schema de parámetros.
- Skills (hasta 10) y Hooks (hasta 5) del agente.
- Comportamiento: system prompt, rúbricas de evaluación, criterios de escalación (Pausar y notificar, Solicitar input, Abortar) y el patrón del agente.
Arriba de la lista puedes definir Hooks a nivel de factoría (hasta 10). Si falta algo obligatorio, un aviso lista los errores antes de continuar.
Base de conocimiento (paso opcional). Aporta el contexto que usarán los agentes:
- Subir nuevos documentos: arrástralos o pulsa Seleccionar archivos. Formatos admitidos: PDF, DOCX, XLSX, MD, TXT, JSON, PNG, JPG · máx. 50 MB. A cada documento le asignas un tipo (Few-shot examples, Política, Rúbrica, ADR, Referencia…) y verás su estado de indexación en tiempo real.
- Vincular documentos existentes en la plataforma mediante búsqueda y selección.
Confirmar y crear factoría. Un resumen de todo lo anterior (definición básica, sub-agentes, base de conocimiento), con un botón Editar por sección para volver a ajustar. Si hay advertencias no bloqueantes, se listan. Al pulsar Crear factoría verás una animación («Auroria está creando tu factoría…») y, al terminar, se abre la ficha con el aviso de creación y la versión 1.0 activa.
Los modelos disponibles para cada agente son: Opus 4.8, Opus 4.7, Sonnet 5,
Sonnet 4.6 y Haiku 4.5. Los hooks se disparan en cuatro momentos:
pre_tool_use, post_tool_use, session_start y session_stop.
Editar una factoría
Desde la ficha, Editar (o Crear nueva versión) abre el editor. Cada guardado genera una nueva versión en el historial. Tiene dos bloques:
- Metadatos (plegable): nombre, dominio, tipos de output, patrón de ejecución, descripción, equipo dueño y clan/pod.
- Sub-agentes: el mismo editor de agentes del asistente, para ajustar el prompt de sistema, herramientas, skills y hooks de cada uno.
Pulsa Guardar cambios para publicar la nueva versión, o Cancelar para volver.
Ajustar un sub-agente desde la ficha
En el detalle, al hacer clic en un sub-agente se abre un panel lateral para trabajarlo sin pasar por el editor completo:
| Sección | Qué haces |
|---|---|
| Prompt del agente | Editas la Descripción de rol y el System prompt; Guardar prompt crea una nueva versión (verás «Guardado — nueva versión creada.»). |
| Skills | Añades o eliminas skills (nombre, descripción, purpose flow, si es invocable por el usuario). |
| Herramientas | Consultas las herramientas asignadas al agente. |
| Hooks del agente | Añades o eliminas hooks con su momento (timing) y su script de validación. |
Refinar con Auroria
En los formularios de agente, skill y hook verás el botón Refinar con Auroria. Abre un cuadro Describe tu idea: escribes en lenguaje natural lo que quieres y Auroria devuelve una versión refinada que puedes seguir editando antes de guardar.
La base de conocimiento de la factoría
Desde la ficha, Gestionar documentos (o el módulo Base de conocimiento de la factoría) lleva al gestor completo. Arriba, un enlace Añadir documento y accesos a Herramientas MCP → y Fuentes Azure Search →.
Cuatro tarjetas resumen la cobertura: Total documentos, Alta confianza, Con problemas y Espacio usado. La tabla lista cada documento con su tipo, tamaño, estado, cargado y último uso. Puedes buscar, filtrar por tipo y estado, y por fila: Editar documento, Re-indexar, Ver historial (versiones, con opción de Restaurar) y Eliminar.
Estados de indexación
| Estado | Qué significa |
|---|---|
| Pendiente | En cola para analizarse. |
| Analizando documento… | Auroria está procesando el contenido. |
| Re-indexando… | Se está reprocesando con nueva configuración. |
| Alta confianza | Indexado correctamente. |
| Parcial — solo texto visible | Puede haber contenido omitido (tablas, imágenes). |
| Baja confianza | Indexado, pero conviene revisar el contenido. |
| Error al indexar | Falló; usa Re-indexar. |
| Almacenado — sin indexación | Imagen guardada sin indexar texto. |
| No aplica | El documento no requiere indexación. |
Herramientas externas (MCP)
En Herramientas MCP conectas servidores externos (Model Context Protocol) para que los sub-agentes los usen. Pulsa Registrar herramienta y completa la conexión MCP:
| Campo | Detalle |
|---|---|
| Nombre | Obligatorio, solo minúsculas, números y guiones. |
| Descripción | Obligatoria. |
| URL del servidor MCP | Obligatoria (http o https). |
| Autenticación | Ninguna, API Key, Bearer Token u OAuth 2.0. Según el tipo, pide el nombre del header, la credencial o el endpoint de canje. |
| Acceso a la herramienta | Todos los sub-agentes o Sub-agentes específicos (marcas cuáles). |
Tras guardar, usa Descubrir herramientas para que el servidor liste sus herramientas reales y habilitar solo las que quieras. El botón Test verifica la conexión (servidor, protocolo, nº de herramientas y latencia) y muestra Conexión exitosa, Error de conexión o Tiempo de espera agotado. Cada conexión aparece como Activa, Inactiva o Error, y puedes Activar/Desactivar o Eliminar.
Credenciales cifradas
Las credenciales se almacenan cifradas en el servidor y nunca se muestran de vuelta.
Si ya hay una guardada, deja el campo en blanco para conservarla. Como alternativa
avanzada, puedes referenciar una variable de entorno (formato ${NOMBRE_VARIABLE},
nunca el valor real).
Fuentes de Azure AI Search
En Fuentes Azure Search conectas índices de Azure AI Search como insumo de contexto de solo lectura para el agente de la factoría. Pulsa Registrar fuente y completa: Nombre, Descripción, URL del servicio, Nombre del índice, Versión de la API, Modo de búsqueda (Keyword, Semantic, Vector o Híbrido), Campos de contenido, Fragmentos (top_k), un Filtro OData opcional y la Query key (misma credencial cifrada que en MCP).
El botón Probar verifica la conexión y muestra la latencia y los documentos de muestra recuperados. Cada fuente puede estar Activa, Inactiva o Error, y se Activa/Desactiva o Elimina por fila.
A diferencia de las herramientas MCP, las fuentes Azure se asignan a nivel de factoría (no por sub-agente). El modo recomendado es Semantic; si la vectorización del índice falla, la plataforma recurre automáticamente a búsqueda por palabra clave.
Versiones, duplicar y activar
- Versiones: cada guardado o restauración crea una versión; la vigente se marca En uso. El historial completo y la restauración se gestionan desde la ficha (ver Factorías).
- Duplicar factoría: crea una copia editable desde el menú Más acciones.
- Activar/Desactivar: controla si la factoría puede usarse en proyectos.
- Deprecar: la retira; los proyectos activos pierden acceso.
Permisos
| Permiso | Qué habilita en este módulo |
|---|---|
| Construir factorías | Crear con el asistente, editar, refinar con Auroria, gestionar la base de conocimiento, registrar herramientas MCP y fuentes Azure, versionar, duplicar y activar/desactivar. |
| Ver factorías | Consultar el catálogo y la ficha (sin capacidad de construir). |
Sin el permiso Construir factorías no verás el asistente ni los botones de edición: lo que no está permitido no aparece (no se muestra deshabilitado). Consulta Roles y permisos.
Relación con otros módulos
- Factorías — el catálogo y la ficha donde vive todo lo que construyes aquí.
- Sandbox de factoría — prueba la factoría en un entorno de ensayo antes de usarla en proyectos reales.
- Líneas de ensamblaje — encadenan varias factorías; puedes asociar una desde el paso 1 del asistente.
- Knowledge Base — el conocimiento que da contexto a los agentes.
- El chat de fase — donde la factoría trabaja de verdad produciendo los entregables de cada fase.
- Métricas — indicadores de uso y rendimiento por factoría.