Gemba

Resuelve referencias humanas de clientes antes de consultar cubos, deuda o historial. Busca en nombre, razon social, contacto, email, telefono, CUIT/tax_id, external_id y aliases facturados. Si hay ambiguedad devuelve candidatos y suggestedCubeFilter; no inventa clientId.

Tool unificada de clientes. Elegí action: 'search' para buscar/listar/contar clientes (incluye saldo CC; soporta includeLifecycleManagement / includeAssignmentData); 'detail' para datos maestros de UN cliente (contacto, direcciones, vendedores, pricing; opcional includeOrders / includeAccountBalance); 'financial' para deuda total, crédito, aging y elegibilidad de UN cliente (detail=summary|movements|full); 'commercial' para historial de compras, ticket, frecuencia, tendencia y top productos de UN cliente. detail/financial/commercial requieren clientId; search no.

Cubo comercial CANONICO sobre ventas certificadas de la organizacion. Usar para analisis por producto/rubro/SKU historico/cliente/vendedor, kg netos, cantidades, notas de credito cuando la fuente las soporta, comparativos 2025 vs 2026, clientes perdidos o caidas/crecimientos por kg. Tambien responde MARGEN y rentabilidad (metricas netCost, netMargin, marginPercent; leer SIEMPRE costCoveragePercent y aclarar si el margen es parcial porque hay costo sin cargar). Para listar COMPROBANTES individuales (facturas/NC con su numero, importe y resultado, como la pantalla de Comprobantes) agrupar por la dimension comprobante.number con tx.voucherType. Para preguntas tipo 'que clientes explican la caida/crecimiento', usar mode=clientMovement; si ese modo no esta disponible, reintentar esta misma tool con mode=query y dimensiones client.code/client.name para comparar periodos. Para migracion de formatos o presentaciones tipo 1kg/5kg/10kg, usar mode=presentationMovement. Para oportunidades tipo 'clientes que compran A y no compran B', usar mode=productGap con anchor y target. La fuente comercial efectiva se resuelve internamente; no mencionar detalles tecnicos internos en la respuesta al usuario. Si una metrica no esta disponible para la fuente comercial activa, reportarla como no disponible/0 y seguir respondiendo desde este cubo. No usar orders_search como fallback para ventas agregadas. No depende de rankings top-N.

Busca en las conversaciones pasadas del usuario por tema o palabra clave. Usa esta tool cuando: - El usuario menciona algo que "hablamos antes" o "discutimos" - Necesitas contexto de interacciones previas sobre un tema específico - El usuario pregunta "¿qué pasó con...?" o "¿qué dijimos sobre...?" - Quieres retomar un tema o cliente específico de una conversación anterior Ejemplos de cuándo usar: - "¿Qué hablamos sobre el cliente Farmacia López?" - "¿Qué dijimos de las promociones de invierno?" - "Retomemos lo de los clientes morosos" - "¿Cuándo fue que revisamos el pedido de Don José?" La búsqueda es sobre el contenido de todos los mensajes (usuario y asistente). Retorna las conversaciones más relevantes con snippets del contenido encontrado.

CUENTA CORRIENTE canonica (deuda, saldos, aging, movimientos, cobros). scope='portfolio': estado de toda la cartera (resumen, listado, vencidos, vencimientos proximos, ranking de deudores, cobros) — como /current-accounts. scope='client': UN cliente con DESGLOSE por cuenta (por CANAL de facturación o por SUCURSAL según el tenant), movimientos, statement y pagos (requiere filters.clientId). Para el RESUMEN financiero agregado de un cliente (credito, estado, salud, top vencidos) usa clients con action='financial'; esta tool es el LEDGER detallado y el desglose por cuenta.

Obtiene información completa de UN pedido específico. Usa esta tool cuando necesites ver los productos de un pedido, el historial de cambios, facturas adjuntas, o información de entrega. Requiere el ID o número del pedido.

Busca y lista pedidos con filtros avanzados. Usa esta tool cuando el usuario quiera ver pedidos de hoy, pedidos pendientes, pedidos de un cliente, o buscar un pedido por número. Devuelve datos resumidos de cada pedido. NO usar para ventas agregadas, facturacion, totales, rankings, comparativos ni seguimiento mensual: para eso usar commercial_sales_cube. No expliques detalles tecnicos internos al usuario.

Tool unificada de productos. Elegí action: 'search' para buscar/listar productos del catálogo (nombre, marca, categoría, SKU; ordena por relevancia); 'detail' para info completa de UN producto (stock por sucursal, costos, márgenes, fotos, escalas de volumen; opcional clientId para precio personalizado); 'pricing' para el precio final de productos para UN cliente con TODOS los descuentos e impuestos (requiere clientId; soporta productId/sku, productIds[] o categoryId; incluye pricingTips). pricing requiere clientId; search no.

Obtiene las conversaciones más recientes del usuario. Usa esta tool cuando: - El usuario pregunta "¿de qué hablamos?" o "¿qué conversamos?" - Necesitas dar continuidad ("como vimos antes...") - El usuario dice "continúa" o "retomemos" sin especificar qué tema - Quieres mostrar un resumen de actividad reciente del usuario Ejemplos de cuándo usar: - "¿De qué hablamos ayer?" - "¿Cuáles fueron mis últimas consultas?" - "Continúa con lo que estábamos viendo" - "¿Qué conversaciones tuve esta semana?" Retorna título, fecha relativa y resumen de cada sesión.

Recomienda productos a un cliente o segmento basado en qué compran los clientes similares (mismo segmento). Útil para: pre-call de vendedor ('qué le ofrezco'), campañas de marketing, sugerencias de venta cruzada. Rankea por frecuencia (clientes únicos que compraron). Pasá clientId para descubrir sus segmentos automáticamente, o segmentId para apuntar a un segmento específico.