Пит-стоп Хэмилтона в Абу-Даби по данным API OpenF1

Piotr Grudzień
Опубликовано Время чтения: 8 мин
Красный болид Формулы-1 рядом с данными о времени Хэмилтона на пит-лейне и времени остановки на восьмом круге

На 8-м круге Гран-при Абу-Даби 2025 года Льюис Хэмилтон провёл на пит-лейне 21,601 секунды. Его Ferrari стояла на месте 2,4 секунды. Оба значения относятся к одному пит-стопу. По данным хронометража, самым длинным на этом участке гонки оказался 9-й круг.

Эту последовательность можно восстановить самостоятельно. Вы создадите Stint Notebook, агента Quickchat AI, который получает данные через API OpenF1. Попросите показать по три круга до и после первого пит-стопа Хэмилтона. В ответе будут времена семи кругов, сведения о переходе с мягких шин на жёсткие и ссылки на исходные записи.

Ответ Quickchat AI о семи кругах Хэмилтона под двумя замерами OpenF1 для пит-стопа на восьмом круге При этом локальном запуске Quickchat AI вернул данные о семи кругах и ссылки на открытые записи о пит-стопах, отрезках на одном комплекте шин и отдельных кругах.

Скачайте набор Stint Notebook. В нём пять инструкций по настройке действий, Main Prompt, сохранённые ответы OpenF1 и небольшой скрипт на Python. Читать данные OpenF1 можно без аккаунта OpenF1 и без токена API. На втором шаге вы войдёте в Quickchat AI.

1. Как найти нужную сессию в Абу-Даби?

Начните с гонки и гонщика. В программу гоночного уик-энда входит несколько сессий, и в каждой Хэмилтон выступает под номером 44. Чтобы понять, о каком круге идёт речь, сначала определите сессию и гонщика.

  1. Откройте запись OpenF1 о сессии. Найдите Race, Yas Marina Circuit и дату 7 декабря 2025 года. Передавайте session_key=9839 в каждом запросе.
  2. Откройте запись о гонщике под номером 44. В ней указаны Льюис Хэмилтон и Ferrari. Оставьте эту вкладку открытой, пока добавляете действия.

Номер гоночной сессии OpenF1 9839 и номер Хэмилтона 44 связывают записи о пит-стопах, шинных отрезках и кругах Оставьте ту же гонку. Чтобы задать тот же вопрос о другом болиде в этой гонке, достаточно сменить номер гонщика.

Попробуйте пример на главной странице OpenF1. Выберите Shell и нажмите Run. Пример возвращает данные первых трёх кругов Хэмилтона. Найдите driver_number и lap_number в ответе в формате JSON.

Пример Shell на сайте OpenF1, кнопка Run и полученные данные кругов гонщика под номером 44 Этот пример возвращает круги с 1-го по 3-й. Дальше, в вопросе о пит-стопе, понадобятся круги с 5-го по 11-й.

OpenF1 предоставляет исторические данные с 2023 года для личного использования. В руководстве по аутентификации описано, как получить доступ к данным в реальном времени.

2. Как настроить первые два действия агента?

  1. Создайте аккаунт Quickchat AI или войдите в него. Выберите Add new AI Agent → Set up manually и назовите агента Stint Notebook. Для ответов агента и тестов понадобятся кредиты.
  2. Откройте Identity → Main Prompt, вставьте приведённые ниже инструкции и сохраните их. В них указано, какие данные агент должен собрать, прежде чем объяснять, что произошло на круге.
  3. Перейдите в Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. В API Action Name введите identify_session. Оставьте What to ask the user first пустым. В API Endpoint выберите GET и введите указанный ниже URL. Оставьте Headers и Body пустыми.
  4. В API Action Description внесите описание ниже. Сохраните и включите действие. Повторите настройку для identify_driver. В этом действии добавьте driver_number в What to ask the user first, выберите Number, сделайте параметр обязательным и вставьте его в URL через Add AI Data → Parameters.

Редактор API Action в Quickchat AI с запросом GET для поиска заранее выбранной гоночной сессии Гонка уже задана в сохранённом URL. Для поиска гонщика впервые понадобится значение из диалога.

Скопировать Main Prompt для 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.
Скопировать настройки действий для поиска сессии и гонщика
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.

Откройте AI Preview и задайте вопрос Which session is this, and is driver 44 in it? Прежде чем продолжить, найдите в ответе дату гонки и имя Хэмилтона. Если вы впервые настраиваете действие, воспользуйтесь руководством по созданию агента, который обращается к API.

3. Как выбрать нужные семь кругов?

Определите диапазон по записи о пит-стопе. В этой гонке Хэмилтон дважды заезжал в боксы, на 8-м и 31-м кругах. Возьмите первый пит-стоп и запросите по три круга до и после него. Получится диапазон с 5-го по 11-й круг включительно. Если сначала запросить круги, агенту придётся гадать, с какого круга начинать.

Сводка Формулы-1 о пит-стопе на 8-м круге рядом с полями OpenF1, где указаны 21,601 секунды на пит-лейне и 2,4 секунды стоянки В сводке Формулы-1 по пит-стопам указано 21,601 секунды. OpenF1 приводит и это общее время на пит-лейне, и входящие в него 2,4 секунды стоянки.

  1. В Custom Actions добавьте get_driver_pits и get_driver_stints. Для обоих действий нужен тот же обязательный параметр driver_number, что и для поиска гонщика. Для пит-стопов используйте эндпоинт pit в единственном числе, а для шинных отрезков используйте stints. В справочнике по полям OpenF1 описаны поля хронометража, в том числе прежнее альтернативное имя pit_duration для времени на пит-лейне.
  2. Добавьте get_driver_laps с тремя обязательными параметрами типа Number. Через Add AI Data вставьте driver_number, first_lap и last_lap в URL. Сохраните закодированные знаки из инструкции. Получатся два условия номер круга ≥ номер первого круга и номер круга ≤ номер последнего круга.
  3. В Test Response введите 44, 5 и 11. Проверьте первую и последнюю записи в полученном массиве, сохраните действия и включите все три. Запрашивайте через это действие не более десяти кругов за один вопрос. Такое ограничение задано в инструкции для агента. Сам URL API принимает и более широкие диапазоны.

Действие для запроса кругов в Quickchat AI с параметрами гонщика, первого и последнего кругов Обе границы диапазона должны быть в одном запросе GET. Если пропустить одну из них, в ответ могут попасть все остальные круги до начала или до конца гонки.

Скопировать настройки действий для пит-стопов, шинных отрезков и кругов
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. Что изменилось на 8-м и 9-м кругах?

В AI Preview отправьте Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Начните разбор ответа с записи о пит-стопе. В OpenF1 8-й круг числится последним на мягких шинах. 9-й круг был первым на жёстких шинах. Это единственная строка в выбранном диапазоне, где у is_pit_out_lap стоит значение true.

Шинные отрезки Хэмилтона в гонке из 58 кругов. Мягкие шины на кругах 1–8, жёсткие на кругах 9–31 и средние на кругах 32–58 Чтобы определить состав шин, найдите отрезок, в границы которого входит нужный круг. 8-й круг ещё относится к первому отрезку.

Номер кругаВремя круга (с)Состав шинОтметка о пит-стопе
590,229Мягкие
690,254Мягкие
790,539Мягкие
892,249МягкиеЗаезд в боксы
9108,500ЖёсткиеВыезд из боксов
1088,517Жёсткие
1189,022Жёсткие

Самый длинный круг в этом диапазоне занял 108,500 секунды и включал выезд из боксов обратно на трассу. Первый полный круг после него занял 88,517 секунды. Если сравнить эти две строки как обычные круги на одном составе шин, из сравнения выпадет главное различие между ними. Все числа можно сверить с записями о семи кругах и данными о шинных отрезках.

Время Хэмилтона на кругах с 5-го по 11-й с отметкой о круге выезда из боксов за 108,500 секунды Пит-стоп и самое большое время круга стоят в соседних строках. Отметка о выезде из боксов показывает, какой круг исключить при сравнении темпа.

Попробуйте сделать один расчёт. Распакуйте набор и запустите python3 worksheet.py в папке с его файлами. Скрипт перечислит все учтённые и исключённые круги. Если исключить круг заезда в боксы, круг выезда из боксов и записи без времени круга, останутся пять кругов с медианой 90,229 секунды. Это показатель для выбранных кругов на двух составах шин. Чтобы оценить темп на одном отрезке, выберите круги в его пределах и укажите, какие из них исключили.

5. Как проверить объяснение гонки от ИИ?

  1. Откройте диалог в Inbox, разверните список вызванных действий и выберите View logs у действия для запроса кругов. В нашем тесте все пять запросов вернули HTTP 200. Проверьте, что запрос с сессией 9839, номером гонщика 44 и границами 5 и 11 вернул семь строк.
  2. Спросите Did Hamilton pit because Ferrari wanted an undercut? Stint Notebook нашёл оба пит-стопа и объяснил, что по этим записям нельзя установить, чем руководствовалась Ferrari. Чтобы проверить время стоянки, найдите stop_duration в исходной записи о пит-стопе.
  3. Откройте Testing → Simulation, выберите Create Dataset, затем Paste messages и вставьте тестовые вопросы из набора. Вопросы разделяются строкой, в которой стоит только ---. Сохраните набор и выберите Run. Включите в тест вопрос о неизвестном гонщике и запрос данных в реальном времени. Для номера 999 наш запрос к поставщику данных вернул 404. Если запись не найдена, попросите пользователя указать действительный номер гонщика. Если OpenF1 не вернул время круга или выдал временную ошибку, укажите, что значение недоступно.

Журнал запроса кругов в Quickchat AI показывает номер гонщика, обе границы диапазона и полученный ответ В журнале вызовов можно сверить фактический запрос с пит-стопом, который описан в ответе.

Раздел Testing в Quickchat AI с вопросами для Stint Notebook о гонке и о том, что можно установить по хронометражу После изменения описания действия задайте те же вопросы. Проверьте и ответ агента, и данные, которые получило действие.

Quickchat AI отвечает на вопрос о подрезке по записям о пит-стопах и объясняет, где заканчиваются возможности хронометража По записям о пит-стопах видно, когда Ferrari позвала Хэмилтона в боксы. В данных хронометража нет поля для намерений команды.

Проверьте, как агент реагирует на лимит запросов. Мы смоделировали ответ HTTP 429 на запрос кругов. Остальные четыре запроса прошли успешно. Агент отправил запрос кругов дважды. Мы добавили в описание действия указание прекратить попытки при достижении лимита запросов и снова задали тот же вопрос. На этот раз агент сделал одну попытку, сообщил подтверждённые данные о пит-стопе и указал, что время кругов недоступно. Проверяя свою формулировку, можно подсчитать попытки в View logs.

Если вы уже управляете Quickchat AI через ChatGPT или Claude, передайте этому помощнику actions.json и main-prompt.txt из набора и попросите подготовить пять действий с запросами GET для сессии 9839. Проверьте их URL перед включением. На запуск теста расходуются кредиты Quickchat AI.

Разберите в Stint Notebook второй пит-стоп. Спросите, когда Хэмилтон в следующий раз сменил шины. Запись о пит-стопе должна указать на 31-й круг, а первым кругом на средних шинах должен быть 32-й. Теперь у вас есть два значения, по которым можно проверить ответ ещё до чтения объяснения.

Частые вопросы

Что такое шинный стинт в Формуле-1?

Стинт — это серия кругов, которые гонщик проезжает на одном комплекте шин. Для каждого отрезка OpenF1 указывает его номер, состав шин, первый и последний круги. В гонке в Абу-Даби в 2025 году первый отрезок Хэмилтона на мягких шинах охватывал круги с первого по восьмой.

Нужен ли ключ API для доступа к историческим данным OpenF1?

Нет. Для личного использования OpenF1 даёт доступ без ключа к историческим данным сессий начиная с 2023 года. В Quickchat AI на диалоги и тесты расходуются кредиты. Для доступа к данным в реальном времени действуют отдельные требования.

Сколько длился первый пит-стоп Хэмилтона в Абу-Даби в 2025 году?

По данным OpenF1, на 8-м круге Хэмилтон провёл на пит-лейне 21,601 секунды, из них 2,4 секунды болид стоял на месте. В эндпоинте pit это поля lane_duration и stop_duration. Время стоянки уже входит в общее время на пит-лейне.

Как получить время кругов и составы шин Формулы-1 через API OpenF1?

Запросите данные у эндпоинтов laps и stints с одинаковыми значениями session_key и driver_number. Для каждого lap_number возьмите состав шин того отрезка, в диапазон которого от lap_start до lap_end входит этот круг. Эндпоинт laps возвращает lap_duration в секундах.

Можно ли по этим кругам понять, почему Ferrari позвала Хэмилтона в боксы?

По записям видно, когда Хэмилтон заехал на пит-стоп, сколько времени болид простоял на месте и на каких шинах он поехал дальше. Причину решения команды эти данные не раскрывают. Чтобы установить, что команда применила, например, подрезку, нужны данные о сопернике и подтверждение намерений команды.

Можно ли по семи кругам оценить темп на шинном отрезке?

Можно описать темп на выбранных кругах, если указать, какие круги вошли в расчёт. Скрипт исключает круг заезда в боксы, круги выезда из боксов и записи без времени круга, а затем выводит число учтённых кругов и медиану. По выборке с двумя составами шин нельзя определить типичный темп ни одного из двух отрезков.

Quickchat AI Quickchat AI Ask Quickchat AI a question