Cómo empezar con Jev

Empezar sin código

Puedes probar tu propio texto y pregunta en la demo gratuita e independiente de este sitio sin aportar una clave API. Define una regla de Sí/No o entre 2 y 6 opciones. Para conectar Jev a tu aplicación, sigue la vía oficial de acceso a la cuenta y API de TypeSafe que se explica por separado más abajo.

La demo permite hasta 10.000 caracteres en total entre texto, pregunta, reglas y opciones, contados como puntos de código Unicode. Es el límite de este sitio, no la ventana de contexto de Jev. Las comprobaciones en vivo pueden requerir verificación humana y detenerse al alcanzar límites de uso o presupuesto. Cargar una plantilla no la ejecuta ni aporta un resultado del modelo.

Abrir el editor personalizado · Cargar la plantilla de comentarios

1. Empieza por la vía de acceso adecuada

A fecha de 17 de septiembre de 2026, el sitio público de TypeSafe presenta una lista de espera. La guía oficial de inicio rápido ofrece instrucciones para el Playground y la API. Que una página de documentación sea accesible no significa que todas las cuentas tengan acceso al modelo.

• Si no tienes acceso: utiliza la lista de espera del sitio oficial de TypeSafe. Este sitio no puede aprobar cuentas ni emitir claves de API.
• Si tu cuenta tiene acceso: abre la consola de TypeSafe y sigue el proceso del Playground o de las claves de API.

La disponibilidad de las cuentas y el proceso de incorporación pueden cambiar. La consola oficial es el lugar donde consultar tu propia situación.

2. Prueba una pregunta acotada

En el Playground, utiliza un mensaje ficticio breve como entrada y formula una pregunta Noul. Por ejemplo, usa un mensaje que solicite una llamada y pregunta si se pide expresamente que llamen. Después, cambia la entrada por una petición vaga de ayuda y observa si cambia el resultado.

Es un ejercicio de exploración, no una prueba de exactitud. Empezar con dos ejemplos contrastantes permite ver si la pregunta expresa la distinción que querías establecer.

Jev llama state a la información proporcionada. Puede ser una cadena, un objeto JSON o un array. Para tareas más complejas, utiliza campos con nombre que permitan distinguir el mensaje, los registros de apoyo y la política pertinente. Formatos de entrada

curl --fail-with-body --silent --show-error \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "jev-latest",
  "state": "Please call me tomorrow morning to discuss the setup.",
  "questions": {
    "callback_requested": {
      "type": "noul",
      "instructions": "Does the sender explicitly ask for a phone call?"
    }
  }
}
JSON

4. Añade estructura solo cuando la tarea lo requiera

Utiliza Choice cuando el siguiente paso dependa de una categoría, Score cuando tengas niveles ordenados con un significado claro y Noul cuando necesites una probabilidad de sí o no. Agrupa las preguntas independientes sobre el mismo estado y gestiona sus resultados en tu aplicación.

Como siguiente paso concreto, sigue el ejemplo de ticket de soporte. Muestra cómo una salida documentada se convierte en una propuesta de asignación.

5. Resuelve por separado los problemas de acceso y de la solicitud

Si el inicio de sesión en la consola no termina, vuelve a abrirla desde su punto de entrada habitual y comprueba que utilizas la cuenta con acceso. Evita cambiar repetidamente la solicitud a la API para resolver un problema de inicio de sesión del navegador. Iniciar sesión correctamente tampoco demuestra que se haya emitido una clave de API. Si necesitas ayuda con la cuenta, utiliza la vía de soporte oficial de TypeSafe; nunca incluyas una clave o un enlace de inicio de sesión en un informe público.

Para una solicitud HTTP, examina el código de estado y el cuerpo del error antes de cambiar la pregunta:

Estos códigos se documentan en la referencia de la API. Para 429 o 529, utiliza esperas exponenciales entre reintentos. Los SDK ya reintentan por defecto; ten en cuenta esos intentos antes de añadir un bucle externo de reintentos.

Un tiempo de espera agotado es distinto de una respuesta negativa. Establece un plazo total y un número limitado de intentos, y deriva el trabajo no resuelto a revisión. Asegúrate de que reintentar la solicitud al modelo no pueda repetir una acción posterior, como crear una asignación.

6. Investiga una respuesta inesperada

Estos son pasos de depuración propuestos por la redacción. La guía de Score explica los valores fraccionarios; nuestra página de limitaciones enlaza las advertencias actuales del proveedor y las observaciones de la comunidad, identificadas por separado.

El alias jev-latest puede pasar a señalar un modelo más reciente. Registra el identificador del modelo devuelto durante las pruebas; cuando importe la reproducibilidad, utiliza un identificador con versión que admita tu cuenta. Alias de modelos

7. Decide si el primer flujo de trabajo está listo

Antes de habilitar acciones automáticas, conserva un pequeño conjunto de decisiones esperadas, revisa los errores y elige umbrales para tu flujo de trabajo. Utiliza la calculadora de precios para estimar el gasto en tokens de entrada y la guía comparativa para decidir qué debe seguir en manos de otras herramientas.