Saltearse al contenido

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.

CampoQué hace
Credential (obligatorio)La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key.
ResourceCon qué trabajas: Paths (rutas), Quizzes (cuestionarios), Voice Sessions (sesiones de voz), Mentor Sessions (sesiones del mentor del curso) o Translations (traducciones). Por defecto, Paths.
OperationLo 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ónQué haceCampos
List PathsTrae 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 PathTrae una ruta con su configuración y sus módulos.Path ID
Create PathCrea una ruta nueva, sin publicar.Title, Description. Opcionales: Slug, Access, Language, Enrollment mode, Difficulty y Estimated hours.
Import CurriculumAñade módulos y lecciones al final de una ruta, sin publicar.Path ID, Modules (JSON). Opcional: AI task ID.
Publish PathPublica 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_ELITE o CORPORATE.
  • Language es el idioma en que está escrito el contenido: es (por defecto), en, pt-BR, fr, it, de o ca-ES-valencia.
  • Enrollment mode: OPEN (cualquiera puede matricularse, por defecto) o INVITATION_ONLY (solo por invitación).
  • Difficulty es un texto libre, por ejemplo Principiante, Intermedio o Avanzado. Por defecto, Principiante.
  • Estimated hours es el número de horas estimado, por ejemplo 6 o 2.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ónQué haceCampos
List QuizzesLista los cuestionarios que puedes editar, con su módulo, su ruta y cuántas preguntas tienen.
Get QuizTrae un cuestionario con sus preguntas y los criterios de corrección del profesor.Quiz ID
Get Module QuizIgual, 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ónQué haceCampos
Get Voice SessionTrae 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 ResultEnví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ónQué haceCampos
Get Mentor SessionTrae 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 LessonTrae 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: LESSON si el alumno pregunta desde una lección, COURSE si 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, con id, title y description.
  • current_lesson: la lección en la que está, con id, title, module y content. Vacío con COURSE.
  • outline: los módulos con sus lecciones (id, title, summary y current, 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 Session como un componente normal antes del agente, no como herramienta, y lleva su context a las instrucciones del agente, por ejemplo con Parse Data ({context}) y un Prompt. Así cada pregunta llega ya con su contexto.
  • Da Get Mentor Lesson al 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ónQué haceCampos
Estimate TranslationCalcula el coste y el tamaño de traducir la ruta a los idiomas elegidos.Path ID. Opcionales: Languages y Retranslate all.
Run TranslationPone en marcha la traducción automática de la ruta.Path ID. Opcionales: Languages y Retranslate all.
Translation StatusMuestra 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, de o ca-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 Translation añ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.

  1. 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).
  2. Añade AcademIA Content con el recurso Paths y la operación Create Path. Rellena Title y Description con los que propone el modelo.
  3. Conecta un segundo AcademIA Content con la operación Import Curriculum: en Path ID el dato id de la ruta recién creada y en Modules (JSON) el temario.
  4. Revisa el curso en AcademIA y publícalo con Publish Path, o lanza después Run Translation con en en Languages.

Buenas prácticas

  • Antes de traducir, usa Estimate Translation para ver el coste.
  • Import Curriculum necesita 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 Paths o del resultado de Create 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 Curriculum llegan también sin publicar.
  • Publish Path publica solo la ruta: sus módulos y sus lecciones conservan su propio estado. Revísalos y publícalos en AcademIA.
  • Import Curriculum añade siempre al final: si lo ejecutas dos veces, los módulos quedan repetidos.

Componentes relacionados