Herramientas
Referencia de las herramientas que expone el servidor.
El servidor expone 4 herramientas. Esta referencia sale directo del código: las descripciones son exactamente las que recibe el agente.
| Herramienta | Qué hace |
|---|---|
aula_get_site_info | Datos del usuario logueado en el aula virtual de la UTN FRBA y del sitio Moodle. |
aula_list_courses | Lista los cursos (materias) en los que está inscripto el usuario. |
aula_open | Entra a una dirección del aula virtual y devuelve lo que hay ahí: un curso con sus secciones y módulos, un módulo con sus archivos y fechas, un foro con el índice de sus discusiones, o una discusión con sus mensajes completos. |
aula_read_file | Lee un archivo del aula virtual: PDF, Word (docx), PowerPoint (pptx), Excel (xlsx), imágenes y texto. |
aula_get_site_info
Datos del usuario logueado en el aula virtual de la UTN FRBA y del sitio Moodle.
Sin parámetros.
aula_list_courses
Lista los cursos (materias) en los que está inscripto el usuario. Es el punto de entrada: cada curso viene con su direccion, que se le pasa a aula_open para entrar.
Sin parámetros.
aula_open
Entra a una dirección del aula virtual y devuelve lo que hay ahí: un curso con sus secciones y módulos, un módulo con sus archivos y fechas, un foro con el índice de sus discusiones, o una discusión con sus mensajes completos.
No hace falta armar la dirección: cada respuesta trae las direcciones de lo que hay adentro (direccion) y la de un nivel más arriba (padre), así que se navega pasando de vuelta una de esas. Para empezar, usar aula_list_courses o la dirección "/".
Buscar algo que puede estar en cualquier parte (una fecha de parcial, un aviso) se hace entrando al curso y abriendo lo que corresponda: el índice de un foro muestra los asuntos sin volcar los mensajes enteros, y archivos como un cronograma se leen con aula_read_file.
Los archivos vienen con una url, que sirve para leerlos con aula_read_file y también para dársela al usuario si quiere bajarlo: se abre con su sesión del aula.
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
direccion | string | requerido | Dirección a abrir, sacada de una respuesta anterior. Ej: "/", "/curso/691", "/curso/691/mod/34806", "/curso/691/mod/34806/disc/421348". |
pagina | integer | opcional | Solo para foros: página del índice de discusiones, de 50 en 50. La respuesta avisa con hayMasDiscusiones cuando hay otra. |
aula_read_file
Lee un archivo del aula virtual: PDF, Word (docx), PowerPoint (pptx), Excel (xlsx), imágenes y texto. Los PDF escaneados se devuelven como imagen de cada página.
Devuelve el archivo por partes (páginas, diapositivas o fragmentos), tantas como entren en una respuesta. Si quedan más, siguiente dice desde cuál pedir; también se puede saltar directo a una parte con desde.
Formatos que no sabe leer (.doc, .ppt viejos, .zip, .rar, videos): devuelve un error con la URL para que el usuario lo baje.
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
url | string | requerido | La url del archivo tal como la devuelve aula_open. |
desde | integer | opcional | Número de página, diapositiva o fragmento desde el cual leer. Por defecto, 1. |
Archivos que puede leer
- PDF: el texto, página por página. Los escaneados se mandan como imagen de cada página, y el agente los lee igual.
- Word (.docx), PowerPoint (.pptx) y Excel (.xlsx): el texto, con las tablas fila por fila.
- Imágenes (PNG, JPG, GIF) y texto plano.
Los formatos viejos de Office (.doc, .ppt, .pps), los comprimidos (.zip, .rar) y los videos no se leen. En ese caso el agente te pasa el link para que lo bajes.
Links de descarga
Cada archivo viene con un link del aula virtual que podés abrir en tu navegador. Funciona con tu sesión del aula (si no estás logueado te manda al login) y nunca incluye tu token: ese queda siempre en tu computadora.
Generado desde nialvape/utn-mcp. Para cambiar esta página, editá el README del servidor.