Saltar al contenido principal

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.

HerramientaQué haceSolo lee
list_h5p_typesListar los tipos de contenido H5P✓
build_h5pCrear un paquete H5P
read_h5pLeer un paquete H5P✓
server_infoInformació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.

EntradaObligatoriaTipoDescripción
typestringUn 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.

EntradaObligatoriaTipoDescripción
type✅stringEl tipo de contenido, como H5P.MultiChoice (de list_h5p_types)
title✅stringEl título del paquete, tal como lo mostrará el sitio
language✅stringEl código del idioma del contenido, como es o en: sus botones y mensajes salen en él
content✅objectEl contenido, con la forma que da list_h5p_types para el tipo
destDir✅stringUna carpeta existente donde escribir el paquete (ruta absoluta)
namestringEl nombre del archivo sin .h5p; por defecto, sale del título
overwritebooleanSustituir el paquete y la vista previa si existen; solo cuando la persona esté de acuerdo
previewbooleanEscribir 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.

EntradaObligatoriaTipoDescripción
path✅stringEl 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.