Skip to content

Manual avanzado: Jev Ultrafast, agent de navegador y guía para evitar errores ​

💡 Objetivo: en unos 92 minutos hacer dos cosas: poner en marcha el agent de navegador Jev Ultrafast en tu propia computadora (registro oficial: una búsqueda real en Google Flights en 7.073 segundos) y llevarte los 9 modos de fallo y las alternativas oficiales de la documentación de errores comunes de Jev 1.13.

🎯 Objetivos de la etapa ​

  • Saber explicar cómo funciona Jev Ultrafast: espacio de acciones con índice dinámico, una sola ida y vuelta para decidir a la vez la operación y el objetivo, y el bucle por defecto sin capturas de pantalla
  • Ejecutarlo desde cero: uv sync + dos API Key, ver los elementos numerados y las probabilidades en el inspector de 127.0.0.1:8766, y luego escribir tus propias tareas de navegador con la librería Agent
  • Saber leer los datos oficiales de rendimiento y conocer los límites: cómo se mide el 7.073 segundos, qué significa que el protocolo pase de 1,092→101 llamadas, qué controles no están soportados y por qué DONE requiere verificación independiente
  • Reconocer los 9 modos de fallo de Jev 1.13 y saber decir la alternativa oficial de cada uno: la aritmética va en el código, las fechas en un widget, filtrar primero los state grandes

⏳ Tiempo estimado ​

  • 7 lecciones suman unos 92 minutos; con margen de holgura, unos 64–120 minutos
  • 5.1–5.4 forman una sola línea principal (principios → instalación → ejecución real → lectura de datos), se recomienda seguir el orden; 5.5 / 5.6 solo dependen del entorno de la lección 2 y pueden leerse por separado según necesidad
  • 5.7 el manual de errores comunes es totalmente independiente y puede leerse sin tocar el navegador: los usuarios de solo API no pierden nada saltando directamente a él

🚀 Antes de empezar ​

  • Haber completado uso diario: dominar las cinco formas de preguntar a Jev: cada decisión de Ultrafast es una solicitud TypeSafe, así que primero hay que entender bien el state, las preguntas tipadas y las distribuciones de probabilidad
  • Tener a mano una API Key de TypeSafe (registro y API Key); Ultrafast además necesita configurar un TEXT_MODEL_API_KEY de un modelo de texto (la lección 2 enseña a configurarlo)
  • Tener Chrome y uv en la computadora: Ultrafast se instala con uv sync y Chrome se conecta a través del Browser Harness
  • Una taza de agua ☕: en esta etapa por fin dejarás que Jev haga clics en el navegador por ti

📚 Lecciones de esta etapa ​

El protagonista de las primeras 6 lecciones es Jev Ultrafast, el agent de navegador de Browser Use × TypeSafe, cuya definición oficial en una frase es: «un agent de navegador con un espacio de acciones dinámico e indexado». El uso sigue siendo el estilo de juicio de Jev que ya conoces: le das un objetivo, Jev elige la operación y el elemento, y el LLM pequeño solo escribe cadenas cuando hay que teclear (TYPE_TEXT).

En la nube existe además el BU Ultrafast alojado oficialmente (Browser Use Cloud, disponible en todos los planes, model: "bu-ultrafast", con entrada en cloud.browser-use.com); en esta etapa vas a ejecutar la versión de código abierto de GitHub, con todas las operaciones en tu propia computadora.

Primero mira en qué se diferencia de tu enfoque actual:

Tu enfoque actualEl enfoque de Jev Ultrafast
❌ Los scripts de automatización dejan los selectores escritos en duro y fallan en masa al cambiar el diseño de la página✅ En cada observación genera dinámicamente una tabla de elementos numerados ([1] button Change ticket type · Round trip …), Jev elige solo entre lo que realmente existe en la página actual
❌ Los agent visuales adivinan coordenadas a partir de capturas, una captura por paso: lentos y caros✅ El bucle por defecto no toma capturas: Jev consume un state estructurado y una sola ida y vuelta decide a la vez la operación y el objetivo
❌ Pedirle a un LLM grande que escupa un JSON con un «plan de operaciones» y rezar para que se pueda analizar y ejecutar✅ La operación y el objetivo son respuestas tipadas; la salida del modelo nunca se convierte en un selector, coordenadas o JS ejecutable

Las operaciones son 8 en total: CLICK, TYPE_TEXT, SELECT, SCROLL_UP, SCROLL_DOWN, WAIT, DONE, BLOCKED; no existe ninguna acción peligrosa del tipo «ejecutar un script arbitrario». La lección 1 desglosa este espacio de acciones.

Plan de lecciones:

LecciónContenidoDuración
5.1 Principios de Jev UltrafastEspacio de acciones dinámico e indexado y las 8 operaciones; una solicitud TypeSafe pregunta a la vez la operación y el objetivo (dos decisiones, una ida y vuelta); por qué el bucle por defecto no toma capturas12 minutos
5.2 Instalación y ejecución de Ultrafastgit clone + uv sync + dos API Key; abrir el inspector de 127.0.0.1:8766, ver los elementos numerados, las probabilidades de las operaciones y las probabilidades de los objetivos15 minutos
5.3 Ejecutar Google Flights de punta a puntaUna búsqueda real de Zürich → London, registro oficial de 7.073 segundos; examples/flights.py incluye verificación independiente, solo busca sin reservar15 minutos
5.4 Interpretación del rendimientoCómo se midieron los 7.073 segundos: 17 solicitudes, latencia mediana de Jev 178 ms; comparación medida 9.450→7.092 s, llamadas de protocolo 1,092→101—lo oficial aclara que es una muestra pequeña, no un benchmark universal10 minutos
5.5 Escribe tus propias tareas de navegadorPráctica con la biblioteca Agent: Agent(url, goals) + run() para obtener el state paso a paso; cambiar una URL y un objetivo ya es una tarea nueva15 minutos
5.6 Resolución de problemas de UltrafastQué hacer si no conecta con Chrome (browser-harness --doctor), si TEXT_MODEL da error, o si no hace clic y se desvía; lista de lo no soportado: shadow DOM, canvas, subidas de archivos, aperturas de nuevas pestañas10 minutos
5.7 Jev 1.13 Manual de trampasLos 9 modos de fallo del documento oficial sobre jaggedness y sus alternativas: interpretación literal, conteo aritmético, comparación de fechas, referencias indirectas, state grande, contenido adversarial, instrucciones contradictorias, orden de opciones, necesidad de generación15 minutos

💡 El modelo de texto puede ser un modelo chino

El helper de texto de Ultrafast usa una interfaz compatible con OpenAI, y el README oficial dice claramente que Gemini, GLM y DeepSeek se pueden configurar; el endpoint por defecto cuando el código no define variables de entorno es DeepSeek (https://api.deepseek.com/v1 + deepseek-chat). Solo aparece cuando TYPE_TEXT—si no se configura TEXT_MODEL_API_KEY da error directamente; palabras textuales oficiales: no text is hardcoded or guessed.

⚠️ DONE no equivale a éxito

En Evidence and limits lo oficial lo dice sin rodeos: aunque se elija DONE hay que verificar el resultado de forma independiente (el verify() del ejemplo de Flights sirve exactamente para eso); el DOM reader solo reconoce controles comunes de HTML/ARIA, y shadow roots, frames, canvas, subidas de archivos, aperturas de nuevas pestañas, scroll anidado y componentes de teclado arbitrarios no están en este MVP. Una acción válida también puede ser errónea—la lección 4 y la lección 6 lo repetirán una y otra vez.

La última lección es relativamente independiente: lo oficial recopiló los problemas conocidos de Jev 1.13 en el documento de jaggedness—9 modos de fallo, cada uno con su alternativa. El documento indica que aplica a jev-1.13 (última revisión 2026-10-02), y lo oficial también dice que muchos se corregirán en versiones posteriores; pero hábitos de pregunta como «aritmética al código, fechas a componentes, state grande filtrado primero» valen la pena cultivarlos sin importar la versión que uses.

🎒 Lo que obtendrás ​

  • Un Agent de navegador que funciona: desde el clone hasta el inspector y hasta escribir tareas personalizadas con la biblioteca Agent, todo hecho en tu máquina
  • La forma correcta de leer los datos oficiales de rendimiento: los límites de cronometraje de los 7.073 segundos y cómo citar la comparación de muestra pequeña, sin exagerar ni denigrar
  • Conciencia de los límites de seguridad: la salida del modelo nunca se convierte en código ejecutable, DONE siempre debe verificarse de forma independiente, y tener presente la lista de controles no soportados
  • 9 modos de fallo en una lista de «síntoma → alternativa», para evitar activamente las trampas de Jev 1.13 al redactar preguntas

Fuera del navegador, si quieres ver los 15 casos completos de Jev en escenarios de API pura (filtrado de danmaku, control de RAG, extracción en cascada), revisa Escenarios en la práctica: elige tu ruta; para consultar el formato de solicitudes y los códigos de estado, ve a Referencia rápida de la API; versiones y precios de modelos en Modelos y precios.


¿Listo? Empieza la primera lección: Principios de Jev Ultrafast →

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.