Saltearse al contenido

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

CampoQué hace
Credential (obligatorio)La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key.
ResourceSiempre AI Tasks.
OperationCreate AI Task, Get AI Task o Cancel AI Task. Ver Recursos y operaciones.

Recursos y operaciones

AI Tasks (tareas de IA)

OperaciónQué haceCampos
Create AI TaskPone 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 TaskTrae 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 TaskMarca 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 como TRIVIA_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_GENERATION o ADVENTURE_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), path o lesson. 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) o CANCELLED (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.

  1. Monta un chat con Chat Input, un Agent y Chat Output.
  2. Añade AcademIA AI Tasks con la operación Create AI Task y conecta su salida Tool al conector Tools del agente.
  3. Fija Task type en QUIZ_GENERATION y Applies to en module, y deja que el agente rellene Label y Content ID. Desactiva Wait until done.
  4. 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_GENERATION se guarda en la ruta con AcademIA Content, operación Import 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_GENERATION necesita un documento subido antes a AcademIA. Su identificador (uploadId) va en Options (JSON) y solo vale durante una hora.

Componentes relacionados