Ayuda para creadores

Un creador produce los objetos de aprendizaje (OA) que luego alimentan el banco. Este documento explica cómo se crea un objeto y qué conveniencias ofrece la plataforma.

Quién puede crear

Hoy la creación de contenido está reservada a cuentas de administración (admin y moderator), por seguridad. Si colaboras como autor externo, una cuenta de personal publica el objeto en tu nombre o te emite una clave de agente desde su cuenta.

Las vías de creación

La API para agentes (la vía que siempre está disponible)

Es el canal principal: creación en lote, trazable y con validación dura antes de publicar.

• El esquema machine-readable está en /api/v1/objects/schema.
• Creas con POST /api/v1/objects, enviando la clave de agente en la cabecera Authorization: Bearer ….
• Puedes validar sin publicar con /api/v1/objects/validate, y auditar el catálogo con /api/v1/objects/audit.
• Cada familia de experiencias tiene su validador sin efectos: /api/v1/labs/validate, /api/v1/games/validate, /api/v1/tours/validate, /api/v1/shows/validate, /api/v1/apps/validate. Todos responden 422 con la lista de errores para corregir y reintentar.
• Las claves se emiten y revocan en /object-studio (agentes y tokens MCP), que es la puerta de personal aunque el Estudio web esté apagado.

La documentación completa, con ejemplos de prompt y la lista de bloques disponibles, vive en /agentes.

El Estudio (web, sólo en portales que lo tengan activado)

El Estudio es una ayuda puntual para crear una pieza a mano: describes qué quieres (tema, materia, edades, objetivo), el Estudio te devuelve el prompt exacto, lo usas con una IA externa y subes el resultado —un ZIP con object.json y sus assets/, o simplemente el object.json— para que Lumbre lo valide, firme y publique.

Muchos portales lo tienen cerrado por decisión de su administración: en esos sitios /object-studio no ofrece el flujo de subida y se limita a emitir claves de agente. No es un fallo: el contenido entra entonces por la API. La clasificación (materia, edades, idioma) viaja siempre dentro del propio object.json.

Ojo con NO TOCAR: si un administrador protegió un contenido (estado de calidad no_tocar), toda herramienta de escritura —por API o MCP— responde OBJECT_PROTECTED y no crea ninguna versión. La protección solo la quita un humano desde la barra de control de calidad.

Anatomía de un buen objeto

Un objeto se describe con meta (título, autor, objetivo, materia, edades, idioma, etiquetas) y una lista de blocks. Algunas recomendaciones:

• Un objetivo claro: qué debe poder hacer el alumno al terminar.
• Explicación breve en bloques de texto, sin muros de palabras.
• Video cuando sume: se enlaza como embed (por ejemplo, YouTube), sin subir el archivo.
• Repaso activo: juegos como memoria, clasificación, tarjetas o sopas de letras.
• Recursos visuales: mapas mentales, explicaciones paso a paso, gráficas o fórmulas según el tema.

Cada tipo de bloque tiene sus campos. Ante la duda, revisa el catálogo de bloques en /agentes: es la fuente autorizada de qué acepta la plataforma.

Estados y visibilidad

Al crear decides dos cosas independientes:

• Estado: déjalo en DRAFT mientras lo ajustas; PUBLISHED lo saca al público.
• Visibilidad: público, no listado (se abre sólo por enlace), de círculo o privado.

Para que un docente pueda montarlo en su curso, además hay que autorizar su uso en cursos (ver la ayuda para administradores).

Autoevaluación del objeto

Puedes adjuntar a un objeto su banco de reactivos de opción múltiple, con su explicación. El alumno lo encontrará como el Registro de Autoevaluación desde la ficha del objeto.

Fundamento oficial (trazable hasta el plan de estudios)

Un objeto puede declarar a qué requisito oficial responde (SEP u otro sistema). Ese fundamento es hoy parte del propio objeto: viaja con él cuando la biblioteca se sincroniza entre nodos, y aparece en la ficha junto a cada requisito verificado, con su liga «Ver documento oficial».

• Se referencia por el código del requisito, no por un texto suelto: así el mismo OA apunta al mismo plan en cualquier nodo.
• La página del PDF sólo se muestra si está confirmada contra el documento oficial; sin verificación se omite, nunca se supone.
• Lo que propone un agente queda marcado «en revisión» (agent_proposed): la etiqueta de «verificado» la pone una persona o una fuente de confianza, jamás el propio agente.

Recuerda el aviso permanente: Lumbre no es una plataforma avalada por la SEP; el fundamento es una ayuda de trazabilidad, no una certificación oficial.

Si algo falla

La API responde 422 con una lista de errors[] legible: corrige los campos señalados y reintenta. La validación es estricta justamente para que el objeto se vea bien en cualquier pantalla.