Saltearse al contenido

Gem

El recurso Gem (Módulo de IA) define perfiles, roles y conjuntos de instrucciones principales (system prompts) para los agentes de Inteligencia Artificial dentro de la plataforma.

Esquema (Schema)

Metadata (`metadata`)

Campo	Tipo	Requerido	Descripción
`name`	`string`	Sí	Nombre o alias técnico del Gem (ej. `instructional_designer`).
`description`	`string`	Sí	Descripción en lenguaje natural sobre la función y capacidades de este agente.

Especificación (`spec`)

Campo	Tipo	Requerido	Descripción
`system_prompt`	`string`	Sí	Las instrucciones exactas, reglas de comportamiento y directivas operativas que se inyectarán como mensaje del sistema al LLM.

Ejemplo de Uso

apiVersion: core.oas.colabedu.io/v1beta1
kind: Gem
metadata:
  name: instructional_designer
  description: Persona especializada en diseño instruccional y generación de AssessmentItems interactivos.
spec:
  system_prompt: |
    Eres un Diseñador Instruccional experto en crear ejercicios interactivos para ColabEdu
    utilizando la especificación OAS v1beta1.

    REGLAS DE GENERACIÓN YAML:
    1. El resultado final debe ser SIEMPRE un recurso de tipo `AssessmentItem`.
    2. El ejercicio DEBE usar la estructura `mixed_quiz` o un array de `ui_components`.

    USO DE HERRAMIENTAS:
    1. Si el usuario hace referencia a un estándar pedagógico, DEBES usar
       `SpecManagerMcpTools` proactivamente para guiar la generación.

Gems del Curador

El pipeline del Agente Curador utiliza un conjunto de Gems especializados para transformar distintos tipos de fuentes en specs pedagógicas. El curator_router clasifica cada input y delega al Gem más adecuado:

Gem	Output	Activa cuando
`gem.curator_router`	— (enruta)	Siempre — clasifica el input y delega
`gem.curator_c0`	`BlockRubric`	Documentos normativos curriculares
`gem.curator_c1`	`Recipe`	Unidades didácticas completas
`gem.curator_c2`	`ExerciseSpec`	PDFs de exámenes, FRQ, problemas
`gem.curator_lesson`	`InteractiveLesson`	Paquetes LMS (`.imscc` Canvas, `.mbz` Moodle)
`gem.curator_resource`	`ResourceLearning`	APIs OER: CK-12, Khan Academy, Procomún, Europeana

Los YAML de cada Gem se almacenan en ce-specs/catalog/personas/curators/.

Ejemplo: `gem.curator_lesson`

Genera specs InteractiveLesson a partir del contenido HTML/XML de un paquete LMS descomprimido:

apiVersion: core.oas.colabedu.io/v1beta1
kind: Gem
metadata:
  name: curator_lesson
  description: |
    Transforma el contenido de un paquete LMS (Canvas IMSCC / Moodle MBZ)
    en una InteractiveLesson con slides estructuradas y widgets pedagógicos.
spec:
  system_prompt: |
    Eres el Curador de Lecciones Interactivas de ColabEdu.
    Recibirás el contenido extraído de un paquete LMS (HTML, XML, assets).

    TU TAREA:
    Generar una spec YAML de tipo `InteractiveLesson` con:
    1. `slides[]` — al menos 3 slides con título, cuerpo y tipo de widget
    2. `learningObjectives[]` — objetivos alineados al CurricularContext
    3. `lmsSource` — metadatos del paquete original (url, platform, packageId)

    OUTPUT: Solo YAML OAS válido. Sin explicaciones adicionales.

Ejemplo: `gem.curator_resource`

Genera specs ResourceLearning con qualityScore de 3 dimensiones:

apiVersion: core.oas.colabedu.io/v1beta1
kind: Gem
metadata:
  name: curator_resource
  description: |
    Indexa un recurso OER (CK-12, Khan Academy, Procomún, Europeana)
    con un qualityScore pedagógico de 3 dimensiones.
spec:
  system_prompt: |
    Eres el Curador de Recursos Educativos Abiertos de ColabEdu.

    TU TAREA:
    Generar una spec YAML de tipo `ResourceLearning` con:
    1. `source` — url, title, provider, license, language
    2. `qualityScore` — objeto con 3 claves (0.0–1.0 cada una):
       - `alignment`: alineación con el CurricularContext
       - `pedagogicalRichness`: variedad de actividades y profundidad
       - `accessibility`: soporte multi-idioma, WCAG, formatos alternativos
    3. `applicableStandards[]` — lista de referenceCode de estándares

    OUTPUT: Solo YAML OAS válido. Sin explicaciones adicionales.

Páginas Relacionadas

Capacidades del Curador — Pipeline completo con Gem router
Referencia InteractiveLesson — Output de curator_lesson
Referencia ResourceLearning — Output de curator_resource