Cómo crear tu primer agente simple con Ollama y una API

Crear un agente simple que actúe por sí mismo es más accesible de lo que parece. Este tutorial te guía paso a paso: un modelo de lenguaje corriendo en tu propio servidor, conectado a una API real para que pueda actuar, no solo responder.

1. Instala Ollama

Ollama es lo que te deja correr un modelo de lenguaje directo en tu servidor, sin depender de una API externa de pago. Instálalo con:

curl -fsSL https://ollama.com/install.sh | sh

Verifica que quedó instalado:

ollama --version

2. Ejecuta un modelo

Ahora vamos a descargar y correr un modelo local por primera vez:

ollama run llama3

La primera vez descarga el modelo (puede tardar según tu conexión); las siguientes veces arranca casi al instante. Ya tienes un modelo de lenguaje corriendo 100% en tu servidor, sin enviar nada a servicios externos.

3. Automatiza con una API simple

Un modelo que solo responde texto es un asistente. Para que sea un agente, necesita poder actuar sobre algo real — en este ejemplo, revisar y reiniciar un servidor por su cuenta.

Este es el patrón mínimo en Python: el agente consulta un estado, decide, y ejecuta una acción real si hace falta.

import requests

def get_status():
    return requests.get("https://mi-servidor.com/status").json()

def restart_server():
    return requests.post("https://mi-servidor.com/restart").json()

status = get_status()
if status["status"] == "down":
    print("Reiniciando el servidor...")
    restart_server()

Este mismo patrón (consultar → decidir → actuar) se puede usar para casi cualquier tarea: revisar espacio en disco, verificar si un servicio sigue corriendo, o vigilar el estado de un ticket de soporte.

4. Automatiza el ciclo completo

Ahora vamos a conectar el modelo con este script, para que sea el modelo el que decida qué hacer, no una regla if fija como en el ejemplo anterior. Crea un script Python que:

1. Llame a Ollama con el prompt (qué está pasando + qué puede hacer el agente).
2. Reciba la decisión del modelo.
3. Ejecute la acción correspondiente con subprocess o una librería como requests.

Para que el agente vigile solo, sin que tengas que correrlo a mano cada vez, agrégalo a un cron que lo ejecute cada 5 minutos:

*/5 * * * * /usr/bin/python3 /ruta/a/tu/agente.py

Y listo: tienes un agente simple, corriendo en tu propio servidor, revisando y actuando solo cada 5 minutos.

Si no tienes todavía dónde correr esto de forma permanente (Ollama y un cron necesitan un servidor prendido 24/7, no tu computador personal), en NAP Latino tenemos VPS y VDS con el control root que necesitas para montar este flujo completo.