Asistente

English version

Asistente para gestores

El asistente es una forma más sencilla de usar el servidor MCP: un chat en una ventana propia, en tu ordenador, con el modelo de lenguaje de MonitorEO, Claude Sonnet 5.5 de Anthropic, que funciona en la nube a través de MonitorEO, sin instalar nada ni tener cuenta ni clave; o, si lo prefieres, con un modelo abierto que funciona en tu propio ordenador (con Ollama), que responde peor (ver Qué modelo). Le pides en lenguaje natural lo que quieres calcular, por ejemplo "Serie mensual del NDVI en el Parque Nacional de Doñana en 2024". Los textos de la ventana están en inglés, pero puedes escribir en español o en inglés: el asistente responde en el idioma de cada pregunta. El asistente busca el área, elige la variable y el sensor, lanza el cálculo, muestra los mapas de Earth Engine (pinchando en un píxel, su valor y su serie temporal) y reúne los resultados en un informe para imprimir o guardar en PDF.

El asistente no interpreta los resultados. Las cifras, gráficas y mapas van directamente a tu pantalla y al informe. Al modelo solo le llega un acuse de recibo ("calculado y mostrado"), sin los valores, así que no puede describirlos ni sacar conclusiones. Si se lo pides, responde que la interpretación corresponde a personal técnico. Sí aconseja sobre qué variable, sensor, periodo o herramienta conviene, con la información del catálogo de MonitorEO, responde preguntas sobre MonitorEO con este manual (la wiki) y, si algo no se puede hacer con el asistente, te dice qué otra herramienta de MonitorEO lo hace.

Usa las mismas herramientas que el servidor MCP, con los mismos resultados. La diferencia es para quién está pensado:

	Asistente	MCP con Claude u otro asistente
Modelo de lenguaje	El de MonitorEO en la nube (Claude Sonnet 5.5) o uno abierto en tu ordenador (Ollama)	El de tu cliente: Claude, etc.
Los resultados	Se muestran, sin interpretar	El asistente los lee y los explica
Informes	HTML para imprimir o guardar en PDF	Lo que pidas al asistente
Herramientas	Las de cálculo, las descargas de GeoTIFF y las exportaciones a Google Drive	Todas, también la publicación en el visor (administradores)
Instalación	Un instalador (doble clic en Windows, una orden en macOS); con un modelo de tu ordenador, el asistente lo descarga la primera vez	Paquete de Python y un cliente MCP

Dónde se calcula

• Los cálculos, en Google Earth Engine, con la cuenta compartida de MonitorEO o, si escribes tu proyecto en Settings (la configuración), con tu cuenta de Google y tu proyecto de Google Cloud (cuentan en su cuota), igual que en QGIS, Python o el MCP. Ojo: según las condiciones de Google, la gestión operativa de una administración necesita un proyecto comercial de Earth Engine, no uno de uso no comercial como el de la cuenta compartida (ver Primeros pasos).
• El modelo de lenguaje, por defecto el de MonitorEO: Claude Sonnet 5.5, de Anthropic, a través del servidor de MonitorEO (no hace falta cuenta ni clave). Solo recibe el texto de la conversación, que va a Anthropic, que no lo usa para entrenar sus modelos (sus condiciones). Si se acaban los créditos de MonitorEO en Anthropic, responde Gemini 3.8 Flash, de Google, que con el nivel de pago de su API tampoco usa la conversación para mejorar sus productos (sus condiciones). Con un modelo de tu ordenador (ver Qué modelo), la conversación no sale de él.
• Tus áreas de estudio se envían a Earth Engine para calcular sobre ellas; el modelo solo ve su nombre.

La ventana lo recuerda en su cabecera, con el proyecto y el modelo que usa. Debajo, una barra dice qué parte de tus EECU de cálculo de Earth Engine de este mes has gastado (con la cuenta compartida, tus research EECUs: 25 EECU-h al mes, solo para investigación) y Check (Consultar) la pregunta otra vez; si te queda menos del 10 %, el asistente lo avisa en la conversación, y cuando se acaban hay que pasar a tu cuenta. Con tu proyecto, elige su nivel en Settings (ver Conceptos).

Instalación

El instalador lo hace todo, sin permisos de administrador ni saber usar una terminal.

1. Cuenta y proyecto de Earth Engine, solo si quieres calcular con los tuyos: ver Primeros pasos. Sin ellos, el asistente usa la cuenta compartida de MonitorEO.

2. Abre el instalador:

   • macOS: abre el Terminal (pulsa Cmd+Espacio, escribe Terminal e Intro), pega esta orden y pulsa Intro:

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/monitoreo-obsnev/monitoreo/main/installer/macos/instalar.sh)"

     Es la única vez que hace falta el Terminal. macOS bloquea los programas sin firmar que se descargan con el navegador, y el instalador no está firmado; lo que descarga esta orden no se bloquea. Paso a paso:

     

   • Windows 10 u 11: descarga asistente-monitoreo-windows.zip, ábrelo y haz doble clic en Install the MonitorEO assistant.bat. Como no está firmado, Windows puede avisar «Windows protegió su PC»: pulsa Más información y Ejecutar de todas formas.

   Se abre una ventana que va contando lo que hace. Descarga e instala Python, Earth Engine, GDAL y MonitorEO en la carpeta MonitorEO de tu usuario (unos 0,2 GB de descarga y 1 GB en disco; en un Mac, un minuto). No hay que escribir nada.

3. Al terminar se abre el asistente en su ventana, y en el Escritorio queda MonitorEO Assistant (una app en macOS, un acceso directo en Windows) para abrirlo otra vez con doble clic, sin Terminal ni consola. La ventana del instalador ya se puede cerrar. Para cerrar el asistente, cierra su ventana (o, en macOS, Cmd+Q): se cierra también el motor de los modelos. Si está calculando, antes pregunta, porque el cálculo se perdería.

4. En Settings (Configuración), la primera vez:

   • Earth Engine account: sin hacer nada, el asistente calcula con la cuenta compartida de MonitorEO. Para calcular con la tuya (y exportar a Google Drive), pulsa Use my Google account, que abre el navegador para iniciar sesión como earthengine authenticate (una vez por ordenador; vale también para QGIS, Python, R y el MCP), y escribe en Your project (optional) el de tu cuenta registrado en Earth Engine (el que ves arriba a la derecha en el Code Editor), con Save. Para volver a la cuenta compartida, deja el proyecto vacío y pulsa Save. Con tu cuenta, Change account inicia sesión con otra y Log out cierra la sesión de tu cuenta de Google en Earth Engine en este ordenador (revoca su permiso y borra sus credenciales, también para QGIS, Python, R, la línea de comandos y earthengine): el asistente vuelve a la cuenta compartida.
   • Language model: pulsa Install. El asistente descarga el modelo (qwen3:8b, unos 5 GB) y el motor que lo hace funcionar, Ollama (0,2 GB en macOS y 1,5 GB en Windows y Linux).

   Cuando está todo, Settings se pliega y dice «· all ready». Se guarda en ~/MonitorEO/assistant.json.

La primera vez hay que descargar unos 5 GB (5,4 GB en macOS y 6,7 GB en Windows y Linux, con el motor), así que conviene una buena conexión. Solo ocurre la primera vez: después el asistente arranca sin descargar nada, salvo las actualizaciones de MonitorEO, que son pequeñas.

Si no funciona así

• macOS, sin Terminal: descarga asistente-monitoreo-macos.zip, ábrelo y haz doble clic en Install the MonitorEO assistant.command. macOS no lo deja abrir la primera vez («Apple no ha podido verificar…»): pulsa Hecho, ve a Ajustes del Sistema > Privacidad y seguridad, baja hasta el aviso del instalador y pulsa Abrir igualmente, que pide la contraseña de un administrador del Mac.

• Windows, si el ordenador no deja abrir el zip (SmartScreen o una política de tu organización): abre el Símbolo del sistema (menú Inicio, escribe cmd e Intro), pega esta orden y pulsa Intro:

  curl -fsSLo "%TEMP%\instalar-monitoreo.bat" https://raw.githubusercontent.com/monitoreo-obsnev/monitoreo/main/installer/windows/instalar.bat && "%TEMP%\instalar-monitoreo.bat"

Qué instala y dónde

Todo queda en tu carpeta de usuario, sin tocar el sistema:

Carpeta	Qué es
MonitorEO/entorno	Python, Earth Engine, GDAL y MonitorEO (lo instala el instalador, con micromamba)
MonitorEO/micromamba	El programa que instala los paquetes de conda-forge
MonitorEO/ollama	El motor de los modelos de tu ordenador, si eliges uno y no tenías Ollama
MonitorEO/wiki	Este manual, para responder preguntas (se actualiza cada día)
.ollama/models	Los modelos de lenguaje de tu ordenador, si eliges uno (unos 5 GB)
MonitorEO	Además: la configuración (assistant.json), tus áreas de estudio (capas), los informes (informes) y los resultados

Para desinstalarlo, borra MonitorEO/entorno, MonitorEO/micromamba, MonitorEO/ollama y .ollama, y MonitorEO Assistant del Escritorio (Asistente de MonitorEO, si viene de una versión anterior; al reinstalar se sustituye; los resultados, las capas y los informes están en el resto de MonitorEO). Para instalarlo de nuevo, borra MonitorEO/entorno y abre otra vez el instalador.

Con el entorno de conda

Si ya tienes el entorno de MonitorEO (Primeros pasos), no necesitas el instalador:

conda activate monitoreo
monitoreo assistant

Se abre en su ventana (con pywebview, que va en el entorno); si el ordenador no puede abrirla, en el navegador. Para cerrarlo, cierra la ventana o pulsa Ctrl+C en la terminal; en el navegador, con Close the assistant, arriba a la derecha (cerrar la pestaña no lo cierra).

Qué modelo

En Settings, Language model tiene dos opciones:

• The model of MonitorEO, in the cloud (el modelo de MonitorEO, en la nube), por defecto: Claude Sonnet 5.5, a través del servidor de MonitorEO. No hay que instalar ni descargar nada, pero necesita conexión. Se eligió en noviembre de 2026 comparando varios modelos con preguntas típicas del asistente: acertó en casi todas y es rápido. Cada usuario puede hacerle hasta 400 consultas al día (un mensaje son de 1 a 8 consultas).
• A model on this computer (Ollama): answers worse (un modelo de tu ordenador, responde peor): un modelo abierto que funciona en tu ordenador, para quien prefiera que la conversación no salga de él o trabaje sin conexión. Los modelos que caben en un ordenador son mucho más pequeños y se equivocan más: eligen mal la variable, el lugar o las fechas, o piden permiso para lo que podrían hacer. Si lo usas, comprueba siempre How it is computed en cada resultado.

La cabecera de la ventana dice qué modelo responde. Los modelos de la nube tienen además instrucciones más largas: dan explicaciones paso a paso de cómo usar el asistente y de los conceptos de teledetección, con más apartados de este manual.

El motor de los modelos de tu ordenador (Ollama)

Solo si eliges un modelo de tu ordenador. El asistente usa Ollama, un programa abierto que hace funcionar modelos de lenguaje en el ordenador:

• Si ya tienes Ollama instalado (su aplicación, abierta o no), usa ese y sus modelos.
• Si no, Install descarga la versión oficial de Ollama de GitHub, comprueba que es la publicada (su SHA-256) y la guarda en ~/MonitorEO/ollama, sin permisos de administrador ni instalar nada en el sistema. El asistente la arranca al abrirse y la para al cerrarse.

Los modelos se guardan donde los guarda Ollama (~/.ollama/models), así que también los aprovecha una aplicación de Ollama que instales más adelante. La versión de Ollama la fija MonitorEO y se actualiza con él.

Los modelos de tu ordenador

Con A model on this computer (Ollama), el desplegable Model on this computer tiene los tres modelos recomendados, con su tamaño; qwen3:8b (recommended) es el primero. Los que ya están en tu ordenador llevan ✓ downloaded, y debajo se avisa de que no hay que descargar nada. Si el modelo elegido no está descargado pero otro de la lista sí, el asistente usa ese al abrirse. Para otro modelo de Ollama que use herramientas, escribe su nombre en la caja de al lado y pulsa Download (o Install, la primera vez).

Modelo	Descarga	Comentario
qwen3:8b	5 GB	Por defecto. Probado: unos 4 s por respuesta en un Mac M3 Pro de 18 GB (la primera, unos 20 s, mientras carga el modelo)
qwen3:4b	2,5 GB	Más rápido y con menos memoria; se equivoca más (sin probar)
gpt-oss:20b	14 GB	Para ordenadores con 16 GB o más de memoria libre (sin probar)

Conviene un ordenador con 16 GB de memoria para qwen3:8b.

Ollama en un servidor

Si Ollama funciona en otro ordenador (por ejemplo, un servidor de tu organización, para no descargar los modelos en cada ordenador), cambia "ollama": "auto" en ~/MonitorEO/assistant.json por su dirección, p. ej. "ollama": "http://servidor:11434". El texto de la conversación viaja entonces a ese servidor; los cálculos siguen haciéndose en Earth Engine, con la cuenta compartida o con la tuya.

Siempre la última versión

Como monitoreo mcp, al arrancar monitoreo assistant comprueba si hay una versión más reciente en GitHub y, si la hay, la instala y arranca con ella; mientras tanto (un minuto) se ve una ventanita Updating MonitorEO…. Sin conexión, arranca con la instalada.

Mientras está abierto, lo comprueba también cada 6 horas: si sale una versión nueva, aparece arriba el botón Update MonitorEO. Al pulsarlo, la instala y el asistente se reinicia solo (en un minuto: su ventana se cierra y se vuelve a abrir). Se pierde la conversación, pero no los resultados, las capas ni los informes, que están en la carpeta MonitorEO.

monitoreo assistant --no-update     # sin comprobar la versión
monitoreo assistant --port 8800     # en otro puerto (por defecto, 8765)
monitoreo assistant --browser       # en el navegador, en vez de en su ventana
monitoreo assistant --no-browser    # sin abrir ni la ventana ni el navegador (solo el servidor)

Si ya está abierto, monitoreo assistant (o el doble clic en el Escritorio) no arranca otro: muestra el que está abierto.

Uso

La ventana tiene dos partes: a la izquierda, la conversación; a la derecha, los resultados, con el mapa arriba. En una ventana estrecha, las dos partes van en pestañas (Conversation y Results).

Escribe en la caja de abajo (Enter para enviar, Shift+Enter para otra línea) o pulsa uno de los ejemplos. Más ejemplos:

• "¿Qué sensor me conviene para seguir la vegetación de una finca pequeña desde 2015?" (consejo, sin calcular)
• "Serie anual del NDVI de Sentinel-2 en el Parque Nacional de Sierra Nevada de 2019 a 2024"
• "Compara los veranos de 2023 a 2025 con los de 2018 a 2022 en Doñana con el NDVI"
• "Mapa de la mediana del NDVI del verano de 2024 en el área de estudio parcelas"
• "Descarga en GeoTIFF la mediana del NDVI de Sentinel-2 del verano de 2024 en el área de estudio parcelas" (para abrirlo en QGIS u otro SIG)
• "Exporta a mi Google Drive el NDVI de Sentinel-2 de 2023 del Parque Natural de Sierra Nevada" y, más tarde, "¿Ha terminado la exportación?" (para regiones grandes a resolución completa)
• "Tendencia anual de la temperatura de superficie de MODIS de 2005 a 2024 en el Parque Natural de Cazorla"

Cuanto más concreta la petición (variable, sensor, lugar y fechas), mejor. Si falta algo, el asistente propone una opción y pregunta.

Preguntas sobre MonitorEO

También responde preguntas sobre la herramienta con este manual, que descarga de GitHub (y guarda en MonitorEO/wiki para usarlo sin conexión): "¿Qué es el NDVI?", "¿Cada cuánto hay imágenes de Sentinel-2 y cuál es su resolución?", "¿Qué filtros de nubes se aplican?", "¿Cómo cito MonitorEO?". Debajo de la respuesta salen los apartados del manual de los que la ha sacado (From the manual: …), con su enlace.

Si pides algo que el asistente no hace, te dice qué herramienta de MonitorEO lo hace, con su manual: cálculos que se repiten solos o de muchas regiones a la vez, el paquete de Python o la línea de comandos; editar capas o hacer mapas para imprimir, el plugin de QGIS; trabajar en R, el paquete de R; usarlo sin instalar nada, la app de Earth Engine; publicar informes, el visor de resultados.

Espacios protegidos

El asistente busca el espacio por su nombre en la base de datos mundial de áreas protegidas (WDPA) y te muestra la lista: un mismo lugar suele tener varias figuras con límites distintos (Parque Nacional, Parque Natural, ZEC, ZEPA, sitio Ramsar...). La que coincide con lo que has pedido sale la primera y resaltada, y es la que se usa. Para calcular con otra, púlsala: el asistente repite el cálculo con ella. Si lo pulsas mientras calcula, lo hace al terminar.

Si el modelo se equivoca de identificador (se lo inventa o copia uno), el asistente busca él mismo el lugar que has nombrado y, si solo uno coincide con la designación que has pedido ("el Parque Nacional de Sierra Nevada"), calcula con ese; si no, te enseña la lista para que elijas.

Tu área de estudio

Para calcular sobre tus polígonos (fincas, parcelas, zonas de gestión...), pulsa Upload study area o arrastra el archivo a la página. Valen un GeoPackage, un GeoJSON, un KML o un shapefile comprimido en .zip, en cualquier sistema de coordenadas. El asistente comprueba la capa y dice cuántos polígonos tiene y su superficie; después aparece bajo la cabecera, en Study areas, con su nombre (la × la quita), y puedes pedir cálculos sobre ella: "Serie anual del NDVI en el área de estudio parcelas desde 2018".

Cada polígono da su propia serie o fila de la tabla. Si la capa tiene un campo con un nombre distinto para cada polígono (nombre, name, id...), se usa para etiquetarlos. Las áreas de estudio se copian a ~/MonitorEO/capas y siguen ahí la próxima vez.

Resultados

Cada resultado sale en una tarjeta: la gráfica o el mapa (con su leyenda), la tabla (sus 6 primeras filas; See the N rows las muestra todas), See on the map, How it is computed (región, variable, sensor, periodo, métricas, filtros y método) y Download CSV o Download TIF. Los GeoTIFF (float32, NoData -9999, en la proyección UTM de la región) se guardan también en la carpeta MonitorEO, con una vista previa del mapa en la tarjeta y en el informe. Las regiones grandes se descargan con píxeles más grandes (pídelo: "a 100 m") o se exportan a Google Drive. Revisa How it is computed antes de usar un resultado: es lo que se ha calculado de verdad, aunque el modelo diga otra cosa.

Mapas

Los mapas que sirve Earth Engine se ven en grande arriba de los resultados, con zoom y desplazamiento: el de un mapa que hayas pedido (de una variable, de tendencia o de la comparación de dos periodos) y, con cada serie, estadística o comparación sobre una región, el de la mediana de la variable en su periodo, que el asistente pide a Earth Engine al terminar el resultado (tarda unos segundos). Si el periodo es de más de un año, este mapa es el de su último año (la mediana de varios años de imágenes tarda minutos en dibujarse), con la escala de colores fija de la variable; el de unas estadísticas es el mapa del que se han calculado. Con una tendencia (Mann-Kendall y Sen), el mapa es el de la tendencia en cada píxel: la pendiente de Sen por año (en verde, sube; en rojo, baja), con una escala fija de ±2 % del rango de la variable por año. Una tendencia sobre un área sale siempre completa, aunque pidas solo la de cada píxel: la tabla (pendiente de Sen, τ de Kendall y p-valor de cada mes o parte del año, para toda el área), su gráfica y el mapa de cada píxel. Si hay varios mapas, se elige en Map (cada uno con el título de su resultado, que lleva el área) o con See on the map en la tarjeta.

En Date se elige el mapa de cada año, mes o periodo de 16 días del resultado: los pasos de una serie (mensual: cada mes; anual: cada año, o cada verano si se pidió una temporada) o, en un mapa de varios años, cada año. El primero de la lista es el del resultado: el valor interanual si se pidió (por ejemplo, la media de las medianas anuales), todo el periodo o su último año. Cada fecha se prepara en Earth Engine al elegirla (unos segundos) y usa la misma escala de colores que el mapa del resultado, para poder compararlas. El valor de un píxel es el de la fecha que se ve, y Add this view to the report guarda esa fecha. En una tendencia de cada mes (o de cada 16 días), en Part of the year se elige la tendencia anual (la de los valores de cada año, la primera) o la de cada mes. En los mapas de tendencia, la casilla Significant pixels only (p < 0.05) deja solo los píxeles cuya tendencia es significativa según la prueba de Mann-Kendall; se mantiene al cambiar de mes y se puede desmarcar en cualquier momento. La vista que se añade al informe es la que se ve, con la casilla marcada o no.

También se elige:

• Base map: Map (OpenStreetMap); Sentinel-2 cloudless (EOX, whole world), el mosaico de Sentinel-2 de 2023 de EOX, que sirve de ortofoto fuera de España (hasta unos 10 m de píxel; licencia CC BY-NC-SA 4.0, de uso no comercial, con su cita, que va en el mapa y en el informe); u PNOA orthophoto (Spain only), del IGN, más detallada.
• Opacity del mapa de Earth Engine sobre el fondo.

Para consultar un píxel, pulsa Query pixel (el cursor pasa a ser una flecha) y pincha en el mapa: sale el valor del píxel en ese mapa (en uno de tendencia, su pendiente de Sen y su p-valor) y la serie temporal de ese píxel (con el paso de la serie del resultado; en un mapa, de 16 días, mensual o anual según el periodo), calculados en Google Earth Engine con tu cuenta. Vuelve a pulsar el botón para terminar y mover el mapa sin consultar. Keep the series as a result la añade a los resultados, para el informe.

Add this view to the report guarda lo que se ve (el encuadre, el fondo, la opacidad y el píxel marcado) como un resultado más, con la leyenda y los créditos del fondo. Los mapas de Earth Engine caducan a las pocas horas; el asistente los pide otra vez solo.

Informe

Create report reúne los resultados marcados con In the report (también las vistas del mapa y las series de un píxel que hayas guardado): pide un título, lo guarda en ~/MonitorEO/informes y lo abre en el navegador. Es un solo archivo HTML, con las gráficas y los mapas dentro, que se puede mover, enviar o abrir sin conexión. Para el PDF: Print or save as PDF y, como destino, Guardar como PDF (desactiva «Encabezados y pies de página» en las opciones del diálogo del navegador).

Cada resultado lleva su ficha (cómo se calculó), la gráfica o el mapa y la llamada de Python que lo reproduce. La tabla de valores solo va si marcas Table in the report en su tarjeta (las largas, en un anexo al final); los valores están siempre en el CSV. Al final van la cita de MonitorEO, la financiación y los logos. El informe no tiene ningún texto del modelo ni interpretación de los resultados.

New request empieza otra conversación. Los archivos de los resultados se quedan en ~/MonitorEO.

Con --browser, si cierras la pestaña o el navegador mientras calcula, el cálculo sigue: al abrir el asistente otra vez, la página muestra toda la conversación, con lo que esté en marcha y los resultados que hayan llegado mientras tanto. En su ventana, cerrarla cierra el asistente (si está calculando, antes pregunta).

Límites

• El modelo puede equivocarse, sobre todo los de tu ordenador, que son pequeños: lee mal una lista, pide permiso para algo que podría hacer, nombra mal el área en su respuesta o se alarga. Por eso los resultados se comprueban en su ficha, la app no deja calcular con un identificador de área protegida que no haya salido de la búsqueda (o que no hayas escrito tú): busca el lugar que has nombrado. Los enlaces al manual que no existen se cambian por el apartado que responde a la pregunta.
• Las exportaciones a Google Drive van al Drive de tu cuenta de Earth Engine, así que necesitan tu cuenta y tu proyecto (con la cuenta compartida no se puede): el asistente dice cuándo terminan, pero los ficheros se abren desde Drive. Publicar en el visor de resultados es solo para sus administradores, con el MCP o Python.
• El modelo de MonitorEO necesita conexión y tiene un límite de consultas al día por usuario; sin conexión, o si lo alcanzas, usa un modelo de tu ordenador.
• Una consulta a la vez. Las series largas sobre áreas grandes tardan minutos: pide paso mensual o anual.
• Solo en tu ordenador: el asistente solo responde en 127.0.0.1 y con la clave de la dirección que abre su ventana.

Si algo falla, ver Problemas frecuentes.