Lampson como motor

Receta: tomar pedidos por chat

Un agente que atiende el chat de un negocio y toma el pedido completo: qué y cuánto, envío o retiro, la dirección, el nombre, cómo paga, el resumen, la confirmación y el número de pedido. El pedido queda guardado, el stock baja y el cliente queda registrado para la próxima vez.

Son tres archivos: el plugin orders (viene con Lampson), el catálogo de tu negocio y el agente.

Si en vez de un plugin quieres herramientas propias, con tu base de datos y el cliente sacado del contexto de tu app, mira Receta: un agente de soporte.

1. El plugin orders§

Viene con Lampson en ~/lampson/plugins/orders/. Enciéndelo una vez (/plugins on orders en la terminal, o el pill plugins en la web). Sus herramientas:

Las cuentas las hace el plugin, nunca el modelo: place_order vuelve a calcular todo desde el catálogo, rechaza una forma de pago que no aceptas y no guarda un pedido sin dirección o sin stock.

El plugin trae además sus instrucciones: el proceso para tomar un pedido (cotizar siempre con quote, pedir solo lo que falta, resumir y esperar un «sí» antes de guardar). Por eso el prompt de tu agente no tiene que explicarlo.

2. El catálogo§

.lampson/orders/catalog.json en tu proyecto. Ahí también quedan los pedidos (P-0001.json…) y los clientes (customers.json).

{
  "store": "Panadería Sol",
  "hours": "lunes a sábado de 7 a 20 h; domingos de 8 a 13 h",
  "delivery": {"area": "hasta 5 km del local", "fee": 1500, "free_from": 15000, "eta": "1 a 2 horas"},
  "payment": ["efectivo", "transferencia", "tarjeta de débito"],
  "products": [
    {"sku": "PAN-INT", "name": "Pan integral de masa madre", "price": 3200, "unit": "unidad (700 g)", "stock": 14, "second_half": true},
    {"sku": "PAN-BLA", "name": "Pan blanco de campo", "price": 2400, "stock": 0, "notes": "vuelve mañana a las 7"},
    {"sku": "MED-LUN", "name": "Medialunas de manteca", "price": 900, "stock": 60, "pack": {"qty": 12, "price": 9600}},
    {"sku": "ALF-MAI", "name": "Alfajores de maicena", "price": 700, "stock": 40, "gluten_free": true}
  ],
  "policies": ["No hacemos descuentos fuera de las promos del catálogo."]
}

• pack: precio por cantidad (la docena a $9.600).
• second_half: llevando 2, el segundo a mitad de precio.
• delivery.free_from: envío gratis desde ese subtotal.
• notes, policies y cualquier otro campo (gluten_free, vegan…) los lee el agente tal cual.

3. El agente§

.lampson/agents/tienda.agent.json. Su prompt dice quién es — el proceso lo pone el plugin:

{
  "id": "tienda",
  "description": "Atiende a los clientes de Panadería Sol por chat y toma sus pedidos",
  "base": "none",
  "system": "Eres quien atiende el chat de Panadería Sol, una panadería de barrio en Rosario. Los clientes escriben desde el celular. Tono: cálido, rioplatense (vos), breve. Sin markdown. Precios con punto de miles ($3.200). No hables de archivos ni herramientas.",
  "tools": [{"name": "plugin_orders_*", "approve": "auto"}],
  "permission": "strict",
  "steps": 10
}

"approve": "auto" deja que solo las herramientas de orders corran sin que nadie apruebe; todo lo demás sigue en strict. → Agentes

4. Conectarlo§

lampson channel on telegram      # o Chatwoot para WhatsApp/Instagram → /docs/channels
lampson key add --agent tienda   # o tu app/bot por la API → /docs/api

Una conversación real§

Esta es una conversación de verdad con el agente de arriba (modelo glm-5.3-flash), escribiendo como escribe la gente: varios mensajes seguidos, con pausas de 2 a 6 segundos. Cada mensaje entró por separado y el buzón los juntó.

Lo que quedó guardado:

// .lampson/orders/P-0001.json (resumido)
{"id": "P-0001", "customer": {"name": "Martín Ferreyra"}, "delivery": "delivery",
 "address": "Entre Ríos 845, 2do A (al lado de la farmacia)", "payment": "transferencia",
 "lines": [{"sku": "MED-LUN", "qty": 12, "amount": 9600, "promo": "1 x pack of 12"},
           {"sku": "PAN-INT", "qty": 2, "amount": 4800, "promo": "1 x second at half price"},
           {"sku": "ALF-MAI", "qty": 2, "amount": 1400}],
 "delivery_fee": 0, "total": 15800, "status": "new"}

P-0002 guardó "when": "mañana 2026-10-17 a las 8 h" y la nota de la sorpresa. El stock bajó (integrales 14 → 12, medialunas 60 → 48, alfajores 40 → 38).

Lo que se ve en la conversación:

• Ráfagas → una respuesta. Cada bloque de 2 a 5 mensajes recibió una respuesta que contesta todo. En el quinto, la dirección llegó en cuatro mensajes a lo largo de 24 segundos: los que llegaron mientras el agente trabajaba entraron al mismo turno, y si llegan mientras ya estaba escribiendo la respuesta, Lampson la descarta y responde de nuevo con todo.
• Sin cuentas inventadas. Cada total salió de quote, con la promo del segundo pan, el precio de la docena y el envío gratis desde $15.000.
• Sin stock, una alternativa. El pan blanco tenía stock 0: lo dijo, dijo cuándo vuelve y ofreció opciones.
• Lo que no sabe, no lo inventa. El alias para transferir no está en el catálogo, así que no inventó uno. Agrégalo a policies y lo dará.
• Nada se guarda sin un «sí». Mostró el resumen y esperó la confirmación.
• Tiempos: cada respuesta llegó entre 14 y 25 segundos después del último mensaje del cliente: los 3 segundos que el buzón espera por si sigue escribiendo, más el modelo y las herramientas.

Un cliente que vuelve§

Ana ya había comprado (ese pedido entró desde una tienda web, ver abajo). Vuelve a escribir:

find_customer la encontró por el teléfono, con sus pedidos anteriores.

Sin chat: un pedido que llega de otro sistema§

Las mismas instrucciones del plugin cubren el caso sin persona del otro lado: tu tienda web, un script u otro agente manda el pedido completo por la API y el agente lo verifica y lo guarda.

curl -X POST https://tu-lampson/w/tienda/v1/messages -H "Authorization: Bearer lk_…" \
  -d '{"to": "tienda", "thread": "web:881", "text": "Pedido de la tienda web #881 (ya pagado y confirmado por el cliente). Cliente: Ana Gómez, tel 341 555 0101. Items: 1 x PAN-SG, 6 x ALF-MAI. Retira en el local. Pago: tarjeta de débito. Respondé solo con el número de pedido y el total, o con el problema."}'

{"text": "Pedido P-0003 registrado. Total: $8.300. Retira en el local (Av. Belgrano 1450), pago con tarjeta de débito.", "steps": 3, …}

Cambiar o cancelar un pedido§

Mientras el pedido está "new" (el local no lo empezó), el cliente puede cambiarlo o cancelarlo desde el chat: update_order recibe el carrito completo nuevo, recalcula el total y mueve el stock solo por la diferencia; cancel_order lo deja "cancelled" y devuelve todo el stock. Cada cambio queda en el history del pedido.

Cuando el local lo pasa a otro estado ("preparing", "sent"… editando el status en .lampson/orders/P-NNNN.json), el agente ya no puede tocarlo y se lo dice al cliente.

Una clienta real, con el mismo agente:

Y Martín, cuando el local ya estaba haciendo la torta (P-0002 en "preparing"):

(En la primera conversación de Martín el agente armó un pedido aparte para la torta: todavía no existía update_order. Ahora cambia el pedido existente.)

Límites de hoy§

• El estado de un pedido (preparing, sent…) lo cambia el local a mano en .lampson/orders/: todavía no hay un panel para eso.
• El pago lo coordina el local; el plugin no cobra.
• Para algo distinto (turnos, reservas, presupuestos), copia la carpeta del plugin y cambia sus herramientas y su INSTRUCTIONS.md: el mismo patrón sirve para cualquier proceso.