Hamiltonova zastávka v boxech v Abú Zabí podle dat z API OpenF1

Piotr Grudzień
Publikováno 8 min čtení
Ilustrace červeného vozu Formule 1 vedle Hamiltonových časů průjezdu boxovou uličkou a stání v 8. kole

Lewis Hamilton strávil v 8. kole Velké ceny Abú Zabí 2025 v boxové uličce 21,601 sekundy. Jeho Ferrari stálo 2,4 sekundy. Oba údaje pocházejí z téže zastávky. V přehledu časů je v této části jeho závodu nejpomalejší až 9. kolo.

Celý průběh si můžete zrekonstruovat sami. Vytvoříte Stint Notebook, agenta v Quickchat AI, který čte data z OpenF1 API. Zeptejte se na tři kola před Hamiltonovou první zastávkou a tři po ní. Dostanete časy sedmi kol, údaj o přechodu z měkkých na tvrdé pneumatiky a odkazy na zdrojové záznamy.

Dva časy zastávky v boxech v 8. kole podle OpenF1 a pod nimi odpověď Quickchat AI se sedmi Hamiltonovými koly Při tomto místním spuštění vrátil Quickchat AI údaje o sedmi kolech a odkazy na veřejné záznamy zastávek v boxech, stintů na jedné sadě pneumatik a jednotlivých kol.

Stáhněte si sadu Stint Notebook. Obsahuje konfiguraci pěti akcí, Main Prompt, uložené odpovědi OpenF1 a krátký spustitelný skript v Pythonu. Data OpenF1 si můžete prohlížet bez účtu OpenF1 i bez přístupového tokenu k API. Ve druhém kroku se přihlásíte do Quickchat AI.

1. Kterou část závodního víkendu v Abú Zabí sledujete?

Začněte závodem a jezdcem. Víkend Velké ceny zahrnuje několik jízd a Hamilton ve všech používá číslo 44. Číslo kola má smysl až ve chvíli, kdy určíte konkrétní jízdu i jezdce.

  1. Otevřete záznam o jízdě v OpenF1. Najděte Race, Yas Marina Circuit a datum 7. prosince 2025. V každém požadavku ponechte session_key=9839.
  2. Otevřete záznam jezdce s číslem 44. Vrátí jméno Lewis Hamilton a tým Ferrari. Při přidávání akcí si tuto kartu nechte otevřenou.

Identifikátor závodu 9839 a Hamiltonovo číslo 44 propojují v OpenF1 záznamy zastávek, stintů a kol Ponechte stejný závod. Stačí změnit číslo jezdce a můžete položit stejnou otázku o jiném voze v témže závodě.

Vyzkoušejte příklad na úvodní stránce OpenF1. Vyberte Shell a klikněte na Run. Příklad vrátí údaje o prvních třech Hamiltonových kolech. V odpovědi ve formátu JSON najděte driver_number a lap_number.

Příklad OpenF1 pro Shell, tlačítko Run a vrácené údaje o kolech jezdce s číslem 44 Tento příklad vrátí kola 1 až 3. Později se při dotazu na zastávku v boxech budete ptát na kola 5 až 11.

OpenF1 nabízí historická data od roku 2023 pro osobní potřebu. V příručce k ověřování se dozvíte, jak získat přístup k živým datům.

2. Jak agentovi přidáte první dvě akce?

  1. Založte si účet v Quickchat AI nebo se přihlaste. Zvolte Add new AI Agent → Set up manually a agenta pojmenujte Stint Notebook. Na odpovědi AI a testy budete potřebovat kredity.
  2. Otevřete Identity → Main Prompt, vložte pokyny níže a uložte je. Určují, jaká data má agent shromáždit, než vysvětlí průběh kola.
  3. Přejděte do Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. Do pole API Action Name zadejte identify_session. Pole What to ask the user first nechte prázdné. V části API Endpoint zvolte GET a zadejte níže uvedenou adresu URL. Pole Headers a Body nechte prázdná.
  4. Do pole API Action Description vložte popis uvedený níže. Akci uložte a zapněte. Stejně postupujte u identify_driver. V této akci přidejte do What to ask the user first parametr driver_number, zvolte Number, označte ho jako povinný a pomocí Add AI Data → Parameters ho vložte do adresy URL.

Editor API Action v Quickchat AI s vyhledáním konkrétního závodu a koncovým bodem pro GET Závod je určený přímo v uložené adrese URL. Vyhledání jezdce je první akce, která potřebuje hodnotu z konverzace.

Zkopírujte Main Prompt pro 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.
Zkopírujte nastavení akcí pro závod a jezdce
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.

Otevřete AI Preview a položte otázku Which session is this, and is driver 44 in it? Než budete pokračovat, zkontrolujte datum závodu a Hamiltonovo jméno. Pokud nastavujete svou první akci, editorem vás provede návod na vytvoření agenta, který volá API.

3. Jak vyberete správných sedm kol?

Rozsah kol určete podle záznamu zastávky. Hamilton v tomto závodě zastavil dvakrát, v 8. a 31. kole. Vyberte první zastávku a vyžádejte si tři kola před ní a tři po ní. Dostanete 5. až 11. kolo včetně. Kdybyste se nejdřív zeptali na kola, agent by musel odhadovat, kde má hledat.

Přehled zastávky v osmém kole od Formule 1 vedle údajů OpenF1 o čase 21,601 s v boxové uličce a 2,4 s stání Oficiální přehled zastávek v boxech uvádí 21,601 sekundy. OpenF1 uvádí jak tento celkový čas v boxové uličce, tak dobu stání 2,4 sekundy, která je do něj započtena.

  1. V Custom Actions přidejte get_driver_pits a get_driver_stints. Obě akce přijímají stejný povinný parametr driver_number jako akce pro vyhledání jezdce. Pro zastávky použijte koncový bod pit v jednotném čísle a pro úseky na jednotlivých sadách pneumatik stints. Přehled polí OpenF1 popisuje údaje časomíry včetně staršího názvu pit_duration pro čas v boxové uličce.
  2. Přidejte get_driver_laps se třemi povinnými parametry typu Number. Pomocí Add AI Data vložte do adresy URL driver_number, first_lap a last_lap. V konfiguraci ponechte zakódované znaky. Výsledné filtry znamenají číslo kola ≥ první kolo a číslo kola ≤ poslední kolo.
  3. V Test Response zadejte 44, 5 a 11. Zkontrolujte první i poslední položku vráceného pole, akce uložte a všechny tři zapněte. Pro jednu otázku omezte načtení na deset kol. Tento limit určují pokyny pro agenta. Samotná adresa URL rozhraní API přijímá i širší rozsahy.

Akce pro načtení kol v Quickchat AI s parametry pro jezdce, první kolo a poslední kolo Obě hranice patří do jednoho požadavku GET. Pokud jedna chybí, může se načíst i zbytek závodu.

Zkopírujte nastavení akcí pro zastávky, stinty a kola
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. Co se změnilo v 8. a 9. kole?

V AI Preview odešlete Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Při čtení odpovědi začněte u záznamu zastávky. Osmé kolo je poslední, které OpenF1 řadí do stintu na měkkých pneumatikách. Deváté kolo je první na tvrdých pneumatikách a jediné v tomto úseku, u kterého má is_pit_out_lap hodnotu true.

Hamiltonův závod na 58 kol podle směsi pneumatik: měkká v kolech 1–8, tvrdá v kolech 9–31 a střední v kolech 32–58 Směs určíte podle toho, mezi které počáteční a koncové kolo stintu dané kolo spadá. Osmé kolo ještě patří do prvního stintu.

Číslo kolaČas kola (s)Směs pneumatikUdálost v boxech
590,229Měkká
690,254Měkká
790,539Měkká
892,249MěkkáVjezd do boxů
9108,500TvrdáVýjezd z boxů
1088,517Tvrdá
1189,022Tvrdá

Nejpomalejší kolo v tomto úseku trvalo 108,500 sekundy a zahrnuje návrat z boxů na trať. První celé kolo po něm trvalo 88,517 sekundy. Kdybyste oba časy porovnali jako běžná kola na stejné směsi, přehlédli byste výjezd z boxů, který je odlišuje. Všechny údaje si můžete projít v záznamech sedmi kol a ověřit si rozsahy stintů.

Hamiltonovy časy v 5. až 11. kole s vyznačeným výjezdovým kolem o délce 108,500 sekundy Zastávka v boxech a nejdelší čas kola jsou v sousedních řádcích. Příznak výjezdu z boxů ukazuje, které kolo při porovnávání tempa vynechat.

Zkuste si jeden výpočet. Rozbalte sadu a v její složce spusťte python3 worksheet.py. Skript vypíše všechna zahrnutá i vyřazená kola. Po vyřazení kola se zajetím do boxů, výjezdového kola a případných kol bez času zbývá pět kol s mediánem 90,229 sekundy. Výsledek popisuje vybraná kola na dvou směsích. Pokud chcete zkoumat tempo jednoho stintu, vyberte úsek uvnitř něj a uveďte, která kola jste vyřadili.

5. Jak ověříte výklad závodu od AI?

  1. Otevřete konverzaci v Inbox, rozbalte přehled spuštěných akcí a u akce pro načtení kol otevřete View logs. Při našem testu všech pět požadavků vrátilo HTTP 200. U požadavku na kola ověřte, že závodu 9839, jezdci 44 a hranicím 5 a 11 odpovídá sedm vrácených řádků.
  2. Položte otázku Did Hamilton pit because Ferrari wanted an undercut? Stint Notebook načetl obě zastávky a vysvětlil, že důvody rozhodnutí Ferrari ze záznamů nevyčtete. Dobu stání ověřte pomocí stop_duration v původním záznamu zastávky.
  3. Otevřete Testing → Simulation, vyberte Create Dataset, potom Paste messages a vložte testovací otázky ze stažené sady. Jednotlivé otázky oddělte řádkem, který obsahuje pouze ---. Sadu uložte a vyberte Run. Zahrňte dotaz na neznámého jezdce a žádost o živé sledování závodu. Při hledání jezdce číslo 999 vrátilo OpenF1 kód 404. Pokud záznam chybí, má agent požádat o platné číslo jezdce. Když čas chybí nebo služba vrátí dočasnou chybu, ponechte jej jako nedostupný.

Protokol volání pro načtení kol v Quickchat AI zobrazuje jezdce, obě hranice rozsahu kol a vrácenou odpověď V protokolu volání můžete porovnat skutečně odeslaný požadavek se zastávkou popsanou v odpovědi.

Testování v Quickchat AI s otázkami ze sady Stint Notebook o závodě a mezích dostupných údajů z časomíry Po změně popisu akce použijte stejné otázky. Zkontrolujte odpověď i data, která akce načetla.

Quickchat AI odpovídá na otázku o undercutu pomocí zaznamenaných zastávek v boxech a vysvětluje, co lze vyčíst z časomíry Záznamy dokládají, kdy Ferrari povolalo Hamiltona do boxů. V časomíře není žádné pole pro záměr týmu.

Co změnit při chybě 429. Při načítání kol jsme nasimulovali odpověď HTTP 429. Zbývající čtyři požadavky prošly a agent se o načtení kol pokusil dvakrát. Do popisu akce jsme doplnili pokyn, aby po dosažení limitu požadavků další pokus vynechal, a znovu jsme položili stejnou otázku. Tentokrát se pokusil jednou, uvedl ověřené údaje o zastávce a časy kol označil jako nedostupné. Při testování vlastní formulace můžete pokusy spočítat ve View logs.

Pokud už Quickchat AI spravujete z ChatGPT nebo z Claude, můžete asistentovi předat actions.json a main-prompt.txt ze sady a požádat ho, aby připravil pět akcí s metodou GET pro závod 9839. Před zapnutím akcí zkontrolujte jejich adresy URL. Spuštění testu čerpá kredity Quickchat AI.

Se Stint Notebook pokračujte k druhé zastávce. Zeptejte se na další Hamiltonovu výměnu pneumatik. Tentokrát by vás měl záznam zastávky dovést k 31. kolu a stint na střední směsi by měl začínat 32. kolem. Máte tak dva údaje, podle kterých si můžete odpověď ověřit ještě před čtením vysvětlení.

Časté otázky

Co ve Formuli 1 znamená stint na jedné sadě pneumatik?

Stint je série kol, která jezdec odjede na jedné sadě pneumatik. OpenF1 u každého stintu uvádí jeho číslo, směs a první a poslední kolo. Hamiltonův první stint v závodě v Abú Zabí v roce 2025 zahrnuje 1. až 8. kolo na měkkých pneumatikách.

Potřebuji k historickým datům OpenF1 klíč API?

Ne. OpenF1 zpřístupňuje pro osobní použití historická data z jízd od roku 2023 bez klíče. Konverzace a testy v Quickchat AI čerpají kredity. Pro živá data platí samostatné podmínky.

Jak dlouho trvala Hamiltonova první zastávka v boxech v Abú Zabí v roce 2025?

V 8. kole OpenF1 zaznamenalo 21,601 sekundy v boxové uličce a 2,4 sekundy stání. Na koncovém bodu pit se tato pole jmenují lane_duration a stop_duration. Doba stání je už zahrnuta v celkovém čase v boxové uličce.

Jak z OpenF1 API získám časy kol a směsi pneumatik ve Formuli 1?

Načtěte údaje z laps a stints pro stejné hodnoty session_key a driver_number. Pro každé lap_number použijte směs ze stintu, do jehož rozsahu od lap_start do lap_end dané kolo spadá. Koncový bod laps uvádí lap_duration v sekundách.

Dá se z těchto kol poznat, proč Ferrari povolalo Hamiltona do boxů?

Záznamy ukazují, kdy Hamilton zastavil, jak dlouho stál a na jakých pneumatikách pokračoval. Důvod rozhodnutí týmu z nich nezjistíte. K doložení strategie, jako je undercut, potřebujete údaje o soupeři a doklad o záměru týmu.

Mohu ze sedmi kol odhadnout tempo stintu?

Tento úsek můžete popsat, pokud uvedete, která kola jste zahrnuli. Skript vyřadí kolo se zajetím do boxů, výjezdová kola a kola bez zaznamenaného času. Pak vypíše počet zbývajících kol a jejich medián. Z úseku, který zahrnuje dvě směsi, nelze určit reprezentativní tempo ani jednoho stintu.

Quickchat AI Quickchat AI Ask Quickchat AI a question