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 dos formas de crear

El Estudio (web)

Entra en /object-studio. El flujo es:

1. Describes qué quieres (tema, materia, edades, objetivo) y el Estudio te devuelve el prompt exacto.
2. Ese prompt lo usas con una IA externa para generar el objeto.
3. Subes el resultado: un ZIP con object.json y sus assets/, o simplemente el object.json.
4. Lumbre valida, firma y extrae los recursos, y lo deja publicado con su portada.

La clasificación (materia, edades, idioma) viaja dentro del propio object.json.

La API para agentes

Para crear en lote o desde un agente de IA, usa la API abierta:

• 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.

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

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.