На восьмому колі Гран-прі Абу-Дабі 2025 року Льюїс Гамільтон провів на піт-лейні 21,601 секунди. Його Ferrari стояла нерухомо 2,4 секунди. Обидва показники стосуються однієї зупинки. А от у таблиці хронометражу найдовше на цьому відрізку гонки тривало дев’яте коло.
Ви можете самі відтворити цю послідовність. Для цього створіть Stint Notebook, агента Quickchat AI, який читає дані через API OpenF1. Попросіть показати три кола до першого піт-стопу Гамільтона й три після. У відповіді будуть часи семи кіл, перехід із м’яких шин на жорсткі та посилання на записи, за якими можна все перевірити.
Під час цього локального тесту Quickchat AI повернув дані про сім кіл і посилання на відкриті записи про піт-стопи, відрізки на одному комплекті шин та окремі кола.
Завантажте комплект Stint Notebook. У ньому є налаштування п’яти дій, текст для Main Prompt, збережені відповіді OpenF1 і невеликий скрипт на Python. Переглядати дані OpenF1 можна без облікового запису OpenF1 і без токена API. На другому кроці ви ввійдете в Quickchat AI.
1. Яку сесію в Абу-Дабі ви аналізуєте?
Спочатку визначте гонку й пілота. Гран-прі складається з кількох сесій, і в кожній із них Гамільтон виступає під номером 44. За номером кола можна знайти потрібний запис лише тоді, коли відомі і сесія, і пілот.
- Відкрийте запис OpenF1 про сесію. Знайдіть
Race,Yas Marina Circuitта дату 7 грудня 2025 року. Залиштеsession_key=9839в кожному запиті. - Відкрийте запис про пілота з номером 44. У відповіді вказано ім’я Lewis Hamilton і команду Ferrari. Залиште цю вкладку відкритою, поки додаватимете дії.
Використовуйте ту саму гонку. Достатньо змінити номер пілота, щоб поставити таке саме запитання про інший болід у цій гонці.
Спробуйте приклад на головній сторінці OpenF1. Виберіть Shell і натисніть Run. Приклад повертає дані перших трьох кіл Гамільтона. Знайдіть driver_number і lap_number у відповіді у форматі JSON.
Цей приклад повертає кола з 1-го до 3-го. Далі, у запитанні про піт-стоп, знадобляться кола з 5-го до 11-го.
OpenF1 надає архівні дані від 2023 року для особистого використання. У посібнику з автентифікації пояснено, як отримати доступ до даних у реальному часі.
2. Як додати агенту перші дві дії?
- Створіть обліковий запис у Quickchat AI або увійдіть у свій. Виберіть Add new AI Agent → Set up manually і назвіть агента Stint Notebook. Для відповідей агента й тестів потрібні кредити.
- Відкрийте Identity → Main Prompt, вставте наведені нижче інструкції та збережіть їх. Вони визначають, які дані агент має зібрати, перш ніж пояснювати, що відбулося на колі.
- Перейдіть до Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. У API Action Name введіть
identify_session. Поле What to ask the user first залиште порожнім. У розділі API Endpoint виберіть GET і введіть наведену нижче адресу. Поля Headers і Body залиште порожніми. - У API Action Description введіть опис, наведений нижче. Збережіть дію та ввімкніть її. Повторіть ці кроки для
identify_driver. Для цієї дії додайте в What to ask the user first параметрdriver_number, виберіть Number, позначте його як обов’язковий та вставте в URL через Add AI Data → Parameters.
Ідентифікатор гонки вже є в збереженій адресі. Пошук пілота — перша дія, якій потрібне значення з розмови.
Скопіювати 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. Як відібрати саме ті сім кіл?
Визначте діапазон за записом про піт-стоп. У цій гонці Гамільтон двічі заїжджав у бокси, на восьмому та 31-му колах. Виберіть першу подію й запитайте про три кола перед нею та три після. Так ви отримаєте кола з п’ятого до одинадцятого включно. Якби ви одразу запросили кола, агенту довелося б вгадувати, де шукати.
В офіційному зведенні про піт-стопи Формула-1 вказує 21,601 секунди. OpenF1 наводить як цей загальний час на піт-лейні, так і 2,4 секунди зупинки, що входять до нього.
- У Custom Actions додайте
get_driver_pitsіget_driver_stints. Обидві дії отримують той самий обов’язковий параметрdriver_number, що й дія пошуку пілота. Для зупинок використовуйте кінцеву точку pit в однині, а для стінтів на одному комплекті шин вкажіть stints. У довіднику полів OpenF1 описано поля хронометражу, зокрема стару назвуpit_durationдля часу на піт-лейні. - Додайте
get_driver_lapsз трьома обов’язковими параметрами типу Number. Через Add AI Data вставте в URL параметриdriver_number,first_lapіlast_lap. Збережіть закодовані знаки з прикладу. Фільтри вимагають, щоб виконувалися обидві умови, номер кола ≥ перше коло і номер кола ≤ останнє коло. - У Test Response введіть 44, 5 і 11. Перевірте перший і останній елементи отриманого масиву, збережіть дії та ввімкніть усі три. Обмежте дію для кіл десятьма колами на запитання. Таке обмеження задають інструкції для агента, а сама адреса API приймає й ширші діапазони.
Обидві межі вказують у тому самому запиті 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. Що змінилося на восьмому й дев’ятому колах?
У AI Preview надішліть Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Читайте відповідь, відштовхуючись від самого піт-стопу. Восьме коло є останнім, яке OpenF1 зараховує до стінту на м’яких шинах. Дев’яте коло є першим на жорстких шинах і єдиним у цьому діапазоні, для якого поле is_pit_out_lap має значення true.
Щоб визначити склад шин, знайдіть стінт, між першим і останнім колами якого лежить потрібне коло. Восьме коло ще належить до першого стінту.
| Номер кола | Час кола (с) | Склад шин | Подія на піт-лейні |
|---|---|---|---|
| 5 | 90,229 | М’які | |
| 6 | 90,254 | М’які | |
| 7 | 90,539 | М’які | |
| 8 | 92,249 | М’які | Заїзд у бокси |
| 9 | 108,500 | Жорсткі | Виїзд із боксів |
| 10 | 88,517 | Жорсткі | |
| 11 | 89,022 | Жорсткі |
Найдовше коло на цьому відрізку тривало 108,500 секунди. У цей час увійшов виїзд із боксів на трасу. Перше повне коло після нього тривало 88,517 секунди. Якщо порівняти ці рядки як два звичайні кола на однаковій гумі, різниця між ними загубиться. Кожен показник можна перевірити у записах семи кіл, а склад шин уточнити за межами стінтів.
Піт-стоп і найдовше коло розташовані в сусідніх рядках. Позначка виїзду з боксів підказує, яке коло варто відкласти, коли порівнюєте темп.
Спробуйте розрахувати медіану. Розпакуйте комплект і виконайте python3 worksheet.py у його каталозі. Скрипт покаже, які кола він врахував, а які пропустив. Після вилучення кола заїзду, кола виїзду й кіл без часу залишаються п’ять кіл із медіаною 90,229 секунди. Це результат для вибраних кіл на двох складах шин. Щоб оцінити темп окремого стінту, виберіть кола в його межах і вкажіть, які з них ви виключили.
5. Як перевірити пояснення гонки, яке дає ШІ?
- Відкрийте розмову в Inbox, розгорніть перелік викликаних дій, а потім відкрийте View logs для дії, що завантажує кола. У нашому тесті всі п’ять запитів отримали HTTP 200. Перевірте в журналі, чи відповідають сім отриманих рядків сесії 9839, пілоту 44 та діапазону від 5 до 11.
- Поставте запитання
Did Hamilton pit because Ferrari wanted an undercut?Stint Notebook знайшов обидва піт-стопи й пояснив, що ці записи не розкривають мотивів Ferrari. Щоб перевірити час зупинки, знайдітьstop_durationу вихідному записі про піт-стоп. - Відкрийте Testing → Simulation, виберіть Create Dataset, потім Paste messages і вставте тестові запитання з комплекту. Між сусідніми запитаннями залиште рядок, що містить тільки
---. Збережіть набір і виберіть Run. Додайте запит про невідомого пілота та прохання стежити за гонкою в реальному часі. Коли ми шукали пілота з номером 999, OpenF1 повернув 404. Якщо запису немає, агент має попросити дійсний номер пілота. Якщо час відсутній або сталася тимчасова помилка, показник залишається недоступним.
Журнал викликів дає змогу зіставити фактично надісланий запит із піт-стопом, який описує агент.
Після зміни опису дії повторіть ті самі запитання. Перевірте і відповідь, і дані, які агент отримав через дію.
За записами видно, коли Ferrari покликала Гамільтона в бокси. Поля для намірів команди в хронометражі немає.
Як змінити реакцію на помилку 429. Ми змоделювали HTTP 429 під час запиту кіл. Інші чотири запити завершилися успішно, а запит про кола агент надіслав двічі. До опису цієї дії ми додали вказівку зупинятися після досягнення ліміту запитів і повторили те саме запитання. Цього разу агент зробив одну спробу, повідомив перевірені дані про піт-стоп і вказав, що часи кіл недоступні. Під час перевірки власного формулювання спроби можна порахувати у View logs.
Якщо ви вже керуєте Quickchat AI з ChatGPT або Claude, передайте асистенту файли actions.json і main-prompt.txt з комплекту й попросіть підготувати п’ять дій GET для сесії 9839. Перед увімкненням перевірте їхні URL. На запуск тесту витрачаються кредити Quickchat AI.
Перейдіть до другого піт-стопу. Запитайте про наступну зміну шин Гамільтона. Цього разу в записі про піт-стоп має бути 31-ше коло, а стінт на шинах середньої жорсткості має початися з 32-го кола. Так ви можете перевірити відповідь за двома записами ще до того, як прочитаєте пояснення.
Поширені запитання
Що таке стінт у Формулі-1?
Стінт — це серія кіл, які пілот проїжджає на одному комплекті шин. Для кожного стінту OpenF1 вказує його номер, склад шин, перше й останнє кола. У гонці в Абу-Дабі 2025 року перший стінт Гамільтона тривав з першого до восьмого кола включно. Ці кола він проїхав на м’яких шинах.
Чи потрібен ключ API для доступу до архівних даних OpenF1?
Ні. Для особистого використання OpenF1 відкриває без ключа дані сесій починаючи з 2023 року. На розмови й тести у Quickchat AI витрачаються кредити. Для доступу до даних у реальному часі діють окремі умови.
Скільки тривав перший піт-стоп Гамільтона в Абу-Дабі у 2025 році?
За даними OpenF1, на восьмому колі Гамільтон провів 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 покликала Гамільтона в бокси?
У записах видно, коли Гамільтон зупинився, скільки простояв і на яких шинах продовжив гонку. Причину рішення команди там не вказано. Щоб підтвердити таку стратегію, як андеркат, знадобляться дані про суперника й свідчення про наміри команди.
Чи можна за цими сімома колами оцінити темп на стінті?
Ви можете описати темп на вибраному відрізку, якщо зазначите, які кола врахували. Скрипт відкидає коло заїзду в бокси, кола виїзду та кола без тривалості, а потім виводить кількість решти кіл і медіану часу. Відрізок, що охоплює дві суміші шин, не дає репрезентативного темпу для жодного зі стінтів.