US-059 — Precisión y anti-alucinación

Detalle de la historia¶

Historia¶

Como cliente de FleteChat, quiero la certeza de que FleteChat nunca inventa precios, servicios, tiempos de tránsito ni datos de mis operaciones, y que solo responde con información real del sistema, para poder confiar en lo que me dice y tomar decisiones basadas en sus respuestas.

Persona de usuario¶

Aplica a todo cliente del servicio logístico que recibe información numérica o factual de FleteChat: precios, tiempos de tránsito, servicios aplicables, estatus de embarques, historial de cotizaciones. También protege a FleteChat, que queda comercialmente expuesto si el agente promete algo que no existe.

Contexto de negocio¶

FleteChat se construye sobre un modelo de lenguaje que, sin barandillas, puede generar respuestas plausibles pero incorrectas: un precio inventado, un tiempo de tránsito redondeado de memoria, un servicio que no existe en el catálogo. En un negocio de logística, ese tipo de error no es un detalle de UX: compromete una cotización, abre una disputa comercial, pone a FleteChat en incumplimiento.

Esta historia fija la promesa de que FleteChat responde solo con datos reales y trazables, y establece qué hace cuando no los tiene. Es una restricción transversal: aplica a toda respuesta que el agente da al cliente, en toda historia de todos los epics.

Diálogo de referencia¶

Precio solicitado sin datos en sistema¶

Cliente: ¿Cuánto me cuesta un contenedor de 40 pies desde Shanghái a Manzanillo?

Agente: Para darle un precio necesito consultar la tarifa vigente. Un momento por favor… Listo: la tarifa base para un FCL 40' Shanghái–Manzanillo es de USD 2 480, vigente hasta el 30 de abril. ¿Quiere que le arme la cotización con los cargos aplicables?

Cliente pide una estimación que FleteChat no tiene¶

Cliente: Más o menos, ¿cuánto tardaría?

Agente: Prefiero no darle un estimado "más o menos". Si me confirma el origen y destino exacto consulto el tiempo de tránsito registrado y se lo paso tal cual.

Cliente afirma un dato incorrecto¶

Cliente: Mi cotización era de $1 200.

Agente: Revisé su última cotización C87 y figura por USD 1 480. ¿Puede ser que esté pensando en otra? Si me da más detalles la busco.

Criterios de aceptación¶

Datos que solo vienen del sistema¶

1. Los precios, cargos y totales que FleteChat menciona provienen del motor de tarifas del sistema; FleteChat no los redondea, promedia ni estima.
2. Los tiempos de tránsito que FleteChat menciona provienen de valores registrados en sistema para la ruta y modalidad correspondientes; FleteChat no los deriva de memoria.
3. Los servicios que FleteChat ofrece al cliente están en el catálogo de servicios de FleteChat; FleteChat no inventa servicios ni variantes que no existan.
4. Los números de cotización, números de embarque, contactos, direcciones y cualquier dato operativo que FleteChat cite proviene de la base operativa; FleteChat no los reconstruye.
5. Los Incoterms, modalidades y tipos de operación que FleteChat reconoce son los declarados en el catálogo del sistema; combinaciones no soportadas se manejan conforme a la historia de handoff.

Respuesta ante falta de datos¶

1. Cuando FleteChat no tiene en sistema un dato que el cliente pide, lo declara explícitamente ("no tengo esa información a mano") en lugar de estimar o adivinar.
2. Cuando FleteChat no tiene un dato, siempre ofrece al menos una alternativa: recolectar más información, consultar el sistema, o transferir a un asesor humano.
3. FleteChat presenta un rango sólo cuando el sistema lo provee explícitamente como rango; no construye rangos ni aproximaciones por cuenta propia.

Contraste contra afirmaciones del cliente¶

1. Cuando el cliente afirma un dato operativo (precio, número de cotización, número de embarque, fecha), FleteChat lo contrasta contra el sistema antes de aceptarlo como verdadero. Si hay discrepancia, lo señala con cortesía y cita el valor del sistema.

Edge cases¶

• Cliente insiste en un estimado. FleteChat no cede: mantiene que no da estimados no respaldados y ofrece consultar el sistema o transferir a un asesor.
• Dato solicitado está en sistema pero vencido (ej. tarifa expirada). FleteChat lo dice con la fecha de vencimiento y ofrece la tarifa vigente si existe, o activar el flujo de re-cotización.
• Cliente cita una conversación antigua que ya no está en la transcripción. FleteChat consulta la base operativa; si ahí tampoco figura, declara no tenerlo en lugar de reconstruirlo.
• El sistema devuelve un dato evidentemente inconsistente (por ejemplo, precio cero o tiempo de tránsito negativo). FleteChat no lo comunica como si fuera válido: lo trata como fallo del sistema conforme a la historia de manejo de errores.
• Cliente pregunta por un servicio que FleteChat no ofrece. FleteChat lo declara explícitamente ("ese servicio no está disponible") en lugar de improvisar alternativas.

Cómo mediremos éxito¶

• Cero incidentes de datos inventados: ningún reporte de cliente o auditoría detecta que FleteChat comunicó un precio, tiempo, servicio o dato operativo que no proviene del sistema.
• Trazabilidad completa: en una muestra aleatoria de 50 respuestas del agente que contengan números o nombres propios, el 100% es trazable a un registro del sistema identificable.
• Cero discrepancia cotizado vs facturado: todo lo que FleteChat cotizó al cliente coincide con lo facturado, salvo ajustes manuales de FleteChat.

Tamaño, prioridad y tipo¶

• Tamaño: M
• Prioridad: P0 — es una restricción transversal; sin esta historia, la promesa comercial del agente queda expuesta.
• 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-012 — Fuente única de datos operativos. Los precios, tiempos de tránsito, servicios disponibles, Incoterms, modalidades, combinaciones soportadas y todo dato operativo de FleteChat viven en la base operativa del sistema. FleteChat consulta esa base para responder y no produce respuestas operativas sin respaldo.
• PR-013 — Respuesta ante ausencia de dato. Cuando FleteChat no encuentra el dato solicitado, lo declara explícitamente y ofrece al menos una vía de avance (recolectar más datos, consultar, o handoff). Nunca simula saberlo.
• PR-014 — Contraste con afirmaciones del cliente. FleteChat verifica contra el sistema cualquier dato operativo que el cliente afirma antes de tomarlo como cierto. Si hay discrepancia, la señala citando el valor del sistema.

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-012 a PR-014 confirmadas por el cliente
• ⬜ Reglas de negocio aplicables aprobadas
• ⬜ Requerimientos funcionales aplicables aprobados
• ⬜ Historia aprobada formalmente por el cliente