US-039 — Sugerencias de parámetros frecuentes

Detalle de la historia¶

Historia¶

Como cliente corporativo de FleteChat con historial de operaciones, quiero que al iniciar una cotización el agente me sugiera los parámetros que repito con frecuencia (rutas, suplidores, receptores), para cotizar más rápido las operaciones habituales sin tener que dictar los mismos datos una y otra vez.

Persona de usuario¶

Aplica a clientes con nivel corporativo activo (ver historia de asignación de nivel) y con historial suficiente de operaciones. No aplica a clientes sin nivel, ni a corporativos recién asignados sin embarques previos: en esos casos el agente sigue el flujo de cotización normal sin sugerir.

Contexto de negocio¶

Un cliente corporativo con flujo estable repite la misma ruta con los mismos proveedores y receptores muchas veces al mes. Hacerle dictar "Miami → Ciudad de Panamá, suplidor ACME, receptor mi bodega" cada vez es fricción innecesaria, y la re-cotización rápida de US-013 sólo ayuda cuando el cliente menciona explícitamente un embarque anterior. La sugerencia proactiva cubre el resto: apenas el agente detecta que se está armando una cotización, ofrece los parámetros que el cliente más usa y pregunta si aplican a este pedido.

El cálculo es simple y por frecuencia: el agente (o un servicio de apoyo) mira los últimos M embarques del cliente, toma los N valores más repetidos por dimensión (origen, destino, suplidor, receptor) y los ofrece como opciones. No se usa ML en v1.0 (ver PR-159): el alcance de v1.0 excluye modelos predictivos por decisión del SOW §2.6.

Diálogo de referencia¶

Cliente corporativo con historial recibe sugerencias¶

Cliente: Necesito cotizar un envío nuevo.

Agente: Claro. Vi que sus últimos envíos fueron Miami → Ciudad de Panamá con el suplidor ACME y receptor Bodega Central. ¿Aplica para éste también o son otros datos?

Cliente: Sí, lo mismo, pero cambia el receptor a Bodega Sur.

Agente: Perfecto. Anotado: Miami → Ciudad de Panamá, suplidor ACME, receptor Bodega Sur. Para armar el precio necesito el peso estimado y la modalidad (LCL, FCL, aéreo).

Cliente corporativo sin historial suficiente¶

Cliente: Necesito cotizar un envío.

Agente: Con gusto. Para armarle la cotización necesito algunos datos: origen, destino, suplidor, receptor, peso y modalidad. Empecemos por el origen.

Cliente rechaza todas las sugerencias¶

Cliente: Cotícame un envío.

Agente: Sus últimos envíos fueron Miami → Ciudad de Panamá con suplidor ACME y receptor Bodega Central. ¿Aplica?

Cliente: Esta vez no, es algo distinto.

Agente: Sin problema. Empecemos de cero: ¿cuál es el origen del envío?

Criterios de aceptación¶

Disponibilidad¶

1. La sugerencia de parámetros frecuentes se activa únicamente cuando el cliente tiene una asignación de nivel corporativo activa a la fecha de la conversación y suficiente historial de embarques, según ventana e umbral de PR-160.
2. Para clientes sin asignación activa o sin historial suficiente, el agente sigue el flujo de cotización normal sin sugerir parámetros frecuentes.

Cálculo y presentación¶

1. El agente calcula las sugerencias a partir de los últimos M embarques del cliente (valor M configurable; ver PR-160). Por cada dimensión relevante (origen, destino, suplidor, receptor) toma los N valores más frecuentes (N configurable).
2. El agente presenta las sugerencias al momento correcto del flujo: cuando detecta intención de cotizar, antes de pedir los datos uno a uno. La presentación combina los top-1 de cada dimensión en una oración legible por WhatsApp.
3. El cliente puede aceptar en bloque ("sí, igual que siempre"), modificar parcialmente ("sí pero el receptor es otro") o rechazar ("no, esta vez es distinto"). El agente adapta el flujo según la respuesta.

Integridad de los datos sugeridos¶

1. Las sugerencias se construyen con datos existentes y vigentes en el sistema: un suplidor desactivado o eliminado se filtra automáticamente y no aparece como sugerencia; una ruta que dejó de existir en el catálogo tampoco.
2. El agente no inventa parámetros: todo lo sugerido proviene del historial real (ver historia de precisión y anti-alucinación).

Sin modelo predictivo¶

1. El cálculo es estadístico por frecuencia: no se entrena ni usa ML para estas sugerencias en v1.0 (ver PR-159).

Edge cases¶

• Cliente corporativo con asignación activa pero historial de embarques debajo del umbral (PR-160). El agente no sugiere parámetros y sigue el flujo normal.
• Empate entre valores más frecuentes (dos suplidores con la misma cantidad de embarques). El agente desempata por el uso más reciente: el que se usó más recientemente aparece como top.
• Cliente rechaza la sugerencia completa y dicta datos nuevos. El agente no insiste; sigue el flujo de cotización estándar con los datos que el cliente proveyó.
• Cliente modifica sólo una dimensión ("todo igual, pero receptor nuevo"). El agente usa las sugerencias aceptadas para las demás dimensiones y pide sólo el dato cambiado.
• Historial con un solo valor dominante (100 embarques siempre con la misma ruta). La sugerencia es contundente y el agente la presenta con confianza; si el cliente la cambia, el agente lo respeta sin preguntar por qué.
• Asignación corporativa recién creada, sin historial aún. No aplican sugerencias hasta que el cliente acumule el mínimo (PR-160).

Tamaño, prioridad y tipo¶

• Tamaño: M
• Prioridad: P2 — mejora notable de experiencia para corporativos recurrentes, pero no bloquea la operación cotidiana.
• Tipo: feature

Premisas¶

La historia está redactada bajo las siguientes premisas. Si alguna cambia, la historia debe revisarse y ajustarse en consecuencia. Todas deben ser confirmadas por el cliente antes de cerrar la historia.

• PR-159 — Sin ML en v1.0. Las sugerencias se calculan por frecuencia estadística sobre el historial del cliente. No se entrena ni se usa un modelo predictivo. Alineado con SOW §2.6. Modelos predictivos quedan para versiones posteriores.
• PR-160 — Ventana, top-N y umbral mínimo parametrizables. La ventana de historial (cantidad de embarques M hacia atrás), el top-N por dimensión y el umbral mínimo de embarques para activar la funcionalidad son parámetros configurables por FleteChat. Valores por defecto sugeridos: M = últimos 6 meses de embarques, N = 1 por dimensión como sugerencia primaria (hasta top-3 disponibles si el cliente pide "otras opciones"), umbral mínimo = 3 embarques en la ventana.
• PR-161 — Sólo para clientes corporativos activos. La funcionalidad se activa únicamente para clientes con asignación de nivel corporativo activa a la fecha de la conversación. Clientes sin asignación (aunque tengan historial) no reciben sugerencias proactivas.

Refinamiento y Definition of Ready¶

Notas¶

Checklist¶

• ✅ Historia escrita en formato Como / Quiero / Para
• ✅ Persona de usuario identificada
• ✅ Contexto de negocio documentado
• ✅ Criterios de aceptación observables y pass/fail
• ✅ Edge cases relevantes listados
• ✅ Tamaño y prioridad asignados
• ⬜ Premisas PR-159 a PR-161 confirmadas por el cliente
• ⬜ Reglas de negocio aplicables aprobadas
• ⬜ Requerimientos funcionales aplicables aprobados
• ⬜ Historia aprobada formalmente por el cliente