Desarrolla con Jev

INICIO RÁPIDO

Valida una decisión en la zona de pruebas

La zona de pruebas es la forma más rápida de entender las entradas y salidas de Jev. Cuando la pregunta esté lista, crea una clave API y conéctala a tu producto.

1. 1

   Abre la zona de pruebas

   Inicia sesión, abre la zona de pruebas de Jev AI e introduce un caso real de tu negocio.

2. 2

   Prepara el contexto

   Usa texto, un objeto JSON o un array de texto para proporcionar el contexto necesario.

3. 3

   Añade preguntas

   Elige Choice, Score o Noul. Puedes combinar los tres tipos en una solicitud.

4. 4

   Conecta tu código

   Crea una clave API en tu espacio de trabajo y llama al endpoint de producción con un SDK o REST.

ENTRADA

Proporciona el contexto necesario para decidir

El contexto es la información que leen todas las preguntas. Usa una cadena para un caso sencillo y un objeto JSON cuando debas combinar un ticket, un pedido y una política.

Jev acepta texto, objetos JSON y arrays de texto. Aún no admite entradas de imagen, audio ni vídeo.

TIPOS DE PREGUNTA

Compón decisiones con preguntas concretas

Cada pregunta debe plantear algo específico y bien delimitado. Varias preguntas se evalúan en paralelo sobre el mismo contexto, sin necesidad de encadenar llamadas.

{
  "type": "noul",
  "instructions": "Does this message convey urgency?",
  "criteria": {
    "true": "Explicitly needs immediate attention",
    "false": "No urgency expressed"
  }
}

"instructions": {
  "potential_duplicate": {
    "name": "John Smith",
    "location": "Oakland, California",
    "last_employer": "Google"
  },
  "question": "Is the resume for the same person as `potential_duplicate`?"
}

{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "typesafe/jev-1.14",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Payments, invoicing, refunds",
        "technical": "Bugs, outages, integrations",
        "sales": "Pricing, upgrades, new accounts"
      }
    }
  }
}

{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "typesafe/jev-1.14",
  "questions": {
    "frustration": {
      "type": "score",
      "instructions": "How frustrated is the customer?",
      "criteria": [
        "Calm",
        "Frustrated",
        "Very angry"
      ]
    }
  }
}

{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "typesafe/jev-1.14",
  "questions": {
    "is_urgent": {
      "type": "noul",
      "instructions": "Does this convey urgency?",
      "criteria": {
        "true": "Explicitly time-sensitive",
        "false": "No urgency expressed"
      }
    }
  }
}

SALIDA

Qué aporta la respuesta a tu código

Las respuestas, el uso y elapsedMs se encuentran en data.result. data.creditsUsed indica los créditos cobrados en solicitudes con clave API. Las respuestas usan los mismos ID de las preguntas enviadas.

• answers: Choice devuelve la opción, las probabilidades y la confianza; Score devuelve puntuación, leyenda, probabilidades por nivel y confianza; Noul devuelve noul.
• usage: Incluye input_tokens y output_tokens.
• elapsedMs: Tiempo desde el envío hasta la recepción del resultado, incluida la validación; no solo la inferencia del modelo.

La probabilidad y la confianza orientan la automatización, pero no garantizan la precisión del negocio. Para acciones arriesgadas, usa umbrales altos o revisión humana.

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "is_urgent": {
          "type": "noul",
          "noul": 0.95
        }
      },
      "usage": {
        "input_tokens": 296,
        "output_tokens": 20
      },
      "elapsedMs": 200
    },
    "creditsUsed": 1
  }
}

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "department": {
          "type": "choice",
          "choice": "billing",
          "probabilities": {
            "billing": 0.88,
            "technical": 0.12,
            "sales": 0
          },
          "confidence": 0.81
        }
      },
      "usage": {
        "input_tokens": 318,
        "output_tokens": 34
      },
      "elapsedMs": 200
    },
    "creditsUsed": 1
  }
}

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "frustration": {
          "type": "score",
          "score": 1.05,
          "legend": {
            "0": "Calm",
            "1": "Frustrated",
            "2": "Very angry"
          },
          "probabilities": {
            "0": 0,
            "1": 0.95,
            "2": 0.05
          },
          "confidence": 0.92
        }
      },
      "usage": {
        "input_tokens": 304,
        "output_tokens": 18
      },
      "elapsedMs": 200
    },
    "creditsUsed": 1
  }
}

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "is_urgent": {
          "type": "noul",
          "noul": 0.95
        }
      },
      "usage": {
        "input_tokens": 307,
        "output_tokens": 20
      },
      "elapsedMs": 200
    },
    "creditsUsed": 1
  }
}

REFERENCIA DE LA API

Evalúa el contexto y devuelve respuestas estructuradas

Referencia completa de la API HTTP: evalúa un contexto con preguntas tipadas y recibe una respuesta estructurada por pregunta.

Authorization: Bearer <API_KEY>
Content-Type: application/json

curl -X POST https://thejevai.com/v1/systemone \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "typesafe/jev-1.14",
    "state": "Help! My payouts have been failing for 3 days.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this convey urgency?"
      }
    }
  }'

{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "typesafe/jev-1.14",
  "questions": {
    "is_urgent": {
      "type": "noul",
      "instructions": "Does this convey urgency?"
    }
  }
}

Guarda la clave API en una variable de entorno del servidor. Nunca la incluyas en el código del navegador ni la subas al repositorio. Aquí se describen campos, tipos de pregunta, respuestas, errores y reintentos.

Modelos disponibles

Usa cada modelo de decisiones con una sola interfaz

El Playground y la API admiten 23 ID de modelos de decisiones de OpenRouter, incluidas versiones fijas y alias latest. Comparten el mismo formato de solicitud; solo cambia el campo model.

Los alias latest requieren el ~ inicial y siguen automáticamente la última versión del proveedor. Usa un ID con versión si necesitas mantener una versión fija. Las solicitudes existentes con typesafe/jev-1.13 siguen siendo compatibles.

curl -X POST https://thejevai.com/v1/systemone \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_ID>",
    "state": "Replace this with your business state.",
    "questions": {
      "decision": {
        "type": "choice",
        "instructions": "Choose the most appropriate result.",
        "criteria": {
          "option_a": "Option A",
          "option_b": "Option B"
        }
      }
    }
  }'

Estos 23 modelos usan POST /v1/systemone y la misma regla de créditos de Jev. Cada solicitud admite hasta 8 preguntas y 32 KiB de JSON, aunque el proveedor permita entradas mayores. La zona de pruebas edita texto o JSON; las modalidades y los tipos de pregunta dependen del proveedor. :free identifica la variante del proveedor y no exime de créditos en la API de Jev. Laya tiene documentación independiente.

USO CON AGENTES

Usa Jev dentro de un agente de programación

Jev Agent Skill enseña a Codex, Claude Code, Cursor y otros agentes a usar esta API para decisiones acotadas, mientras la ejecución y los permisos siguen en tu aplicación.

npx skills add jev-ai/jev-agent-skill

export JEV_API_KEY="sk_your_key_here"
export JEV_LANGUAGE="en-US"

Usa Jev Agent Skill. Clasifica este ticket de soporte en exactamente un equipo: billing, technical, account o sales. Devuelve el equipo seleccionado, las probabilidades y la confianza. No contactes con el cliente ni modifiques todavía el ticket.

Ticket: Me han cobrado dos veces el plan anual y necesito un reembolso.

Usa Jev Agent Skill antes de ejecutar esta llamada propuesta a una herramienta. Decide si es segura sin aprobación humana. Ten en cuenta los efectos secundarios, la reversibilidad, el alcance y las políticas. Si es arriesgada o hay dudas, no la ejecutes.

Herramienta: delete_customer_records
Argumentos: {where: last_login < 2023-01-01}
Política: las operaciones destructivas en la base de datos requieren una copia de seguridad y aprobación humana.

Usa Jev Agent Skill para elegir un modelo aprobado para esta tarea. Prioriza la calidad y después la capacidad de contexto y el coste. Devuelve el modelo seleccionado, las probabilidades y si hay que escalar el caso. Todavía no llames a ningún modelo.

Tarea: revisar una disputa de un cliente de 100k tokens.
Candidatos: fast-model (32k, coste bajo), reasoning-model (200k, coste alto), fallback-model (128k, coste medio).

Usa Jev Agent Skill para comprobar si hay pruebas suficientes para publicar esta afirmación. Valora la calidad y actualidad de las fuentes, si la respaldan directamente y si existen contradicciones. Devuelve la probabilidad de que pueda publicarse y las verificaciones pendientes. No la publiques todavía.

Afirmación: Nuestra API redujo un 40 % el tiempo mediano de procesamiento.
Pruebas: una prueba comparativa interna del mes pasado con 120 casos; sin datos del tráfico de producción; un informe anterior que mostraba una mejora del 12 %.

Usa Jev Agent Skill para comprobar si esta tarea está terminada. Devuelve complete, verify_more o incomplete. Ten en cuenta el objetivo, los archivos modificados, las pruebas ejecutadas, las lagunas conocidas y la verificación en el entorno de destino.

Objetivo: añadir autenticación con clave API al endpoint de producción.
Hecho: se ha añadido la comprobación de Authorization y la búsqueda de la clave API.
Verificación: las pruebas unitarias pasan; no se han probado las solicitudes de producción ni el comportamiento del límite de solicitudes.

GESTIÓN DE ERRORES

Errores y reintentos

El endpoint usa códigos de estado HTTP estándar y devuelve una respuesta JSON con el error.

Ante un 429 o 529, reintenta con retroceso exponencial en vez de reenviar la solicitud de inmediato. Los SDK con una política predeterminada pueden hacerlo automáticamente.