El reto
Para cada mensaje de un productor, su sistema decide si es un reporte de plaga y qué plaga es. Si abre un caso, calcula su semáforo, le asigna un técnico y revisa si hay brote. Los casos rojos y naranjas y los brotes se le avisan al coordinador por Telegram.
El agente de IA interpreta el mensaje: si es reporte, qué plaga y qué parte de la parcela está afectada. Las reglas, en código y sin IA, calculan el semáforo (severidad + superficie + etapa), eligen al técnico (especialidad, carga y el más cercano) y detectan brotes (3 o más casos de la misma plaga a menos de 5 km en 7 días). Cada acierto suma 1 punto y cada error resta 1; no arriesgarse no resta. A lo que ya registraron le pueden agregar los campos que le falten. Los detalles están en las reglas.
Así se califica un mensaje
Un ejemplo ficticio de punta a punta: cómo llega un mensaje, qué decide su sistema y cómo lo compara la API. Cómo lo interpreta su agente lo deciden ustedes.
Sus tres accesos
Su servidor en internet
Una computadora en la nube solo para su equipo, encendida toda la semana. Ahí corre su sistema (el agente que lee los mensajes y avisa por Telegram), y está la carpeta /campo con reportes de ejemplo. Se entra desde la terminal con SSH (NN es el número de su equipo):
ssh -p 22NN equipoNN@179-236-73-82.sslip.io contraseña: al tomar su equipo
La primera vez pregunta si confían en el servidor: escriban yes. Ya dentro, el comando estado muestra cómo va todo.
Espacio para su aplicación
Su servidor tiene una carpeta para aplicaciones (~/app). Lo que pongan a correr ahí en el puerto 3000 se ve en su link, y cualquiera lo puede abrir en el navegador. No es requisito del hackathon: en clase vemos cómo desplegar una aplicación ahí.
https://equipoNN.179-236-73-82.sslip.io
La API del hackathon y su token
La API simula a los productores de la junta. De ahí salen sus mensajes (texto, notas de voz y fotos) y ahí se registra el resultado de cada uno, que da puntos en la tabla de posiciones. El token identifica a su equipo: va en el encabezado X-Equipo-Token de cada solicitud.
https://itg.tailf75570.ts.net token: al tomar su equipo
En su servidor ya están configurados como $API_HACKATHON y $TOKEN_EQUIPO. En su computadora, guarden el token en .env, nunca en el código.
Enlaces
Lo que crea cada equipo
| Su repositorio en GitHub | Uno por equipo, creado por ustedes, con todo el código de su sistema. Los dos integrantes hacen commits. ya |
| Bot de Telegram | Se crea con @BotFather. Su token va en .env. martes |
| Llave de OpenRouter | Para usar los modelos de IA. Se las entregamos nosotros. martes |
| Base de datos | Opcional, para guardar sus resultados; por ejemplo, un proyecto de Supabase. |
Cómo empezar
- Tomen su equipo y guarden sus accesos. Si pierden la contraseña del servidor, la recuperan con su token en
GET /equipo. - Creen su propio repositorio en GitHub para el proyecto y regístrenlo con
PATCH /equipoy el cuerpo{"repo": "https://github.com/…"}. - Prueben la API en /docs con su token:
GET /reportespara ver los mensajes yGET /plagaspara el catálogo. - Prueben sus reglas con
GET /casos-previos: son casos de la semana pasada con su prioridad, su semáforo, su técnico y su brote correctos. Si su código da lo mismo, va bien. Esos casos también cuentan para los brotes de esta semana. - Ya están llegando mensajes en
GET /reportes(desde el lunes a las 17:00). Para cada uno registran una sola vez su resultado enPOST /casos, y un error resta puntos. Antes, prueben su código con/casos/validar: revisa que el formato esté bien sin registrar nada ni decirles si acertaron.curl -X POST https://itg.tailf75570.ts.net/casos/validar \ -H "X-Equipo-Token: SU_TOKEN" -H "Content-Type: application/json" \ -d '{"reporte_id": "R-2001", "es_plaga": true, "plaga": "gusano_cogollero", "semaforo": "amarillo", "tecnico_id": "T-03", "brote": false}'
Fechas
| Lun 19 · 17:00 | Abre el hackathon y empiezan a llegar los mensajes. Sesión 1 del curso: Git y GitHub. |
| Mar 20 · 17:00 | Sesión 2 del curso: servidores, despliegue y agentes de IA. |
| Mar 20 · noche | Empieza el nivel 2: cada caso lleva su semáforo, su técnico y si hay brote. |
| Jue 22 · 23:59 | Cierre: la API deja de aceptar resultados y se revisa el último commit de su repositorio. |
| Vie 23 | Demostraciones, preguntas a cada integrante, un mensaje urgente en vivo y premiación. |
