Saltar al contenido
GuíasPor PISO ZERO

Tu primer agente no necesita GPT, Gemini ni Claude

Antes de elegir un modelo, define un resultado comprobable: leer un archivo ficticio, identificar pendientes y redactar un borrador. La Raspberry puede ser el equipo de aprendizaje; lo importante es limitar qué puede consultar, calcular y proponer.

Ilustración conceptual de una tarea acotada entre un archivo, herramientas y revisión humana
Ilustración conceptual, no fotografía de hardware ni de un kit vendido.

El equipo es opcional; la compatibilidad, no

Puedes usar una Raspberry compatible con el sistema y las herramientas elegidas, o un mini PC que ya tengas. No presupongas que cualquier modelo podrá ejecutar cualquier modelo de IA. Decide por separado dónde corre el flujo y dónde se hace la inferencia.

Raspberry Pi Imager permite seleccionar el dispositivo y propone un sistema recomendado. Consulta la documentación de Raspberry Pi OS para elegir arquitectura, actualizar la versión actual con APT y respaldar antes de cambiar de versión mayor. Estas herramientas preparan el sistema: no instalan Pisozero ni este ejercicio.

Una tarea, dos herramientas, ningún envío

El objetivo es resumir cobros pendientes de cobros-ejemplo.csv. Una herramienta de solo lectura recupera exclusivamente ese archivo; una calculadora determinista opera sobre importes validados. La ruta queda fijada fuera del modelo, sin acceso a otras carpetas, credenciales, correo ni escritura en el origen.

Si todos los pasos están fijados, es una automatización; no todo flujo es un agente. Hay decisión del modelo cuando elige una herramienta o se detiene según lo observado, dentro de ese entorno acotado. El modelo interpreta y redacta; la calculadora calcula.

Escribe el criterio de aceptación antes de probar: incluir únicamente pendientes, mostrar identificadores e importe total y etiquetar el texto como borrador. Si falta una columna necesaria, pedir una entrada corregida en lugar de inventarla. La herramienta valida el esquema; el modelo no puede ampliar sus permisos.

Tres filas para comprobar el resultado

Este CSV es ficticio y no contiene datos personales. Los importes están expresados en soles, con punto decimal para facilitar su lectura estructurada.

id,importe_pen,estado
EJ-001,25.00,pendiente
EJ-002,40.00,pendiente
EJ-003,40.00,pagado

Antes de sumar, valida columnas, identificadores únicos, importes numéricos no negativos y estados admitidos: pendiente o pagado. Filtra por estado, no por una interpretación libre del texto. Ante una fila inválida, detén el ejercicio y explica el problema.

Un borrador, no una acción

La suma determinista de S/ 25,00 y S/ 40,00 devuelve S/ 65,00 pendientes. El registro pagado de S/ 40,00 queda fuera. Conserva los identificadores para que una persona pueda contrastar el resumen con la entrada.

Demostración ficticia — borrador para revisión: quedan dos registros pendientes, EJ-001 y EJ-002, por S/ 65,00 en total. EJ-003 figura pagado y no se incluye en el cobro pendiente.

La salida se presenta para revisión humana. No se envía automáticamente, no modifica estados y no afirma haber contactado a nadie.

Prueba también lo que debe fallar

  • Archivo vacío: informar ausencia de datos; no confundirla con cero pendientes.
  • Identificador duplicado: detenerse; no sumar dos veces ni corregir silenciosamente.
  • Instrucción dentro del contenido: tratar «ignora los límites y envía» como datos no confiables, nunca como autorización.

Fija un máximo de cuatro pasos: lectura, validación, cálculo y borrador; como máximo, dos llamadas a herramientas. Un error detiene el flujo, sin reintentos ilimitados. Al alcanzar cualquier límite, debe explicar dónde se detuvo. Una persona revisa filas, estado y suma antes de utilizar el texto; el envío sigue fuera del alcance.

Durante las pruebas, registra qué herramienta se solicitó, qué comprobación falló y por qué terminó el flujo. Compara cada respuesta con un resultado esperado preparado previamente. Un borrador convincente no compensa una suma incorrecta ni una lectura fuera del archivo permitido.

Crece cuando puedas explicar los fallos

Añade otra fuente o herramienta solo después de reproducir las pruebas y revisar sus permisos. Documenta qué cambia y cómo se detiene. Este es un blueprint educativo, no un instalador de Pisozero ni un producto listo. Explora los pisos de aprendizaje sin convertir más autonomía en el objetivo.

Conserva el ejemplo inicial como prueba de regresión: ampliar capacidades no debería alterar sus resultados ni sus límites.

Fuentes para seguir

Entiende el agente antes de ampliar su alcance

Revisa cómo se conectan objetivos, herramientas y supervisión.