AcademIA AI Tasks
AcademIA AI Tasks usa los generadores de contenido con IA que trae AcademIA: cuestionarios, lecciones, tarjetas de estudio, juegos como crucigramas o escape rooms, o el temario de una ruta a partir de un documento. El trabajo lo hace la IA de la propia AcademIA, no el modelo de tu flujo, y el resultado queda en AcademIA, junto al curso.
Cada generación es una tarea que AcademIA hace en segundo plano. Con este componente la pones en marcha, consultas cómo va y recoges su resultado, o la cancelas.
Cuándo usarlo
- Un profesor pide a un asistente un cuestionario de práctica para un módulo de su curso.
- Quieres generar juegos de repaso para los módulos de un curso desde una automatización.
- Tienes un documento subido a AcademIA y quieres que proponga el temario de una ruta.
- Una tarea ya no hace falta y quieres cancelarla.
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.
La clave de la credencial tiene que poder editar el contenido, así que debe actuar como Admin de contenido (CONTENT_ADMIN), Admin de facultad (FACULTY_ADMIN) o Super admin (SUPER_ADMIN).
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key. |
| Resource | Siempre AI Tasks. |
| Operation | Create AI Task, Get AI Task o Cancel AI Task. Ver Recursos y operaciones. |
Recursos y operaciones
AI Tasks (tareas de IA)
| Operación | Qué hace | Campos |
|---|---|---|
Create AI Task | Pone en marcha un generador de IA sobre un módulo, una ruta o una lección. Puede esperar al resultado. | Task type, Label, Content ID. Opcionales: Applies to, Options (JSON), Wait until done y Max wait (s). |
Get AI Task | Trae el estado y el resultado de una tarea. Puede esperar a que termine. | Task ID. Opcionales: Wait until done y Max wait (s). |
Cancel AI Task | Marca como cancelada una tarea pendiente o en curso. | Task ID |
Los campos de Create AI Task:
- Task type es lo que genera AcademIA. Entre otros:
QUIZ_GENERATION(cuestionario),LESSON_GENERATION(lección),LESSON_FROM_DOCUMENT(lección a partir de un documento),PATH_CURRICULUM_GENERATION(temario de una ruta a partir de un documento),FLASHCARDS_GENERATION(tarjetas de estudio) y juegos comoTRIVIA_GENERATION,CROSSWORD_GENERATION,HANGMAN_GENERATION,WORD_PUZZLE_GENERATION,MEMORY_MATCH_GENERATION,MATCHING_PAIRS_GENERATION,DRAG_AND_DROP_GENERATION,TIMELINE_CHALLENGE_GENERATION,SPEED_QUIZ_GENERATION,SCENARIO_CHALLENGE_GENERATION,ESCAPE_ROOM_GENERATIONoADVENTURE_GENERATION. La lista completa aparece en el desplegable. - Label es el texto con el que la tarea aparece en AcademIA.
- Applies to es el tipo de contenido sobre el que trabaja:
module(por defecto),patholesson. Content ID es su identificador. - Options (JSON) son los ajustes del generador, por ejemplo
{"generationParams": {"quantity": 10, "language": "es"}}. El identificador del contenido se añade solo. - Wait until done: activado, el componente espera a que la tarea termine y devuelve su resultado. Max wait (s), en los ajustes avanzados, es cuánto espera como mucho: por defecto 300 segundos.
Task ID es el identificador que devuelve Create AI Task en su dato id.
Resultado
La salida Data devuelve la tarea con:
id: su identificador.status:PENDING(pendiente),RUNNING(en curso),COMPLETED(terminada),FAILED(ha fallado) oCANCELLED(cancelada).progressPct: el porcentaje de avance.resultPayload: el resultado, cuando ha terminado.
Si la espera se acaba antes de que la tarea termine, el resultado lo indica: vuelve a consultarla más tarde con Get AI Task.
El componente admite Batch Mode y se puede conectar a un Agente como herramienta. Ver Herramientas.
Ejemplo
Una academia quiere que sus profesores pidan cuestionarios de práctica desde un chat.
- Monta un chat con Chat Input, un Agent y Chat Output.
- Añade AcademIA AI Tasks con la operación
Create AI Tasky conecta su salida Tool al conector Tools del agente. - Fija Task type en
QUIZ_GENERATIONy Applies to enmodule, y deja que el agente rellene Label y Content ID. Desactiva Wait until done. - En las instrucciones del agente, explica que debe crear la tarea con el módulo que diga el profesor y avisarle de que el cuestionario aparecerá en AcademIA cuando esté listo.
Buenas prácticas
- En un chat, no esperes al resultado: crea la tarea sin esperar y consúltala después con
Get AI Task. - Si quieres escribir el contenido con el modelo de tu flujo en lugar de con la IA de AcademIA, genera el temario con un modelo y guárdalo con AcademIA Content, operación
Import Curriculum. - El temario que genera
PATH_CURRICULUM_GENERATIONse guarda en la ruta con AcademIA Content, operaciónImport Curriculum: pasa sus módulos en Modules (JSON) y el identificador de la tarea en AI task ID.
Seguridad y limitaciones
- Cancelar una tarea solo cambia su estado: si la generación ya había empezado, puede terminar igualmente.
- Las tareas no sobreviven a un reinicio de AcademIA: si AcademIA se reinicia mientras una tarea está en curso, se pierde.
PATH_CURRICULUM_GENERATIONnecesita un documento subido antes a AcademIA. Su identificador (uploadId) va en Options (JSON) y solo vale durante una hora.
Componentes relacionados
- AcademIA Content: crear rutas e importar temarios.
- AcademIA MCP: un agente que escribe y revisa cursos.