AcademIA Content
AcademIA Content lleva al flujo el Creator Studio de AcademIA, donde se crean los cursos. Con un solo componente trabajas con las rutas de aprendizaje (los cursos) y con sus traducciones: puedes crear una ruta, añadirle de golpe todo el temario con sus lecciones, publicarla y traducirla a otros idiomas.
Es útil para producir cursos de forma automática, por ejemplo a partir de un documento que un modelo de IA convierte en temario.
Cuándo usarlo
- Tienes un manual en PDF y quieres convertirlo en un curso: un modelo de IA escribe los módulos y las lecciones, y el flujo crea la ruta en AcademIA.
- Quieres publicar o retirar del catálogo una ruta desde una automatización.
- Necesitas traducir un curso al inglés, al portugués o a otro idioma y seguir cómo va la traducción.
- Un asistente de contenidos debe poder listar los cursos, leer uno o lanzar su traducción cuando se lo pidan.
- Quieres que un agente haga de mentor del curso: que conteste las dudas del alumno con la lección que está viendo y el resto del curso.
Configuración
Necesitas una credencial AcademIA con dos datos: AcademIA API address, la dirección de la API de AcademIA (por ejemplo https://academia.nappai.es/api), y API key, una clave de API de AcademIA (empieza por nappai_int_sk_live_). NappAI no pide el correo ni la contraseña de ninguna cuenta de AcademIA. Consulta Credenciales.
La clave la crea un administrador de AcademIA con Nueva clave:
- Un Super admin, en Plataforma › Claves de API. En Actúa como elige el rol con el que trabaja la clave (y su organización o su facultad, si el rol la pide). Para el evaluador por voz y el mentor del curso, marca además Sesiones de voz y mentor.
- Un Admin corporativo, en Avanzado › Claves de API. Esa clave actúa como administrador de su empresa y solo ve su organización.
AcademIA muestra la clave una sola vez: cópiala al crearla y pégala en API key. Si alguien la revoca en AcademIA, el flujo deja de entrar al momento y hay que crear otra.
Para este componente, la clave debe actuar como Admin de contenido (CONTENT_ADMIN), Admin de facultad (FACULTY_ADMIN) o Super admin (SUPER_ADMIN). Una clave de Admin de contenido solo ve y edita sus propias rutas: las que creó, en las que es instructor o las de su facultad.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key. |
| Resource | Con qué trabajas: Paths (rutas), Quizzes (cuestionarios), Voice Sessions (sesiones de voz), Mentor Sessions (sesiones del mentor del curso) o Translations (traducciones). Por defecto, Paths. |
| Operation | Lo que haces. La lista cambia según el Resource elegido. Ver Recursos y operaciones. |
Al elegir el recurso y la operación, el componente muestra solo los campos que esa operación necesita.
Recursos y operaciones
Paths (rutas de aprendizaje)
| Operación | Qué hace | Campos |
|---|---|---|
List Paths | Trae las rutas que la clave puede editar, con su estado de publicación, sus módulos y sus matrículas. | Opcional: Enrollment mode (Any, OPEN o INVITATION_ONLY). |
Get Path | Trae una ruta con su configuración y sus módulos. | Path ID |
Create Path | Crea una ruta nueva, sin publicar. | Title, Description. Opcionales: Slug, Access, Language, Enrollment mode, Difficulty y Estimated hours. |
Import Curriculum | Añade módulos y lecciones al final de una ruta, sin publicar. | Path ID, Modules (JSON). Opcional: AI task ID. |
Publish Path | Publica una ruta o la retira del catálogo. | Path ID, Published (activado la publica; desactivado la retira). |
Los campos de Create Path:
- Slug es el nombre de la ruta en su dirección web: letras, números y guiones. Si lo dejas vacío, se forma a partir del título.
- Access dice quién puede hacerla:
FREE_REGISTERED(cualquier persona registrada, el de por defecto),PUBLIC,PAID_STARTER,PAID_PRO,PAID_ELITEoCORPORATE. - Language es el idioma en que está escrito el contenido:
es(por defecto),en,pt-BR,fr,it,deoca-ES-valencia. - Enrollment mode:
OPEN(cualquiera puede matricularse, por defecto) oINVITATION_ONLY(solo por invitación). - Difficulty es un texto libre, por ejemplo
Principiante,IntermediooAvanzado. Por defecto,Principiante. - Estimated hours es el número de horas estimado, por ejemplo
6o2.5.
Modules (JSON) lleva la lista de módulos, cada uno con su título y sus lecciones. El contenido de cada lección va en contentMd, en formato Markdown:
[ { "title": "Introducción", "description": "Qué vas a aprender en este curso", "lessons": [ { "title": "Bienvenida", "contentMd": "## Hola\nEn este curso…", "estimatedMinutes": 10 } ] }]Cada módulo y cada lección necesitan un título. AI task ID es opcional: si el temario viene de una tarea de IA de AcademIA (ver AcademIA AI Tasks), pon su identificador y AcademIA la marca como aceptada.
Quizzes (cuestionarios con los criterios del profesor)
| Operación | Qué hace | Campos |
|---|---|---|
List Quizzes | Lista los cuestionarios que puedes editar, con su módulo, su ruta y cuántas preguntas tienen. | |
Get Quiz | Trae un cuestionario con sus preguntas y los criterios de corrección del profesor. | Quiz ID |
Get Module Quiz | Igual, a partir del módulo al que pertenece. | Module ID |
Devuelven el cuestionario tal como lo necesita un evaluador: título, nota para aprobar (70 por defecto) y cada pregunta con su id, su tipo, su texto y sus criterios. Es la forma de que un agente evaluador, también un agente de voz, lea el tema que tiene que evaluar directamente de AcademIA: conéctalo como herramienta del agente con el id fijo. Necesita una clave que actúe como Admin de contenido, Admin de facultad o Super admin (CONTENT_ADMIN, FACULTY_ADMIN o SUPER_ADMIN).
Voice Sessions (evaluación por voz abierta desde AcademIA)
Cuando un alumno elige el modo voz de un cuestionario conversacional, AcademIA abre una sesión de voz (sabe qué alumno y qué cuestionario) y llama al agente de voz publicado. La llamada lleva en su contexto academia_session:<id>; con estas dos operaciones el agente canjea ese id y devuelve el resultado.
| Operación | Qué hace | Campos |
|---|---|---|
Get Voice Session | Trae el alumno (name, first_name), el curso (course) y el cuestionario con sus preguntas y criterios, con la misma forma que Get Quiz. Una sesión caducada, ya evaluada o inexistente da un error con su motivo. | Session ID (con o sin el prefijo academia_session:). |
Submit Voice Result | Envía la puntuación de 0 a 100 de cada pregunta. AcademIA calcula la nota final (media redondeada) y el aprobado con la nota mínima del cuestionario, registra el intento, avisa al alumno y lo deja en la cola de revisión del profesor. Devuelve score, passed y passing_score. | Session ID, Result (JSON). |
Result (JSON) lleva una respuesta por pregunta:
{ "answers": [ { "question_id": "…", "score": 80, "student_answer": "Lo que dijo, en una frase", "comment": "Por qué esa nota", "covered": true } ], "summary": "…", "strong_points": ["…"], "weak_points": ["…"]}- El agente debe decir al alumno la nota que devuelve AcademIA, no una calculada por él.
- Cada sesión admite un solo resultado; un segundo envío se rechaza.
- La clave de la credencial necesita el permiso Sesiones de voz y mentor, que da un Super admin en Plataforma › Claves de API. Sin él, AcademIA rechaza la sesión. Lee cualquier cuestionario de la plataforma a través de la sesión, así que no hace falta un SUPER_ADMIN.
- Pon las dos operaciones como herramientas del agente de voz, con Session ID y Result (JSON) a cargo de la IA.
Mentor Sessions (el mentor del curso en AcademIA)
En AcademIA, el alumno pregunta sus dudas al mentor del curso desde una lección (Esta lección) o desde el curso entero (Todo el curso). AcademIA ejecuta tu flujo con la pregunta como mensaje del chat y con el identificador de esa conversación como sesión de la ejecución. Con estas dos operaciones el flujo sabe qué alumno pregunta y qué está viendo.
| Operación | Qué hace | Campos |
|---|---|---|
Get Mentor Session | Trae el alumno, el curso, la lección en la que está, el índice del curso, la conversación hasta ahora y un texto con todo ello listo para las instrucciones del agente. | Opcional: Mentor session ID. Déjalo vacío: se usa la sesión de la ejecución, que es la que manda AcademIA. |
Get Mentor Lesson | Trae otra lección del mismo curso con su contenido, solo si el alumno puede verla. | Lesson ID (del índice que trae Get Mentor Session). Opcional: Mentor session ID, como arriba. |
Get Mentor Session devuelve:
scope:LESSONsi el alumno pregunta desde una lección,COURSEsi pregunta por todo el curso.language: el idioma del alumno. El agente debe contestar en ese idioma.student: el nombre del alumno (first_name).course: el curso, conid,titleydescription.current_lesson: la lección en la que está, conid,title,moduleycontent. Vacío conCOURSE.outline: los módulos con sus lecciones (id,title,summaryycurrent, que marca la actual).full_course: verdadero cuando vienen todas las lecciones con su contenido.history: los mensajes anteriores de esta conversación.context: todo lo anterior en un solo texto, listo para las instrucciones del agente.
Cómo montarlo:
- Pon
Get Mentor Sessioncomo un componente normal antes del agente, no como herramienta, y lleva sucontexta las instrucciones del agente, por ejemplo con Parse Data ({context}) y un Prompt. Así cada pregunta llega ya con su contexto. - Da
Get Mentor Lessonal agente como herramienta, con Lesson ID a cargo de la IA, para que abra otra lección solo cuando la pregunta lo pida. - Mentor por voz: si el alumno pulsa Hablar con el mentor, AcademIA llama a un agente de voz y el contexto de la llamada trae
mentor_session:<id>. Pon las dos operaciones como herramientas del agente de voz, con Mentor session ID a cargo de la IA, y que cargue la sesión antes de saludar al alumno por su nombre. - AcademIA decide qué alumno, qué curso y qué lección, y solo sirve lo que ese alumno puede ver. Las respuestas de los cuestionarios nunca llegan.
- La clave de la credencial necesita el permiso Sesiones de voz y mentor, igual que Voice Sessions. Solo se aceptan identificadores de conversaciones del mentor.
Translations (traducciones de una ruta)
| Operación | Qué hace | Campos |
|---|---|---|
Estimate Translation | Calcula el coste y el tamaño de traducir la ruta a los idiomas elegidos. | Path ID. Opcionales: Languages y Retranslate all. |
Run Translation | Pone en marcha la traducción automática de la ruta. | Path ID. Opcionales: Languages y Retranslate all. |
Translation Status | Muestra cómo va la traducción en cada idioma. | Path ID. Opcional: Per item. |
- Languages son los idiomas de destino separados por comas:
es,en,pt-BR,fr,it,deoca-ES-valencia. Si lo dejas vacío, se usan los idiomas de destino que ya tiene configurados la ruta. - Retranslate all vuelve a contar o a traducir todo, también lo que ya está traducido.
Run Translationañade a la ruta los idiomas pedidos que todavía no tenía y devuelve el identificador de la tarea de traducción (aiTaskId).- Per item: desactivado, devuelve los totales y el avance por idioma; activado, cada lección, cuestionario y juego con su estado.
Resultado
La salida Data devuelve la respuesta de AcademIA en datos: un elemento por ruta en List Paths, y la ruta, el resumen o el estado en las demás. La ruta creada con Create Path trae su identificador en id, que puedes pasar al siguiente paso.
El componente admite Batch Mode y se puede conectar a un Agente como herramienta. Ver Herramientas.
Ejemplo
Una consultora quiere convertir sus manuales internos en cursos de AcademIA.
- El flujo recibe el manual y un modelo de IA con Structured Output escribe el temario como una lista de módulos con sus lecciones, en el formato de Modules (JSON).
- Añade AcademIA Content con el recurso
Pathsy la operaciónCreate Path. Rellena Title y Description con los que propone el modelo. - Conecta un segundo AcademIA Content con la operación
Import Curriculum: en Path ID el datoidde la ruta recién creada y en Modules (JSON) el temario. - Revisa el curso en AcademIA y publícalo con
Publish Path, o lanza despuésRun Translationconenen Languages.
Buenas prácticas
- Antes de traducir, usa
Estimate Translationpara ver el coste. Import Curriculumnecesita la lista de módulos en JSON. Un texto normal no sirve: pide al modelo una salida estructurada.- Los identificadores de las rutas se consiguen con
List Pathso del resultado deCreate Path. No escribas valores inventados. - Para que la propia IA de AcademIA genere cuestionarios, juegos o un temario, usa AcademIA AI Tasks.
Seguridad y limitaciones
- Las rutas se crean sin publicar, y los módulos y lecciones de
Import Curriculumllegan también sin publicar. Publish Pathpublica solo la ruta: sus módulos y sus lecciones conservan su propio estado. Revísalos y publícalos en AcademIA.Import Curriculumañade siempre al final: si lo ejecutas dos veces, los módulos quedan repetidos.
Componentes relacionados
- AcademIA AI Tasks: los generadores de IA de AcademIA.
- AcademIA Enrollment: invitar y matricular a personas en tus rutas.
- AcademIA MCP: un agente que escribe y revisa cursos.