Endpoint - Sugerencias IA

Smart Mibizum es el aprendizaje IA del buscador. Cada noche analiza las busquedas del dia, detecta typos y propone sinonimos. Estos endpoints exponen su output para integraciones a medida; lo habitual es consumir Smart desde el panel (Smart IA) o Aprende del cliente.

Conceptos previos: lee Guia: Corpus fallido a exitoso y Guia: Anti-spam por evidencia.

Modos

Smart opera en tres modos seteables desde el panel (Ajustes > Smart):

• off: el cron no corre. Sin aprendizaje.
• shadow: el cron corre y registra sugerencias, pero no aplica nada. Util para evaluar antes de activar.
• hybrid: aplica automaticamente las sugerencias con confidence >= hybrid_confidence_threshold (default 0.65). Las demas van a /sugerencias para que las apruebes.
• auto: aplica todas las sugerencias con confidence >= auto_confidence_threshold (default 0.85). Mas agresivo.

GET /v1/{tenant}/smart/suggestions

Lista las sugerencias pendientes de revision.

curl https://api.mibizum.io/v1/tu-tienda/smart/suggestions \
  -H "Authorization: Bearer mb_sk_live_..."

Respuesta

{
  "total": 13,
  "rows": [
    {
      "id": "abc-123",
      "failed": "caguacate",
      "rescue": "aguacate",
      "suggested": "aguacate",
      "confidence": 0.92,
      "reason": "Letra repetida (typo de teclado); producto en catalogo",
      "created_at": "2026-05-26T02:13:00Z",
      "run": { "id": "run-7", "mode": "hybrid", "started_at": "...", "cost_usd_cents": 1 }
    }
  ]
}

POST /v1/{tenant}/smart/suggestions/{id}/accept

Acepta una sugerencia. Crea el sinonimo con source='learned', lo aplica al motor y marca la sugerencia como atendida.

curl -X POST https://api.mibizum.io/v1/tu-tienda/smart/suggestions/abc-123/accept \
  -H "Authorization: Bearer mb_sk_live_..."

POST /v1/{tenant}/smart/suggestions/{id}/reject

Rechaza una sugerencia. Quedara en el log como rechazada con timestamp y razon opcional. Si la memoria del negocio cambia, Smart volvera a evaluarla en el siguiente run.

curl -X POST https://api.mibizum.io/v1/tu-tienda/smart/suggestions/abc-123/reject \
  -H "Authorization: Bearer mb_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "reason": "No es un typo, es un producto distinto" }'

GET /v1/{tenant}/smart/runs

Lista las ejecuciones del cron Smart con metricas por run (queries analizadas, sugerencias por banda, coste IA, etc.).

curl https://api.mibizum.io/v1/tu-tienda/smart/runs?limit=10 \
  -H "Authorization: Bearer mb_sk_live_..."

Privacidad

Smart nunca envia al proveedor IA: session ID, IP, customer ID, timestamps, datos personales. Solo manda los pares (failed, rescue) deduplicados y anonimizados. Ver el Aviso de privacidad para el detalle.