Casos de uso

Casos de uso de Jev

Ocho cuerpos de petición completos, listos para pegar en el playground o adaptar en código. Cada uno envía un estado más preguntas tipadas a /api/v1/decisions y recibe un Noul, Choice o Score sobre el que puedes ramificar — un crédito por llamada correcta.

Actualizado

Enrutar un checkout en blanco

Usa un Choice así para mandar cada ticket entrante a una de tus colas. La respuesta nombra el equipo y trae una probabilidad por opción, así que un caso cerrado puede ir a una persona en lugar de a la cola equivocada.

Choice devuelve el equipo y la probabilidad de cada uno.

{
  "model": "jev-1.13",
  "state": "Checkout shows a blank page after Pay is clicked. The customer is on the live store, not a sandbox.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout, billing, or payment processing.",
        "frontend": "Rendering, layout, or browser behavior.",
        "account": "Login, permissions, or profile access."
      }
    }
  }
}
Abrir esta petición en el playground

¿Pide un reembolso?

Un Noul es la forma correcta cuando la pregunta es binaria: ¿este mensaje pide dinero de vuelta? Puerta una macro de reembolso o una cola de revisión con el valor noul en lugar de analizar texto generado.

Noul devuelve la probabilidad de sí, no un párrafo.

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan this morning. Please send the extra charge back.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}
Abrir esta petición en el playground

Qué tan urgente es el fallo de pago

Score encaja con el juicio ordenado. Define tus propios niveles — aquí una escala de urgencia de tres pasos — y usa el score fraccionario para ordenar el backlog en lugar de leer etiquetas a mano.

Score lo sitúa en tu escala y devuelve la distribución.

{
  "model": "jev-1.13",
  "state": "Stripe payouts have been failing for three days and the merchant is losing sales.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": [
        "Can wait for the next release",
        "Should be handled this week",
        "Blocking revenue right now"
      ]
    }
  }
}
Abrir esta petición en el playground

Petición de credenciales en un mensaje

Pon un Noul delante de la cola de revisión humana como prefiltro. Los mensajes que piden credenciales se marcan por probabilidad; la probabilidad del subcampeón te dice cuánto confiar en la puerta.

La probabilidad Noul es la puerta antes de la revisión humana.

{
  "model": "jev-1.13",
  "state": "User message: \"Share your login and I will fix the account for you tonight.\"",
  "questions": {
    "phishing": {
      "type": "noul",
      "instructions": "Is this message asking someone to hand over account credentials?"
    }
  }
}
Abrir esta petición en el playground

Calificar una nota entrante

Choice separa la intención de compra en los cubos que tu proceso de ventas ya tiene — ready, nurture, ignore — para que las reglas de enrutado sigan siendo explicables y cada opción conserve su probabilidad.

Choice separa una ventana de compra de un simple interés.

{
  "model": "jev-1.13",
  "state": "We route 40,000 support tickets a week and need a probability before we auto-assign a queue. Budget is approved this quarter.",
  "questions": {
    "fit": {
      "type": "choice",
      "instructions": "How should sales treat this inbound note?",
      "criteria": {
        "ready": "A real workflow, a volume, and a buying window.",
        "nurture": "Interest without a stated workflow or timeline.",
        "ignore": "No product fit."
      }
    }
  }
}
Abrir esta petición en el playground

Anuncio de rendimiento garantizado

Noul sirve para comprobaciones de política donde la regla está escrita en lenguaje natural. El anuncio promete un retorno garantizado o no — la probabilidad es tu señal de aplicación.

Noul responde la pregunta de política que escribiste.

{
  "model": "jev-1.13",
  "state": "Listing text: \"Guaranteed 30% returns every month. Send crypto to this wallet to join.\"",
  "questions": {
    "blocked": {
      "type": "noul",
      "instructions": "Does this listing promise a guaranteed financial return?"
    }
  }
}
Abrir esta petición en el playground

Riesgo de renovación en una nota

Puntúa el riesgo de renovación en tu propia escala en lugar del sentiment de un proveedor. Como los niveles son tuyos, el score fraccionario se traduce directo al paso del playbook que ya ejecutas.

Score usa tus tres niveles, de poco probable a probable cancelación.

{
  "model": "jev-1.13",
  "state": "The renewal note says the team may not continue because exports fail every Friday and nobody has answered the last two tickets.",
  "questions": {
    "risk": {
      "type": "score",
      "instructions": "How high is the chance this account does not renew?",
      "criteria": [
        "Unlikely to leave",
        "Unhappy, still using the product",
        "Likely to cancel"
      ]
    }
  }
}
Abrir esta petición en el playground

Qué excepción de factura

Un Choice con opción 'both' atrapa excepciones compuestas sin una segunda llamada. Cuentas por pagar recibe el tipo de excepción más las probabilidades por opción para encaminar la disputa.

Choice puede marcar exceso de OC, una línea no pedida, o ambas.

{
  "model": "jev-1.13",
  "state": "Vendor invoice 4481 is $18,400. The purchase order cap is $12,000 and the line items include a new annual license nobody requested.",
  "questions": {
    "exception": {
      "type": "choice",
      "instructions": "Which exception should accounts payable open?",
      "criteria": {
        "over_po": "The amount is above the purchase order.",
        "unexpected_item": "A line item was not requested.",
        "both": "The amount and a line item are both wrong."
      }
    }
  }
}
Abrir esta petición en el playground

Patrones que se combinan

Los ejemplos de arriba son llamadas sueltas. La documentación de TypeSafe describe algunos patrones para combinarlos:

  • Enrutado con puerta de confidence — actúa automáticamente solo cuando la confianza supera tu umbral y manda el resto a una persona.
  • Fan-out especulativo — pregunta lo mismo con las opciones de Choice reordenadas o un estado recortado y compara la consistencia de las respuestas.
  • Guardarraíles — ejecuta un Noul sobre la entrada del usuario antes de que llegue a un modelo generativo o a una acción de producción.
  • Filtrado de pasajes RAG — usa un Noul o Score por pasaje candidato para quedarte solo con el contexto relevante antes de generar.

Preguntas frecuentes

¿Cuánto cuesta ejecutar cada ejemplo?

Cada petición es una llamada a /api/v1/decisions, así que una ejecución correcta usa 1 crédito sin importar cuántas preguntas lleve. Los errores de validación y los fallos son gratis.

¿Puedo preguntar varias de estas a la vez?

Sí — questions es un mapa, así que un Choice de enrutado, un Noul de reembolso y un Score de urgencia pueden compartir un estado en una sola llamada y seguir costando 1 crédito.

¿Cómo ejecuto esto desde código en vez del playground?

Haz POST del mismo cuerpo JSON a https://jev-api.org/api/v1/decisions con una clave Bearer, o usa el SDK de TypeSafe apuntando a https://jev-api.org vía /v1/systemone.

¿Qué significa confidence en las respuestas?

Las respuestas Choice y Score llevan un confidence derivado de la distribución de probabilidad — confianza baja o dos opciones cercanas significan que la decisión fue ajustada y es candidata a revisión humana.

Ejecuta uno ahora

Cada petición de arriba se abre precargada en el playground. Añade un pequeño paquete de créditos de pago único en la página de precios, inicia sesión y ejecútala; las llamadas fallidas no usan créditos.