Reconstruye la parada de Hamilton con la API de OpenF1

Piotr Grudzień
Publicado 9 min de lectura
Ilustración de un Fórmula 1 rojo junto a los tiempos de Hamilton en la vuelta 8, en el carril de boxes y con el coche parado

Lewis Hamilton pasó 21,601 segundos en el carril de boxes en la vuelta 8 del Gran Premio de Abu Dabi de 2025. Su Ferrari estuvo parado 2,4 segundos. Ambas mediciones corresponden a la misma parada. En la hoja de tiempos, la vuelta más larga de ese tramo de su carrera es la 9.

Puedes reconstruir la secuencia por tu cuenta. Vas a crear Stint Notebook, un agente de Quickchat AI que consulta la API de OpenF1. Pídele las tres vueltas anteriores y las tres posteriores a la primera parada de Hamilton. Obtendrás siete vueltas cronometradas, el cambio de neumáticos blandos a duros y enlaces a los registros en los que se basa la respuesta.

La respuesta de Quickchat AI sobre siete vueltas de Hamilton, debajo de los dos tiempos que registró OpenF1 para la parada en boxes de la vuelta 8 En esta prueba local, Quickchat AI devolvió los datos de siete vueltas y enlaces a los registros públicos de paradas en boxes, tandas con cada juego de neumáticos y vueltas.

Descarga el kit de Stint Notebook con las cinco configuraciones de las acciones, el Main Prompt, las respuestas guardadas de OpenF1 y un pequeño script de Python que puedes ejecutar. Puedes consultar los registros de OpenF1 sin cuenta de OpenF1 ni token de acceso a la API. En el paso 2 iniciarás sesión en Quickchat AI.

1. ¿Qué sesión de Abu Dabi estás consultando?

Empieza por la carrera y el piloto. Un fin de semana de Gran Premio tiene varias sesiones y Hamilton lleva el dorsal 44 en todas ellas. El número de vuelta solo tiene sentido una vez que has identificado la sesión y al piloto.

  1. Abre el registro de la sesión en OpenF1. Busca Race, Yas Marina Circuit y la fecha del 7 de diciembre de 2025. Conserva session_key=9839 en todas las peticiones.
  2. Abre el registro del piloto con el dorsal 44. Verás Lewis Hamilton y Ferrari. Deja esa pestaña abierta mientras añades las acciones.

El número de sesión 9839 de la carrera en OpenF1 y el dorsal 44 de Hamilton enlazan los registros de paradas, tandas y vueltas Mantén la misma carrera. Con solo cambiar el dorsal, puedes hacer la misma pregunta sobre otro coche de esa carrera.

Prueba el ejemplo de la página de inicio de OpenF1. Selecciona Shell y haz clic en Run. El ejemplo devuelve las tres primeras vueltas de Hamilton. Busca driver_number y lap_number en la respuesta JSON.

Ejemplo de Shell de OpenF1 con el botón Run y los datos de las vueltas del piloto número 44 Este ejemplo devuelve las vueltas 1 a 3. Más adelante, la pregunta sobre la parada en boxes abarca las vueltas 5 a 11.

OpenF1 ofrece datos históricos desde 2023 para uso personal. Su guía de autenticación explica cómo acceder a los datos en directo.

2. ¿Cómo configuras las dos primeras acciones del agente?

  1. Crea una cuenta en Quickchat AI o inicia sesión. Selecciona Add new AI Agent → Set up manually y ponle el nombre Stint Notebook. Necesitarás créditos para las respuestas de IA y las pruebas.
  2. Abre Identity → Main Prompt, pega las instrucciones de abajo y guarda los cambios. Le indican al agente qué datos debe reunir antes de explicar una vuelta.
  3. Ve a Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. En API Action Name, introduce identify_session. Deja vacío What to ask the user first. En API Endpoint, selecciona GET e introduce la URL que aparece a continuación. Deja vacíos Headers y Body.
  4. En API Action Description, introduce la descripción de abajo. Guarda la acción y actívala. Repite el proceso con identify_driver. Para esta segunda acción, añade driver_number en What to ask the user first, selecciona Number, marca el parámetro como obligatorio e insértalo en la URL con Add AI Data → Parameters.

Editor de API Action de Quickchat AI con la consulta a una carrera fija y su endpoint GET La carrera queda fijada en la URL guardada. La consulta del piloto es la primera acción que necesita un valor de la conversación.

Copia el Main Prompt de Stint Notebook
You are Stint Notebook. Help a race viewer inspect the completed 2025 Abu Dhabi Grand Prix, OpenF1 session 9839. Confirm the Race session and driver with Actions before reporting race facts. For Hamilton use driver 44 and verify his name. If a driver cannot be found, ask for a valid number. Run Actions one at a time. For a stop, fetch the driver's pit events and stints, then fetch at most ten laps around the selected stop. Three laps on either side means seven rows including the pit lap.
Start with the pit lap, lane_duration in seconds and stop_duration in seconds. Join each lap to its inclusive stint interval. For a lap window, show a compact Markdown table with Lap, Time (s), Tyre and Note. Use three decimal places for lap times. Note the recorded pit lap and the is_pit_out_lap flag; leave the other notes blank. Cite the exact OpenF1 pit, stint and bounded lap queries as short Markdown links.
Use only returned fields. Distinguish time in the pit lane from stationary time. A missing duration is unavailable. If a request fails, say which data you could not retrieve. Timing alone cannot establish team intent. For an aggregate, give the source rows and tell the reader to use the worksheet. Only answer historical questions on demand.
Copia la configuración de las acciones de sesión y piloto
identify_session
GET https://api.openf1.org/v1/sessions?session_key=9839
Identify the configured session. Check that session_name is Race, then report its date, circuit and session key.

identify_driver
GET https://api.openf1.org/v1/drivers?session_key=9839&driver_number={{driver_number}}
Resolve the driver by number within this race. Use full_name and driver_number from the response. If no record is found, ask for a valid number.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.

Abre AI Preview y pregunta Which session is this, and is driver 44 in it? Comprueba la fecha de la carrera y el nombre de Hamilton antes de seguir. Si es tu primera acción, la guía para crear un agente que consulta una API te orienta por el editor.

3. ¿Cómo encuentras las siete vueltas que necesitas?

Usa el registro de la parada para determinar el intervalo. Hamilton paró dos veces en esta carrera, en las vueltas 8 y 31. Elige la primera parada y pide tres vueltas antes y tres después. Así obtienes las vueltas 5 a 11, ambas incluidas. Si pidieras primero las vueltas, el agente tendría que adivinar dónde buscar.

Resumen de Fórmula 1 de la parada en boxes de la vuelta 8 junto a los campos de OpenF1 que muestran 21,601 segundos en el carril de boxes y 2,4 segundos con el coche parado El resumen de paradas en boxes de Fórmula 1 indica 21,601 segundos. OpenF1 registra tanto ese tiempo total en el carril de boxes como los 2,4 segundos que el coche estuvo parado durante la parada.

  1. En Custom Actions, añade get_driver_pits y get_driver_stints. Ambas acciones usan el mismo parámetro obligatorio driver_number que la consulta del piloto. Usa el endpoint en singular pit para las paradas y stints para los intervalos de cada juego de neumáticos. La referencia de campos de OpenF1 define los campos de cronometraje, incluido pit_duration, el alias anterior del tiempo en el carril de boxes.
  2. Añade get_driver_laps con tres parámetros obligatorios de tipo Number. Usa Add AI Data para insertar driver_number, first_lap y last_lap en la URL. Conserva los signos codificados tal como aparecen en la configuración. Los filtros resultantes se leen como número de vuelta ≥ primera vuelta y número de vuelta ≤ última vuelta.
  3. En Test Response, introduce 44, 5 y 11. Comprueba el primer y el último elemento de la lista devuelta, guarda las acciones y activa las tres. Limita esta acción a un máximo de diez vueltas por pregunta. El prompt pide que se respete ese límite. La URL de la API admite rangos más amplios.

Acción de consulta de vueltas en Quickchat AI con los parámetros de piloto, primera vuelta y última vuelta Los dos límites van en la misma petición GET. Si falta uno, la consulta puede devolver el resto de la carrera.

Copia la configuración de las acciones de paradas, tandas y vueltas
get_driver_pits
GET https://api.openf1.org/v1/pit?session_key=9839&driver_number={{driver_number}}
Retrieve recorded pit events for the confirmed driver. Identify the requested pit lap. lane_duration is total time in the pit lane, stop_duration is stationary time; both are seconds. Preserve missing values.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.

get_driver_stints
GET https://api.openf1.org/v1/stints?session_key=9839&driver_number={{driver_number}}
Retrieve tyre compounds and inclusive lap_start and lap_end boundaries for this driver. Use these intervals to label the pit and surrounding laps.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.

get_driver_laps
GET https://api.openf1.org/v1/laps?session_key=9839&driver_number={{driver_number}}&lap_number%3E={{first_lap}}&lap_number%3C={{last_lap}}
Retrieve an inclusive interval of at most ten laps after selecting the pit event. Use lap_number, lap_duration in seconds and is_pit_out_lap. Preserve null durations. If OpenF1 returns HTTP 429, stop and ask the reader to try later. Do not repeat the lap request in the same turn.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.
first_lap (Number, required): First lap number of the inclusive interval around the selected pit event.
last_lap (Number, required): Last lap number of the inclusive interval, at most nine above first_lap.

4. ¿Qué cambió entre las vueltas 8 y 9?

En AI Preview, envía Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Empieza a leer la respuesta por la parada y sigue con las vueltas cercanas. La vuelta 8 es la última que OpenF1 asigna a la tanda con blandos. La vuelta 9 es la primera con duros y la única fila del intervalo en la que is_pit_out_lap tiene el valor true.

Las 58 vueltas de la carrera de Hamilton, con blandos en las vueltas 1–8, duros en las 9–31 y medios en las 32–58 Para identificar el compuesto, sitúa la vuelta entre el inicio y el final de una tanda. La vuelta 8 todavía pertenece a la primera tanda.

N.º de vueltaTiempo por vuelta (s)CompuestoRegistro de boxes
590,229Blandos
690,254Blandos
790,539Blandos
892,249BlandosEntrada a boxes
9108,500DurosSalida de boxes
1088,517Duros
1189,022Duros

La vuelta más larga del tramo, de 108,500 segundos, incluye el regreso a la pista. La primera vuelta completa después de esa duró 88,517 segundos. Si comparas ambas filas como si fueran vueltas normales con el mismo compuesto, pasarás por alto que una de ellas es la vuelta de salida de boxes. Puedes revisar todas las cifras en los registros de las siete vueltas y comprobar los intervalos de cada compuesto.

Tiempos de Hamilton de la vuelta 5 a la 11, con la vuelta de salida de 108,500 segundos destacada La parada y el mayor tiempo por vuelta aparecen en filas consecutivas. El indicador de salida de boxes te señala qué vuelta debes apartar para comparar el ritmo.

Prueba un cálculo. Descomprime el kit y ejecuta python3 worksheet.py en la carpeta del kit. El script enumera las vueltas incluidas y las excluidas. Al excluir la vuelta de entrada a boxes, la de salida y las que no tengan tiempo registrado, quedan cinco vueltas con una mediana de 90,229 segundos. Esa mediana describe las vueltas seleccionadas, que abarcan dos compuestos. Para estudiar el ritmo de cualquiera de las dos tandas, elige un tramo dentro de ella e indica qué vueltas has excluido.

5. ¿Cómo compruebas la explicación de carrera que da la IA?

  1. Abre la conversación en Inbox, despliega las acciones que se ejecutaron y abre View logs en la acción de consulta de vueltas. En nuestra prueba, las cinco consultas devolvieron HTTP 200. En la llamada de vueltas, comprueba que la sesión 9839, el dorsal 44 y los límites 5 y 11 corresponden a las siete filas devueltas.
  2. Pregunta Did Hamilton pit because Ferrari wanted an undercut? Stint Notebook recuperó ambas paradas y explicó que los registros no permiten determinar por qué Ferrari tomó esa decisión. Para saber cuánto tiempo estuvo parado el coche, consulta stop_duration en el registro original de la parada.
  3. Abre Testing → Simulation, selecciona Create Dataset y después Paste messages. Pega las preguntas de prueba del kit. Separa cada pregunta de la siguiente con una línea que solo contenga ---. Guarda el conjunto de datos y selecciona Run. Incluye un piloto desconocido y una solicitud de actualizaciones en directo. Al consultar al proveedor por el piloto 999, recibimos un 404. Si una consulta no encuentra ningún registro, pide un número de piloto válido. Si OpenF1 devuelve una duración sin valor o un error temporal, deja ese dato como no disponible.

El registro de la llamada de vueltas en Quickchat AI muestra el dorsal, los dos límites del intervalo y la respuesta devuelta En el registro de llamadas puedes comparar la petición que se hizo con la parada que describe la respuesta.

Pruebas en Quickchat AI con las preguntas de Stint Notebook sobre la carrera y los límites de los datos de cronometraje Vuelve a usar las mismas preguntas después de cambiar la descripción de una acción. Revisa tanto la respuesta como los datos que recuperó la acción.

Quickchat AI responde a la pregunta sobre el undercut con las paradas en boxes registradas y explica hasta dónde llegan los datos de cronometraje Las paradas indican cuándo Ferrari llamó a Hamilton a boxes. Los datos de cronometraje no incluyen ningún campo que recoja la intención del equipo.

Un cambio que merece la pena probar. Simulamos un HTTP 429 en la consulta de vueltas mientras las otras cuatro consultas se completaban correctamente. El agente intentó consultar las vueltas dos veces. Añadimos a la descripción de la acción de consulta de vueltas una instrucción para que se detuviera al alcanzar el límite de solicitudes y repetimos la misma pregunta. Esta vez hizo un solo intento, informó de la parada en boxes que había podido verificar y dejó los tiempos por vuelta como no disponibles. Puedes contar los intentos en View logs cuando pruebes tu propia redacción.

Si ya gestionas Quickchat AI desde ChatGPT o Claude, puedes darle a ese asistente actions.json y main-prompt.txt del kit y pedirle que prepare las cinco acciones GET para la sesión 9839. Revisa las URL antes de activarlas. Ejecutar una prueba consume créditos de Quickchat AI.

Usa el cuaderno para seguir la segunda parada. Pregunta por el siguiente cambio de neumáticos de Hamilton. Esta vez, el registro de la parada debería llevarte a la vuelta 31, y la primera vuelta de la tanda con medios debería ser la 32. Ya tienes dos puntos donde comprobar la respuesta antes incluso de leer la explicación.

Preguntas frecuentes

¿Qué es una tanda de neumáticos en Fórmula 1?

Una tanda es la secuencia de vueltas que un piloto completa con un mismo juego de neumáticos. OpenF1 asigna a cada tanda un número, un compuesto y una vuelta de inicio y de fin. En la carrera de Abu Dabi de 2025, la primera tanda de Hamilton abarca las vueltas 1 a 8 con neumáticos blandos.

¿Necesito una clave de API para consultar los datos históricos de OpenF1?

No. OpenF1 ofrece acceso sin clave a los datos históricos de sesiones desde 2023 para uso personal. Quickchat AI consume créditos en las conversaciones y las pruebas. El acceso en directo tiene sus propios requisitos.

¿Cuánto duró la primera parada en boxes de Hamilton en Abu Dabi en 2025?

En la vuelta 8, OpenF1 registra 21,601 segundos en el carril de boxes y 2,4 segundos con el coche parado. En el endpoint pit, estos campos se llaman lane_duration y stop_duration. El tiempo con el coche parado ya está incluido en el total del carril de boxes.

¿Cómo consulto los tiempos por vuelta y los compuestos de neumáticos de F1 en la API de OpenF1?

Consulta laps y stints para los mismos valores de session_key y driver_number. Para cada lap_number, usa el valor de compound de la tanda cuyo intervalo entre lap_start y lap_end incluya esa vuelta. El endpoint laps devuelve lap_duration en segundos.

¿Se puede saber por estas vueltas por qué Ferrari llamó a Hamilton a boxes?

Los registros muestran cuándo paró Hamilton, cuánto tiempo estuvo parado y qué neumáticos montó a continuación. La decisión del equipo no figura en esos datos. Para determinar si hubo una estrategia como el undercut, hacen falta datos sobre un rival y pruebas de la intención del equipo.

¿Puedo usar las siete vueltas para estimar el ritmo de una tanda?

Puedes describir ese tramo si indicas qué vueltas has incluido. El script de Python excluye la vuelta de entrada a boxes, las vueltas de salida y las vueltas sin tiempo registrado, e indica cuántas quedan y cuál es su mediana. Un tramo que abarca dos compuestos no permite establecer un ritmo representativo de ninguna de las dos tandas.

Quickchat AI Quickchat AI Ask Quickchat AI a question