Jev: delega al modelo decisiones pequeñas como “cuál elegir”
Un sistema de atención al cliente recibe mensajes sin parar. ¿Este es una queja, una consulta o publicidad no deseada? ¿Hay que derivarlo a un agente humano? Este tipo de decisiones pequeñas de “elegir una opción entre varias” son abundantes, deben ser rápidas y siempre iguales.
Jev es un modelo especializado precisamente en este tipo de decisiones. En esta etapa obtendrás una API Key y enviarás tu primera solicitud desde tu equipo local.
Primero, mira cómo trabaja:
- 1Obtener la API Key
- 2Enviar la primera solicitud
- 3El Agent completó la operación
Qué se hace en esta etapa
- Obtener una API Key de TypeSafe y guardarla en la variable de entorno
TYPESAFE_API_KEY - Completar en local la primera solicitud a Jev: un texto de ticket y, en una sola llamada, obtener tres respuestas: clasificación, puntuación y sí/no
- Poder localizar los problemas comparando los códigos de estado cuando haya errores: 401 revisa la Key, 429 es limitación de velocidad, 400 revisa el formato de la solicitud
Lecciones de esta etapa
| Lección | Contenido |
|---|---|
| 1.1 Jev Qué es | El modelo de decisión System One, sus diferencias con los LLM y los tres tipos de preguntas Choice / Score / Noul; todo con el Playground oficial, sin escribir código |
| 1.2 Registro y API Key | Obtener la Key en la consola de TypeSafe, guardarla en la variable de entorno TYPESAFE_API_KEY, dónde consultar los límites de velocidad |
| 1.3 Instalación y primera solicitud | Instalar typesafe-sdk con venv + pip y completar el ejemplo oficial de las tres preguntas sobre un ticket |
| ↳ 1.3b Métodos alternativos de instalación | uv, npm (SDK de JavaScript / TypeScript) y conexión directa a la API con curl |
| 1.4 Solución de problemas al empezar | Referencia de códigos de estado como 401 / 429 / 400, reintentos automáticos del SDK, errores comunes |
Lo que hay que preparar antes de empezar
- Un ordenador con acceso a internet y con terminal (los comandos del inicio rápido oficial están escritos en Bash para macOS / Linux / Windows WSL)
- Python 3.10 o superior (la ruta principal usa el SDK de Python; la ruta con Node.js 22+ se explica en la lección 1.3b)
- Una red con acceso a
console.typesafe.ai(para obtener la Key) y aapi.typesafe.ai(para enviar solicitudes)
Siguiente paso
Empieza desde la primera lección.