Crear y publicar

Describes el ejercicio en el chat; tu IA lo construye, lo revisa y lo coloca en la página o lección que le indiques, y te devuelve una dirección real para abrirlo. Tú no tocas código en ningún momento.

Le describes el ejercicio a tu IA en lenguaje normal, ella lo construye, comprueba que esté bien formado y lo coloca en la página o lección que le digas. Al terminar te da una dirección real donde quedó, para que la abras y lo veas puesto. Tú no escribes código ni maquetas nada.

El recorrido de un ejercicio

Lo describes. "Un test de 5 preguntas sobre el pretérito, con una explicación en cada respuesta." Cuanto más claro el contenido, mejor el resultado.
Tu IA lo construye y lo revisa. Antes de publicar, la herramienta valida el ejercicio y devuelve avisos accionables si algo falta. Es un bucle rápido —construir, revisar, corregir— que ocurre solo, sin que tú hagas nada.
Lo pruebas sin colocarlo (opcional). Puedes pedir una vista previa: una dirección con tu marca donde juegas el ejercicio antes de decidir dónde va.
Lo colocas. Le dices el destino —una página, una entrada o una lección— y lo publica ahí. Te devuelve la dirección exacta donde quedó.

Lo que hace tu IA por debajo

No necesitas saberlo para usarlo, pero si te preguntas qué está pasando —o si quieres pedirle un paso concreto— estas son las operaciones que tiene disponibles:

Operación	Qué hace
`list-exercise-types`	Los tipos que soporta tu instalación, con su forma exacta
`list-targets` / `get-target`	Busca la página o lección de destino por título
`list-assets` / `set-asset`	Las imágenes y audios de tu sitio; y registrar uno nuevo
`validate-exercise`	Comprueba que el ejercicio es válido antes de publicar
`preview-exercise`	Una dirección para jugarlo sin colocarlo en ningún sitio
`publish-exercise`	Lo coloca en el destino y devuelve la dirección real
`get-exercise` / `update-exercise`	Leer y corregir uno ya publicado
`unplace-exercise` / `delete-exercise`	Quitarlo de un destino, o borrarlo

Una petición típica que puedes copiar tal cual:

Consulta primero list-assets y list-exercise-types.
Crea un ejercicio de tipo quiz sobre los colores en alemán, 5 preguntas,
cada respuesta con su explicación. Valídalo, dame la vista previa y
espera mi visto bueno antes de publicarlo.

Si algo no encaja, no es un fallo del servidor

Cuando una operación falla, siempre es de validación y viene con el campo, el mensaje y una pista de cómo arreglarlo. Tu IA lo lee y reintenta sola. Si te dice "el servidor da error", pídele que te enseñe el detalle: casi seguro es un campo mal puesto que ella misma puede corregir.

Di el destino por su nombre, no por un número

Cuando quieras colocarlo en una lección, dile a tu IA el título de la lección (o su dirección), no "la lección 7". El número que ves en tu pantalla no es el identificador interno que usa el sistema por dentro, y adivinarlo lleva al sitio equivocado. Tu IA busca la lección por su título; si hay varias con el mismo nombre en cursos distintos, te las muestra para que elijas.

Corregir sin acumular duplicados

Cada vez que se publica se crea un ejercicio nuevo. Si corriges algo y vuelves a publicar en el mismo sitio, dile "reemplaza el que ya subí": así sustituye el anterior en vez de dejar dos. Para una lección que ya tiene contenido, tu IA te pedirá confirmación antes de escribir: nunca publica a ciegas en producción.

Cómo sabes que funciona

Publicar devuelve dos señales: que el ejercicio se colocó y se vio en el destino, y la dirección real donde quedó. Ábrela tú mismo y compruébalo —esa es la prueba, no el "hecho" del chat—. Haz la primera con un ejercicio de nombre test-alloop para no tocar una lección de verdad.

Si tu curso está detrás de un muro (solo alumnos inscritos lo ven), compruébalo entrando como un alumno con acceso. Si miras la lección sin haber iniciado sesión, verás el aviso de "contenido restringido", no el ejercicio: eso es el muro haciendo su trabajo, no un fallo.

La parte incómoda

La IA escribe el contenido; tú lo revisas. La validación garantiza que el ejercicio no salga roto, pero no juzga si tu pregunta es correcta o tu explicación es la mejor. Míralo en la vista previa antes de publicarlo a tus alumnos.
No puede crear lecciones ni páginas nuevas. Coloca ejercicios en destinos que ya existen. Si el sitio donde lo quieres no existe todavía, créalo tú primero (o dale su dirección) y luego lo publica ahí.
"Guardado" no es "visible". Por eso la señal que importa es la dirección real del destino, abierta por ti. Si algo no cuadró en la colocación, la herramienta te lo dice en vez de dar por bueno un ejercicio que no se ve.

Retirar o borrar

Un ejercicio se puede retirar de una lección sin borrarlo (útil si lo reutilizas en varios sitios) o borrar por completo. En ambos casos se limpia lo que se escribió en la lección, sin dejar restos sueltos. Basta con pedírselo a tu IA.

Errores comunes

Síntoma	Causa probable	Arreglo
El ejercicio se colocó pero no se ve en la lección	La colocación no se confirmó	Pídele "reemplaza el que subí" o reabre y guarda la lección
Aparecen dos ejercicios donde querías uno	Republicaste sin reemplazar	La próxima corrección, di "reemplaza el que ya subí"
Miro la lección y sale "contenido restringido"	Estás sin sesión o sin acceso	Compruébalo como un alumno inscrito
La IA dice que no encuentra la lección	Le pasaste un número en vez del título	Dale el título o la dirección de la lección

Siguiente paso

¿Dudas antes de empezar? Mira las preguntas frecuentes.

¿Te atascas? Pregúntale a tu IA

Pregúntale a tu IA

Esta documentación está pensada para leerse con una IA al lado. Abre tu asistente con el contexto de alloop ya cargado y pregúntale lo que necesites, en tu idioma.

Para qué NO sirve: una IA no ve tu panel, tus pagos ni tus datos, y puede equivocarse. Si un ingreso no aparece, algo toca tu producción o necesitas una respuesta oficial, escríbenos: esto no sustituye al soporte.

Claude ChatGPT Gemini

En esta página