Herramientas
Este servidor tiene 4 herramientas. Esta página se genera a partir del propio servidor, así que las muestra tal como las recibe tu aplicación de IA, con las descripciones que lee el agente (él las lee en inglés; aquí van traducidas). Tú no llamas a las herramientas: pides lo que necesitas con tus palabras, y el agente las elige.
| Herramienta | Qué hace | Solo lee |
|---|---|---|
list_h5p_types | Listar los tipos de contenido H5P | ✓ |
build_h5p | Crear un paquete H5P | |
read_h5p | Leer un paquete H5P | ✓ |
server_info | Información del servidor | ✓ |
list_h5p_types
Listar los tipos de contenido H5P
Lista los tipos de contenido H5P para los que este servidor crea paquetes: la librería y la versión fijada de cada uno, para qué sirve y, en los tipos que contienen otros (Question Set, Course Presentation), los tipos que van dentro (parts). Con type, da sus campos: la forma del contenido que build_h5p recibe para él, con la clase de cada campo, si es obligatorio, sus límites, sus opciones y las etiquetas HTML que admite. Los botones y mensajes no aparecen: build_h5p los rellena en el idioma del paquete. Las imágenes y otros medios aún no se admiten. Hay que leer los campos de cada tipo antes de escribir su contenido, y los de cada parte que se meta dentro de otro.
| Entrada | Obligatoria | Tipo | Descripción |
|---|---|---|---|
type | string | Un tipo de contenido o una parte, como H5P.MultiChoice, para obtener sus campos; sin él, la lista |
build_h5p
Crear un paquete H5P
Crea un paquete .h5p solo con contenido (h5p.json y content/content.json, sin librerías) a partir del contenido escrito para uno de los tipos de list_h5p_types, con la forma que dan sus campos. Primero se comprueba el contenido, con las reglas que aplica un sitio al desplegar el paquete (campos obligatorios, clases, límites, las etiquetas HTML que admite cada texto) y las del propio tipo (una opción múltiple con una respuesta correcta, un hueco con su respuesta…); si algo está mal, no se escribe nada y el error lista qué corregir. El texto plano se escapa; donde un campo admite HTML, se puede usar HTML sencillo con sus etiquetas permitidas. Los botones y mensajes se rellenan en el idioma del paquete. Escribe <destDir>/<name>.h5p y, salvo que preview sea false, <name>.preview.html a su lado: el contenido como una página para revisarlo antes de subirlo. Hay que confirmarlo con la persona antes de sobrescribir. El paquete solo se reproduce en un sitio que tenga ese tipo instalado en esa versión; subirlo es trabajo de otra herramienta.
| Entrada | Obligatoria | Tipo | Descripción |
|---|---|---|---|
type | ✅ | string | El tipo de contenido, como H5P.MultiChoice (de list_h5p_types) |
title | ✅ | string | El título del paquete, tal como lo mostrará el sitio |
language | ✅ | string | El código del idioma del contenido, como es o en: sus botones y mensajes salen en él |
content | ✅ | object | El contenido, con la forma que da list_h5p_types para el tipo |
destDir | ✅ | string | Una carpeta existente donde escribir el paquete (ruta absoluta) |
name | string | El nombre del archivo sin .h5p; por defecto, sale del título | |
overwrite | boolean | Sustituir el paquete y la vista previa si existen; solo cuando la persona esté de acuerdo | |
preview | boolean | Escribir la vista previa HTML junto al paquete (por defecto, true) |
read_h5p
Leer un paquete H5P
Lee lo que contiene un paquete .h5p local: su tipo y versión, título, idioma y su contenido, con la misma forma que recibe build_h5p, para revisarlo, o cambiarlo y volver a crearlo con build_h5p. También lee los paquetes que traen sus librerías (solo su contenido; libraries las enumera). supported dice si build_h5p crea este tipo en esta versión. Solo lee.
| Entrada | Obligatoria | Tipo | Descripción |
|---|---|---|---|
path | ✅ | string | El archivo .h5p (ruta absoluta) |
server_info
Información del servidor
Muestra el nombre, la versión y la carpeta de datos de este servidor y, si el servidor necesita programas instalados aparte, si están. No contiene secretos.
Sin entradas.