Caso de uso

Triaje de correo y leads

Ordena el correo entrante en billing, support o sales y marca lo que vence hoy.

El problema

Las bandejas compartidas se vuelven un montón. Las renovaciones esperan tras las preguntas de funcionalidades.

Qué hace tu código con la respuesta

Enruta por intención. Lo marcado urgente se salta el backlog.

Leer la bandeja en una llamada

El correo (asunto y cuerpo como un solo estado) decide adonde va: intent (choice entre billing, support, sales, other) y urgent (¿debe responderse hoy?). El correo de muestra — una renovación bloqueada porque finanzas nunca recibió INV-2041, con reenvío solicitado para hoy — puntúa intent=billing y urgent alto, que es exactamente el correo que no debe esperar tras las preguntas de funcionalidades en una bandeja compartida.

La regla de las colas

Enruta por intención, cada cola con su propio SLA; lo urgente se salta el backlog. Una regla más se gana su sitio: el correo cuya probabilidad de intención está disputada entre dos colas va a ambas en lugar de a la más alta. A unos 400 tokens por correo, triar diez mil correos cuesta unos pocos dólares de créditos.

Riesgos propios del triaje de bandeja

El fallo común es el contexto de respuesta perdido: llega un «re:» con la cadena previa recortada, y la intención se lee sobre nada. Pega el hilo en el estado. También — si los SLA de dos equipos difieren (soporte responde en horas, ventas el mismo día), intent y urgent necesitan cada uno su propio camino; si no, «urgente» desprioriza en silencio la mitad del correo de ventas.

La forma de la solicitud

Esta es la solicitud completa que el playground envía para este preset — el mismo JSON que tu servidor envía a /v1/systemone con una clave Bearer.

curl
curl https://jevai.website/api/v1/systemone \
  -H "Authorization: Bearer $JEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "state": "Subject: Re: invoice INV-2041\nHi, we never received INV-2041 and finance is blocking our renewal until this is sorted. Can someone resend it today?",
  "questions": {
    "intent": {
      "type": "choice",
      "instructions": "What is the sender asking for?",
      "criteria": {
        "billing": "Invoice, payment or refund",
        "support": "Product help",
        "sales": "Pricing or a new deal",
        "other": "Something else"
      }
    },
    "urgent": {
      "type": "noul",
      "instructions": "Should this be answered today?"
    }
  }
}'

Preguntas frecuentes sobre este caso de uso

¿Qué hay de los adjuntos y los hilos?
Pega el hilo como texto en el estado; el resumen de adjuntos ocurre aguas arriba de la llamada. Un hilo de 20 correos sigue quedando muy por debajo del techo de tokens.
¿La intención «other» captura el spam?
En parte — la mayoría del spam puntúa other con urgencia baja, donde un filtro más rápido puede descartarlo. El phishing merece un clasificador de seguridad, no este: el coste de una dirección equivocada aquí es humano.
¿Puede cada equipo ajustar sus propias colas?
El choice de intención es una decisión compartida — mantén la redacción de las criteria en manos del dueño de la bandeja compartida para que «sales» no signifique en silencio algo distinto para cada equipo.
Ejecútalo en el Playground