Hamilton abu-dzabi bokszkiállása az OpenF1 API adataiból

Piotr Grudzień
Megjelent 8 perc olvasás
Piros Forma-1-es autó illusztrációja Hamilton 8. körös bokszutcai ideje és állóideje mellett

Lewis Hamilton 21,601 másodpercet töltött a bokszutcában a 2025-ös Abu-dzabi Nagydíj 8. körében. A Ferrarija 2,4 másodpercig állt a bokszhelyén. Mindkét adat ugyanahhoz a kiálláshoz tartozik. A köridők listáján a futam ezen szakaszában a 9. kör a leghosszabb.

Te is rekonstruálhatod az események sorrendjét. Ehhez elkészíted a Stint Notebookot, egy Quickchat AI-ügynököt, amely az OpenF1 API-ból olvas. Kérd le Hamilton első kiállásának körét és az előtte, illetve utána megtett három-három kört. A válaszban hét köridőt, a lágy gumiról a keményre váltást és az adatok forrásaira mutató linkeket kapsz.

A Quickchat AI válasza Hamilton hét köréről a 8. körös bokszkiállás két OpenF1-időadata alatt A helyi teszt során a Quickchat AI hét kör adatait adta vissza, valamint hivatkozásokat a bokszkiállások, az egy gumiszettel megtett etapok és az egyes körök nyilvános adataira.

Töltsd le a Stint Notebook csomagját. Benne van az öt művelet beállítása, a Main Prompt szövege, az OpenF1 mentett válaszai és egy rövid, futtatható Python-szkript. Az OpenF1 adatait OpenF1-fiók és API-token nélkül is megnézheted. A 2. lépésben a Quickchat AI-ba jelentkezel be.

1. Melyik abu-dzabi esemény adatait nézed?

Kezdd a futammal és a pilótával. Egy nagydíjhétvégén több esemény is van, Hamilton pedig mindegyiken a 44-es rajtszámot viseli. A körszám akkor azonosít egy konkrét kört, ha az eseményt és a pilótát is rögzítetted.

  1. Nyisd meg az OpenF1 eseményadatlapját. Keresd meg Race és Yas Marina Circuit értékét, valamint a dátumot, 2025. december 7. Minden kérésben tartsd meg session_key=9839 értékét.
  2. Nyisd meg a 44-es rajtszámhoz tartozó pilótaadatlapot. A válaszban Lewis Hamilton és a Ferrari szerepel. Hagyd nyitva a lapot, amíg hozzáadod a műveleteket.

Az OpenF1-ben a 9839-es futamazonosító és Hamilton 44-es rajtszáma kapcsolja össze a kiállások, a gumietapok és a körök adatait A futam azonosítója maradjon ugyanaz. Ha csak a rajtszámot módosítod, ugyanazt a kérdést a futam egy másik autójáról is felteheted.

Próbáld ki az OpenF1 főoldalán található példát. Válaszd a Shell fület, majd kattints a Run gombra. A példa Hamilton első három körének adatait adja vissza. Keresd meg a JSON-válaszban a driver_number és a lap_number mezőt.

Az OpenF1 Shell-példája, a Run gomb és a 44-es rajtszámú versenyző köreinek adatai a válaszban Ez a példa az 1. körtől a 3. körig ad vissza adatokat. A bokszkiállásról később feltett kérdés az 5. körtől a 11. körig terjedő szakaszra vonatkozik.

Az OpenF1 2023-tól kínál archív adatokat személyes használatra. A hitelesítési útmutató bemutatja, hogyan férhetsz hozzá az élő adatokhoz.

2. Hogyan adod hozzá az ügynök első két műveletét?

  1. Hozz létre Quickchat AI-fiókot, vagy jelentkezz be. Válaszd az Add new AI Agent → Set up manually lehetőséget, és nevezd el az ügynököt Stint Notebook néven. Az AI válaszaihoz és a tesztekhez kreditekre lesz szükséged.
  2. Nyisd meg az Identity → Main Prompt beállítást, illeszd be az alábbi utasításokat, majd mentsd őket. Ezek adják meg az ügynöknek, milyen adatokat gyűjtsön össze, mielőtt értelmez egy kört.
  3. Lépj az Actions & MCPs → Custom Actions → Add Action → API Action → Create manually menüpontra. Az API Action Name mezőbe írd be ezt az értéket: identify_session. A What to ask the user first mezőt hagyd üresen. Az API Endpoint résznél válaszd a GET metódust, és add meg az alábbi URL-t. A Headers és a Body mezőt hagyd üresen.
  4. Az API Action Description mezőbe írd be az alábbi leírást. Mentsd a műveletet, majd kapcsold be. Ismételd meg a beállítást identify_driver esetében is. Ennél a műveletnél a What to ask the user first mezőben add hozzá driver_number értékét, válaszd a Number típust, jelöld kötelezőnek a paramétert, majd illeszd be az URL-be az Add AI Data → Parameters lehetőséggel.

A Quickchat AI API Action szerkesztője a rögzített futamlekérdezéssel és a GET-végponttal A futam azonosítója a mentett URL része. A pilóta lekérdezése az első művelet, amely a beszélgetésből vesz át egy értéket.

Másold ki a Stint Notebook Main Prompt szövegét
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.
Másold ki a futam- és pilótalekérdezés beállításait
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.

Nyisd meg az AI Preview felületet, és kérdezz rá a futamra. Which session is this, and is driver 44 in it? Mielőtt továbblépsz, keresd meg a válaszban a futam dátumát és Hamilton nevét. Ha most állítasz be először műveletet, a útmutató az API-t hívó ügynök létrehozásához végigvezet a szerkesztőn.

3. Hogyan találod meg a megfelelő hét kört?

A kiállás adata alapján jelöld ki a köröket. Hamilton kétszer állt ki ezen a futamon, a 8. és a 31. körben. Válaszd az első kiállást, majd kérd le a kiállás körét és az előtte, illetve utána megtett három-három kört. Így az 5. körtől a 11. körig minden kör bekerül. Ha a körökkel kezdenéd, az ügynöknek találgatnia kellene, hol keresse a kiállást.

A Forma-1 összesítője a 8. körös kiállásról, mellette az OpenF1 mezői a 21,601 másodperces bokszutcai idővel és a 2,4 másodperces állóidővel A Forma-1 bokszkiállás-összesítőjében 21,601 másodperc szerepel. Az OpenF1 a teljes bokszutcai időt és az azon belüli 2,4 másodperces állóidőt is rögzíti.

  1. A Custom Actions résznél add hozzá get_driver_pits és get_driver_stints műveletét. Mindkettő ugyanazt a kötelező driver_number paramétert várja, mint a pilóta lekérdezése. A kiállásokhoz az egyes számú pit, a gumietapokhoz a stints végpontot használd. Az OpenF1 mezőleírása ismerteti az időmérési mezőket, köztük a bokszutcai idő korábbi pit_duration mezőnevét is.
  2. Add hozzá get_driver_laps műveletét három kötelező, Number típusú paraméterrel. Az Add AI Data lehetőséggel illeszd be az URL-be driver_number, first_lap és last_lap értékét. Hagyd meg a beállításban szereplő kódolt jeleket. A két szűrő feltétele körszám ≥ első körszám és körszám ≤ utolsó körszám.
  3. A Test Response résznél add meg a 44, 5 és 11 értéket. Ellenőrizd a visszakapott tömb első és utolsó elemét, mentsd a műveleteket, és kapcsold be mindhármat. Ezzel a művelettel kérdésenként legfeljebb tíz kört kérj le. Ezt a korlátot a prompt írja elő. Az API URL-je szélesebb tartományt is elfogad.

A köröket lekérdező művelet a Quickchat AI-ban, a pilóta rajtszámával, valamint az első és az utolsó kör paraméterével Mindkét határérték ugyanabba a GET-kérésbe kerüljön. Ha valamelyik hiányzik, a futam többi körét is visszaadhatja a lekérdezés.

Másold ki a kiállásokat, a gumietapokat és a köröket lekérdező műveletek beállításait
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. Mi változott a 8. és a 9. körben?

Az AI Preview felületen küldd el a következő kérdést. Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. A válaszban indulj ki a kiállásból, majd nézd meg a körülötte lévő köröket. Az OpenF1 szerint a 8. kör a lágy gumis etap utolsó köre. A 9. kör az első a kemény gumikon, és ebben a tartományban csak ennél a sornál veszi fel is_pit_out_lap a true értéket.

Hamilton 58 körös futama gumikeverékek szerint, lágy az 1–8., kemény a 9–31., közepes a 32–58. körben Úgy találod meg a gumikeveréket, hogy megnézed, melyik etap első és utolsó köre közé esik az adott kör. A 8. kör még az első etaphoz tartozik.

KörszámKöridő (mp)GumikeverékBokszesemény
590,229Lágy
690,254Lágy
790,539Lágy
892,249LágyBokszbejárat
9108,500KeményBokszkijárat
1088,517Kemény
1189,022Kemény

A szakasz leghosszabb köre, 108,500 másodperc, a pályára való visszatérést is magában foglalja. Az ezt követő első teljes kör 88,517 másodpercig tartott. Ha két szokásos, azonos keveréken megtett körként hasonlítanád össze őket, elsikkadna, hogy az egyik kivezető kör volt. Minden számot visszakereshetsz a hét kör adatai között, és ellenőrizheted a gumietapok körhatárait.

Hamilton köridői az 5. körtől a 11. körig, a 108,500 másodperces kivezető kör jelölésével A kiállás és a legmagasabb köridő egymás melletti sorban szerepel. A kivezető kör jelölése mutatja, melyik kört hagyd ki a tempó összehasonlításából.

Próbálj ki egy számítást. Csomagold ki a készletet, majd a könyvtárában futtasd ezt a parancsot: python3 worksheet.py. A szkript felsorolja az összes figyelembe vett és kihagyott kört. A kiállás körét, a kivezető kört és a köridő nélküli sorokat kihagyva öt kör marad, 90,229 másodperces mediánnal. Ez az érték két különböző keveréken futott köröket jellemez. Ha valamelyik etap tempóját vizsgálod, válassz az etapon belüli szakaszt, és add meg, mely köröket hagytad ki.

5. Hogyan ellenőrzöd, amit az AI a futamról mond?

  1. Nyisd meg a beszélgetést az Inbox felületen, bontsd ki a meghívott műveletek listáját, majd a körlekérdezésnél válaszd a View logs lehetőséget. A próbánkban mind az öt lekérdezés HTTP 200 választ adott. A körlekérdezésnél vesd össze a 9839-es futamazonosítót, a 44-es rajtszámot, valamint az 5-ös és 11-es határértéket a visszakapott hét sorral.
  2. Tedd fel a következő kérdést. Did Hamilton pit because Ferrari wanted an undercut? A Stint Notebook mindkét kiállást lekérte, és elmagyarázta, hogy az adatokból nem derül ki a Ferrari döntésének oka. Az állóidő ellenőrzéséhez keresd meg stop_duration értékét a kiállás eredeti bejegyzésében.
  3. Nyisd meg a Testing → Simulation felületet, válaszd a Create Dataset, majd a Paste messages lehetőséget, és illeszd be a csomag tesztkérdéseit. A kérdések közé tegyél egy külön sort, amelyben csak --- szerepel. Mentsd az adatkészletet, majd válaszd a Run lehetőséget. Legyen benne kérdés egy ismeretlen pilótáról és egy kérés élő frissítésekre is. A 999-es rajtszám lekérdezésére az adatszolgáltató 404-es választ adott. Ha a lekérdezés nem talál bejegyzést, kérj érvényes rajtszámot. Ha az OpenF1 válaszából hiányzik a köridő, vagy átmeneti hibát jelez, jelöld az értéket nem elérhetőként.

A Quickchat AI körlekérdezési naplójában látszik a pilóta, mindkét határkör és a visszakapott válasz A hívásnaplóban szereplő tényleges kérést összevetheted a válaszban leírt kiállással.

Tesztelés a Quickchat AI-ban a Stint Notebook futamra és az időmérési adatok korlátaira vonatkozó kérdéseivel Egy művelet leírásának módosítása után használd ugyanazokat a kérdéseket. Nézd meg a választ és a művelettel lekért adatokat is.

A Quickchat AI a rögzített kiállások alapján válaszol az elévágásra vonatkozó kérdésre, és megmutatja, meddig lehet következtetni az időmérési adatokból A kiállásokból látszik, mikor hívta ki a Ferrari Hamiltont. Az időmérési adatok között nincs mező a csapat szándékára.

Egy módosítás, amelyet érdemes kipróbálni. A körök lekérdezésénél HTTP 429-es hibát szimuláltunk, miközben a másik négy lekérdezés sikerült. Az ügynök kétszer próbálta lekérni a köröket. A művelet leírásába beírtuk, hogy a lekérdezési korlát elérésekor álljon le, majd újra feltettük ugyanazt a kérdést. Ezúttal egyszer próbálkozott, közölte az ellenőrzött kiállási adatokat, a köridőket pedig nem elérhetőként jelölte. Amikor a saját megfogalmazásodat teszteled, a View logs felületen megszámolhatod a próbálkozásokat.

Ha már a ChatGPT vagy a Claude felületéről kezeled a Quickchat AI-t, add át az asszisztensnek a csomagból actions.json és main-prompt.txt tartalmát, és kérd meg, hogy készítse elő az öt GET-műveletet a 9839-es futamhoz. Bekapcsolás előtt ellenőrizd az URL-eket. A teszt futtatása Quickchat AI-krediteket használ.

Nézd meg a második kiállást is a Stint Notebookkal. Kérdezz rá Hamilton következő gumicseréjére. Ezúttal a kiállás adatainak a 31. körre kell mutatniuk, a közepes gumis etap első köre pedig a 32. legyen. Így már a magyarázat elolvasása előtt két ponton ellenőrizheted a választ.

Gyakori kérdések

Mit jelent a gumietap a Forma-1-ben?

A gumietap azokból az egymást követő körökből áll, amelyeket a pilóta ugyanazon a gumiszetten teljesít. Az OpenF1 minden etaphoz megadja a sorszámot, a gumikeveréket, valamint az első és az utolsó kört. Hamilton első etapja a 2025-ös abu-dzabi futamon az 1. körtől a 8. körig tartott, lágy gumikon.

Kell API-kulcs az OpenF1 archív adataihoz?

Nem. Az OpenF1 a 2023-tól rendezett események archív adatait személyes használatra API-kulcs nélkül teszi elérhetővé. A Quickchat AI-ban a beszélgetések és a tesztek krediteket használnak. Az élő adatok elérésére külön feltételek vonatkoznak.

Mennyi ideig tartott Hamilton első kiállása a 2025-ös Abu-dzabi Nagydíjon?

Az OpenF1 szerint Hamilton a 8. körben 21,601 másodpercet töltött a bokszutcában, ebből 2,4 másodpercet álló helyzetben a bokszhelyén. A pit végponton e két mező neve lane_duration és stop_duration. A teljes bokszutcai idő már tartalmazza az állóidőt.

Hogyan kérhetem le az F1-es köridőket és gumikeverékeket az OpenF1 API-ból?

Kérd le a laps és a stints adatait ugyanazzal a session_key és driver_number értékkel. Minden lap_number értékhez annak az etapnak a keverékét rendeld, amelynek lap_start és lap_end értéke közé esik az adott kör, a határokat is beleértve. A laps végpont a lap_duration mezőben másodpercben adja meg a köridőt.

Kiderül ezekből a körökből, miért hívta ki a Ferrari Hamiltont?

Az adatokból látszik, mikor állt ki Hamilton, mennyi ideig állt a bokszhelyén, és milyen gumikon folytatta. A csapat döntésének okát az adatok nem rögzítik. Egy olyan taktika igazolásához, mint az elévágás, az ellenfélről és a csapat szándékáról is kell bizonyíték.

Becsülhető az etaptempó ebből a hét körből?

Jellemezheted ezt a szakaszt, ha megadod, mely köröket vetted figyelembe. A Python-szkript kihagyja a kiállás körét, a kivezető köröket és azokat a köröket, amelyekhez nincs köridő. Megadja a figyelembe vett körök számát és a mediánjukat. Ha a szakasz két keveréket érint, egyik etap jellemző tempóját sem lehet belőle megállapítani.

Quickchat AI Quickchat AI Ask Quickchat AI a question