arquitectura

la red agéntica de altiro

Seis agentes, un orquestador determinista, tres tipos de memoria y un harness que los sujeta. Todo construido para que el almacenero sólo tenga que hablar, y para que la cadena completa gane algo en cada conversación.

capa agéntica nativa

No somos otra app de pedidos: somos la capa que hace hablar a las que ya existen

BEES supera los 3,7 millones de compradores mensuales y ya abrió su marketplace a terceros como Kraft Heinz. miAndina y el portal de Embonor tienen su base instalada. Ese trabajo está hecho y no se compite: se orquesta. altiro es la capa de inteligencia que se sienta encima, lee lo que pasa en cada sistema y coordina la decisión que ninguno toma solo.

Cada portal sabe lo suyo. Nadie mira el negocio completo del almacén. Esa silla está vacía.

BEES · AB InBev

ya hace · Catálogo, pedido B2B, promociones y crédito de la cervecería. Marketplace abierto a terceros.

no hace · No sabe qué pasa con las otras tres marcas del local, ni cuánto se vendió al vecino.

altiro · Leemos el pedido y el estado, y lo cruzamos con el resto del surtido para armar el mix real del local.

miAndina · Coca-Cola Andina

ya hace · Pedido web y app, historial y beneficios del cliente Andina.

no hace · Monomarca: no consolida ni conversa. El almacenero entra a pedir, no a decidir.

altiro · Entramos por WhatsApp, armamos la decisión hablando y depositamos el pedido en su portal.

Portal Embonor · Nutrisco

ya hace · Toma de pedido y lista de precios por territorio.

no hace · No anticipa quiebres ni vencimientos, ni conoce la caja del almacén.

altiro · Sumamos anticipación: avisamos antes del corte, con la cantidad ya calculada.

POS y boleta electrónica (Bsale, Toteat, Defontana)

ya hace · Registra la venta al vecino y emite documento.

no hace · Ese dato muere en el reporte: no vuelve nunca a la decisión de compra.

altiro · Leemos sell-out real y con eso calculamos reposición y margen por producto.

WhatsApp Business

ya hace · Es el canal donde el almacenero ya vive y donde de verdad responde.

no hace · Sin agente es sólo un buzón: nadie ordena ni cierra.

altiro · Es nuestra puerta de entrada; ahí ocurre toda la conversación.

Cuaderno, fiado y planilla

ya hace · Sigue siendo el sistema real de la mayoría del canal.

no hace · Nada es consultable ni proyectable.

altiro · Lo digitalizamos hablando, sin pedirle que cambie de hábito.

cómo nos conectamos

API o marketplace del sponsor

Cuando la marca abre acceso, como ya hace BEES con partners.

Pedido, catálogo, precio y estado en tiempo real. Ida y vuelta completa.

Archivo de ruta

Catálogo, lista de precios y maestro de clientes por Excel o CSV diario.

Suficiente para operar el piloto completo sin tocar sistemas core.

Depósito asistido

No hay API disponible y el portal es la única vía.

El agente arma el pedido y lo deja listo para confirmar en el portal del sponsor.

Lectura de venta

El local tiene POS o boleta electrónica.

Sell-out por SKU, la señal más valiosa y la que hoy nadie captura.

Canal conversacional

Siempre. Es el default.

WhatsApp Business API: audio, texto y confirmación con registro escrito.

lo que no hacemos

· No duplicamos el pedido: si el sponsor tiene portal, el pedido termina ahí. La capa aporta la decisión, no otro checkout.
· No pedimos exclusividad de datos: cada marca ve lo suyo, agregado y por territorio.
· No exigimos integración a sistemas core para partir: con catálogo, precios y WhatsApp arrancamos.
· No competimos con la inversión digital del sponsor: la potenciamos con el tramo que hoy no cubre.

centro de comando

Seis bloques de decisión que hoy ningún sistema toma solo

Cada portal ve su propia marca. El centro de comando lee todos los flujos a la vez y decide lo único que le importa al almacenero: qué comprar, cuándo y con qué plata.

Estado del local

lee · Pedidos de las cuatro marcas, stock estimado, deuda, ventana de ruta y venta al vecino.

decide · Qué falta hoy y qué va a faltar antes de la próxima visita.

Mix multimarca

lee · Rotación por categoría, margen por producto y mínimos de cada distribuidor.

decide · Cómo repartir la plata disponible del almacén entre las marcas, no dentro de una sola.

Calendario de cortes

lee · Hora de corte y día de visita de cada distribuidor del territorio.

decide · A qué hora avisar y en qué orden cerrar cada pedido para que todo llegue la misma semana.

Riesgo operativo

lee · Vencimientos, temperatura del cooler, quiebres declarados e incidencias de entrega.

decide · Qué alerta se manda, a quién, y qué acción propone junto a la alerta.

Demanda del vecino

lee · Pedidos B2C, búsquedas sin resultado y recetas pedidas en el barrio.

decide · Qué debería estar comprando el almacén y hoy no compra.

Evidencia

lee · Todo lo anterior contra el grupo de control del mismo barrio.

decide · Qué se le reporta a la marca: efecto real, sin datos personales.

agente de compras · b2c

Un agente de compras para el vecino, con el almacén siempre en la ecuación

El vecino no quiere navegar cinco apps: quiere resolver la once del domingo. El agente de compras recibe la intención, la traduce en canasta y la resuelve en la cadena que mejor le sirve, empezando siempre por el almacén que la tiene hoy y a la vuelta de la esquina.

Intención

“Necesito para un asado el sábado, seis personas.” No es una lista: es un plan.

Canasta

El agente arma la canasta completa: carbón, bebidas, hielo, pan y lo que se olvida siempre.

Ruteo por cadena

Consulta qué tiene el almacén del barrio hoy y qué habría que traer de otra cadena. Prioriza cercanía y disponibilidad real.

Coordinación

Divide la canasta: lo de la esquina se retira en 10 minutos, lo que falta se encarga al almacén para la visita de mañana.

Cierre

Un solo pago, una sola confirmación, y el almacén recibe el pedido en su chat con nombre y hora de retiro.

Vuelta

La compra se guarda: la próxima vez el agente propone la canasta corregida por lo que sobró o faltó.

reglas de ruteo entre cadenas

· El almacén del barrio tiene prioridad si tiene el producto hoy: cercanía y margen local antes que catálogo grande.
· Si al almacén le falta algo, el agente se lo ofrece a él como reposición antes de mandar al vecino a otra cadena.
· Nunca se parte una canasta en más de dos orígenes: más de eso deja de ser conveniencia.
· El precio mostrado es el precio del local, sin sobrecargo del agente.
· Productos con restricción de edad requieren verificación antes de sumarse a la canasta.

qué ve cada parte

Vecino

ve · Una conversación, una canasta y una hora de retiro.

recibe · Aviso cuando su pedido está listo y sugerencia de receta con lo que compró.

Almacén

ve · El pedido del vecino en su mismo chat, con nombre, monto y hora.

recibe · Alerta de reposición cuando un producto se pide y él no lo tiene.

Otra cadena

ve · Un pedido normal, encargado por el almacén o por el vecino.

recibe · Nada distinto: la coordinación ocurre en nuestra capa, no en la suya.

Centro de comando

ve · La demanda insatisfecha del barrio, producto por producto.

recibe · La señal más valiosa del sistema: lo que el barrio pide y el canal no está surtiendo.

whatsapp + app

WhatsApp no es un canal aparte: es la misma conversación

El almacenero puede seguir pidiendo por WhatsApp toda la vida. Cuando abra la app, encuentra el mismo pedido, el mismo historial y el mismo agente. Un solo hilo, dos puertas.

· El pedido es único: lo que se arma por audio se ve y se edita en la app, y viceversa.
· El agente responde en el canal donde le hablaron; no obliga a migrar.
· La app agrega lo que el chat no puede mostrar bien: bodega, márgenes, web del almacén y tablero.
· Nosotros iniciamos conversación sólo cuando hay algo útil: vencimiento, quiebre, frío o corte próximo.

el pedido se arma solo

Aprende el ritmo

Tras cuatro pedidos, el agente ya sabe qué pide, cada cuántos días y en qué cantidad. Deja de preguntar lo obvio.

Arma solo el borrador

Antes del corte de la ruta, prepara el pedido sugerido con el consumo estimado y lo que está por quebrarse.

Pregunta una sola cosa

“Le dejo lo de siempre más dos cajas de bebida que se acaban el viernes. ¿Lo mando?” Una pregunta, no un cuestionario.

Corrige hablando

“Sácame las aguas y súbeme la cerveza a cuatro.” El agente reescribe el pedido y confirma el total.

Confirma y agenda

Cierra el pedido, entrega la fecha de entrega real y agenda el retiro de envases en la misma visita.

reglas antifricción

· Nunca menús numerados: el almacenero habla como habla y el agente entiende.
· Nunca más de una pregunta por mensaje.
· Si falta un dato y existe una respuesta razonable en su historial, se asume y se avisa: “asumí lo de siempre, dígame si no”.
· Los audios se transcriben y se responden en texto corto, para que quede el registro por escrito.
· Si el agente duda dos veces seguidas, entrega el borrador y pasa la conversación al vendedor de ruta.

la red

Un agente por actor, una sola memoria por territorio

No es un chatbot con muchos prompts: son seis agentes con roles distintos, herramientas acotadas, memoria propia y un bucle de trabajo con freno. Cada uno sabe qué puede hacer, qué no, y cuándo devolverle la conversación a un humano.

Almi · almacén

WhatsApp y app altiro

El almacenero

Convertir un audio en un pedido correcto, y anticipar lo que se va a quebrar.

herramientas

buscar_catalogo(texto) — RAG sobre el catálogo del territorio
armar_pedido(items) / editar_pedido(id, cambios)
ver_bodega(local) — stock declarado y consumo estimado
agendar_retiro_envases(pedido)
confirmar_pedido(id) — única acción que escribe en el sistema del distribuidor

recuerda

Qué pide siempre, cada cuántos días, qué marca no vende, cómo habla.

no puede

· Negociar precios o descuentos
· Prometer fechas fuera de la ventana de ruta
· Cerrar un pedido bajo el mínimo sin avisarlo

Almi · vecino

App altiro y web del almacén

El consumidor del barrio

Que el vecino compre en su almacén en vez de ir al súper, y aprenda algo en el camino.

herramientas

buscar_en_almacen(texto) — sólo lo que ese local tiene hoy
receta_o_coctel(ingredientes) — devuelve preparación + carro armado
reservar_retiro(hora) / pedir_despacho()
sumar_puntos(compra)

recuerda

Gustos, restricciones, compras previas, qué recetas probó y cuáles le gustaron.

no puede

· Ofrecer productos sin stock en ese local
· Recomendar alcohol a cuentas sin edad verificada
· Compartir datos de un vecino con otro

Bodeguero

Proceso, sin interfaz propia

Trabaja en silencio para el almacenero

Mantener vivo el inventario del local sin que nadie haga un conteo.

herramientas

estimar_stock(local, sku) — desde compras, ventas y días transcurridos
detectar_quiebre(local) — proyecta qué se acaba antes de la próxima visita
detectar_merma(lote) — cruza fecha de despacho y rotación
proponer_mix(local) — canasta sugerida para el próximo pedido

recuerda

Curva de rotación por SKU y por local, estacionalidad del barrio, lotes despachados.

no puede

· Comprar por su cuenta
· Escribir stock real sin confirmación del almacenero

Ruta

Panel del distribuidor y resumen diario

El distribuidor y su vendedor

Consolidar los pedidos del día por bodega y territorio, y respetar la hora de corte.

herramientas

resolver_territorio(coordenadas) — bodega, días de visita y hora de corte
consolidar_pedidos(corte) — hoja de ruta agrupada
marcar_incidencia(pedido, motivo)

recuerda

Ventanas de entrega, incidencias por local, capacidad por camión.

no puede

· Modificar el pedido de un local
· Saltarse la hora de corte

Marca

Tablero, sin acceso a conversaciones

El sponsor

Convertir la rotación real del punto de venta en decisiones comerciales.

herramientas

sell_out(territorio, periodo)
cobertura_y_quiebres(sku)
comparar_control(activados, control)

recuerda

Series históricas por territorio y por categoría. Nunca datos personales del almacenero ni del vecino.

no puede

· Leer conversaciones individuales
· Ver datos de otra marca
· Contactar directo a un local desde el tablero

Escuela

Dentro del mismo chat, en microdosis

Almacenero y vecino

Educar en el momento exacto en que sirve, nunca como curso aparte.

herramientas

leccion_corta(tema, actor) — 40 segundos, en el contexto de lo que está pasando
sugerir_practica(local) — precio, exhibición, quiebre, manejo de caja
receta_del_momento(clima, fecha, stock)

recuerda

Qué ya aprendió cada actor y qué aplicó de verdad; nunca repetir una lección aceptada.

no puede

· Enviar contenido educativo sin que haya un gatillo real
· Mandar más de una lección por semana a un mismo local

orquestador

Un enrutador determinista decide qué agente responde. No es un modelo eligiendo al azar: es una regla legible.

· Mensaje entrante de un número registrado como local → Almi · almacén.
· Mensaje desde la app de un vecino → Almi · vecino, acotado al catálogo de su almacén.
· Intención de precio especial, reclamo o riesgo → escalamiento a humano, con la conversación completa adjunta.
· Eventos del sistema (corte, vencimiento, frío) → Bodeguero y Escuela publican en el chat, nunca al revés.
· Ningún agente puede llamar a otro más de dos veces en un mismo turno.

harness y bucle

El modelo es el cerebro; el harness es lo que lo hace confiable

Seis capas envuelven a cada agente. Ninguna de ellas depende de que el modelo se porte bien: son contratos, validaciones y frenos escritos en código.

Contrato del agente

Cada agente declara su rol, sus herramientas, lo que no puede hacer y su formato de salida. Si el modelo pide algo fuera del contrato, la llamada se rechaza antes de ejecutarse.

Herramientas tipadas

Toda acción pasa por una función con esquema validado. El agente nunca escribe en la base directamente ni inventa un SKU: si no está en el catálogo, no existe.

Escudo determinista

Precios, mínimos de pedido, ventanas de entrega y reglas de edad los resuelve código, no el modelo. El agente los comunica; no los decide.

Freno del bucle

Máximo de pasos y de tiempo por turno. Si el agente no converge, entrega lo que tiene y pregunta una sola cosa concreta.

Traza obligatoria

Cada turno queda registrado: qué se recuperó, qué herramienta se llamó, cuánto demoró y qué se respondió. Sin traza no hay mejora ni business case.

Evaluación continua

Set fijo de conversaciones reales que se corren en cada cambio: pedido correcto, precio correcto, tono correcto. Un cambio que baja el set no se publica.

bucle de cada turno

Observa

Normaliza la entrada: audio a texto, texto a intención, y carga el estado del local (pedido abierto, deuda, ventana de entrega).

Recupera

Consulta la memoria vectorial del territorio y del actor: catálogo, historial de compra y hechos aprendidos.

Decide

Elige una sola acción por vuelta. Si faltan datos, pregunta una cosa, la más barata de responder.

Actúa

Ejecuta la herramienta tipada. Todo efecto sobre el pedido o el stock pasa por aquí.

Verifica

Revisa el resultado contra las reglas duras: mínimo, stock, precio vigente, ventana. Si falla, corrige antes de responder.

Aprende

Guarda el hecho nuevo en memoria (qué pidió, qué rechazó, cómo habla) y cierra el turno con la traza.

memoria

Tres memorias, un espacio aislado por comercio

El agente recupera antes de responder. Lo que recupera depende del tipo de memoria, y cada comercio vive en su propio espacio: nunca hay contaminación entre locales ni entre marcas.

Semántica · qué es verdad

Catálogo, precios, formatos, reglas del distribuidor, recetas y lecciones.

dónde vive · Índice vectorial en Pinecone, un namespace por comercio: tenant_<local>.

vigencia · Se reindexa con cada carga de catálogo o cambio de lista de precios.

Episódica · qué pasó

Cada conversación y cada pedido: qué pidió, qué rechazó, qué reclamó, con fecha.

dónde vive · Entidades del sistema (pedidos y trazas) + resumen embebido por local.

vigencia · Detalle completo 12 meses; resumen consolidado permanente.

Procedimental · cómo se hace

El mix que funciona en ese barrio, el tono que ese almacenero prefiere, la hora en que suele pedir.

dónde vive · Perfil vivo del local, reescrito por un agente resumidor cada semana.

vigencia · Se recalcula; nunca crece sin límite.

aislamiento y privacidad

· Un namespace vectorial por comercio: la memoria de un local jamás alimenta la respuesta de otro.
· La marca ve series agregadas por territorio, nunca conversaciones ni identidades.
· El vecino y el almacén tienen espacios separados: el local ve su venta, no el historial personal del vecino.
· Todo dato del vecino se guarda con su consentimiento explícito y se puede borrar a pedido.

fidelización de cadena

Cada actor se queda por una razón distinta

Ningún mensaje sale sin una razón que le haga sentido al que lo recibe. Si no trae plata, ahorro o algo que aprender, no se manda.

Almacenero

Un negocio ordenado sin comprar software: bodega estimada sola, compras sugeridas, caja clara y una web propia.

Cada semana el agente le muestra qué se le iba a quebrar y cuánto se ahorró. El valor es visible, no prometido.

Monedas por pedir el mix sugerido, por evitar un quiebre y por recibir el retiro de envases. Se canjean en el próximo pedido.

Vecino

Compra en su almacén sin llamar, aprende recetas y cócteles con lo que ese local tiene hoy.

El contenido es útil y local: el agente propone con el stock real de la esquina, no con un recetario genérico.

Puntos por compra y por recompra, canjeables en el mismo almacén. La fidelidad se queda en el barrio.

Distribuidor

Pedidos consolidados antes del corte y menos llamadas de última hora.

Cada corte llega con la hoja de ruta armada y las incidencias marcadas.

Menos kilómetros por caja entregada y menos pedidos incompletos.

Marca

Rotación real en el punto de venta, no estimación de panel.

Ve el efecto de cada acción contra un grupo de control.

Financia el onboarding del local a cambio de esa visibilidad.

Almacén conectado

se logra con · Primer pedido por el agente

desbloquea · Bodega estimada y avisos de quiebre

Almacén ordenado

se logra con · 4 semanas pidiendo por el agente

desbloquea · Página web propia del almacén y modo vecino

Almacén que enseña

se logra con · Vecinos activos comprando

desbloquea · Recetario del barrio y promos flash contra merma

Almacén socio

se logra con · 6 meses activo y NPS sobre 50

desbloquea · Condiciones preferentes con el distribuidor y voz en el mix del territorio

addons: el bsale orgánico

Web del almacén

Página pública con el catálogo real del local, generada desde el mismo inventario.

reemplaza · Tener que armar y mantener un sitio o un catálogo en PDF.

Caja y compras

Registro de compras, margen por producto y estado de la caja, hablando nomás.

reemplaza · Planillas y sistemas de punto de venta que el almacenero nunca terminó de configurar.

Puente con lo que ya usa

Se conecta a la app de pedidos, la boleta electrónica o el POS que el local ya tenga para leer ventas.

reemplaza · Doble digitación: el dato entra una vez y sirve para todo.

Modo vecino

Enciende la venta al consumidor del barrio con retiro o despacho.

reemplaza · Depender del delivery de terceros que se lleva el margen.

Escuela

Microlecciones en el chat: exhibición, precio, cócteles, cocina, manejo de merma.

reemplaza · Capacitaciones presenciales que nadie alcanza a tomar.

educación en el momento justo

Cuando llega un producto nuevo

al almacenero · “Póngalo a la altura de los ojos, al lado de la bebida que más vende. Se vende hasta 20% más ahí.”

al vecino · “Llegó ron al almacén de la esquina: le dejo tres cócteles que se hacen con lo que ya tiene en casa.”

Cuando algo está por vencer

al almacenero · “Estos jugos vencen en tres semanas. Ármele un dos por y lo aviso a los vecinos.”

al vecino · “Promo de hoy en su almacén: dos jugos al precio de uno. Le sirve para el postre del fin de semana.”

Cuando cae la venta

al almacenero · “Bajó la cerveza 30% este mes. Puede ser precio: el de la esquina la tiene $200 más barata.”

al vecino · “Se viene calor el finde: pack de cervezas frías reservado para retirar el sábado.”