Rekonstruér Hamiltons pitstop i Abu Dhabi med OpenF1 API’et

Piotr Grudzień
Udgivet 8 min læsning
Illustration af en rød Formel 1-bil ved siden af Hamiltons tid i pitlanen og tid i stilstand på omgang 8

Lewis Hamilton tilbragte 21,601 sekunder i pitlanen på omgang 8 af Abu Dhabis Grand Prix i 2025. Hans Ferrari stod stille i 2,4 sekunder. Begge tider stammer fra samme pitstop. På tidsskemaet er omgang 9 den længste i den del af hans løb.

Du kan selv rekonstruere forløbet. Du bygger Stint Notebook, en agent i Quickchat AI, der læser data fra OpenF1 API’et. Bed om tre omgange på hver side af Hamiltons første pitstop, så får du syv omgange med tider, skiftet fra bløde til hårde dæk og links til dataene bag svaret.

OpenF1s to tidsmålinger for pitstoppet på omgang 8 med svaret fra Quickchat AI om syv af Hamiltons omgange nedenunder Ved denne lokale kørsel viste Quickchat AI syv omgange og links til de offentlige data for pitstop, dækstints og enkelte omgange.

Download Stint Notebook-pakken med opskrifter på de fem handlinger, Main Prompt, gemte svar fra OpenF1 og et lille Python-script, du kan køre. Du kan læse data fra OpenF1 uden en OpenF1-konto eller et API-token. I trin 2 logger du ind på Quickchat AI.

1. Hvilken session i Abu Dhabi ser du på?

Begynd med løbet og køreren. En Grand Prix-weekend består af flere sessioner, og Hamilton kører med nummer 44 i dem alle. Et omgangsnummer giver først mening, når du har fastlagt både sessionen og køreren.

  1. Åbn sessionsdataene i OpenF1. Find Race, Yas Marina Circuit og datoen 7. december 2025. Behold session_key=9839 i hver forespørgsel.
  2. Åbn kørerdataene for nummer 44. Opslaget returnerer Lewis Hamilton og Ferrari. Lad fanen stå åben, mens du tilføjer handlingerne.

OpenF1’s løbssession 9839 og Hamiltons kørernummer 44 knytter pitstop, stint og omgange sammen Hold løbet fast. Ved blot at ændre kørernummeret kan du stille det samme spørgsmål om en anden bil i løbet.

Prøv eksemplet på OpenF1’s forside. Vælg Shell, og klik på Run. Eksemplet henter Hamiltons første tre omgange. Find driver_number og lap_number i JSON-svaret.

OpenF1’s Shell-eksempel med knappen Run og de hentede omgangsdata for kører nummer 44 Dette eksempel henter omgang 1 til 3. Spørgsmålet om pitstoppet senere i guiden gælder omgang 5 til 11.

OpenF1 tilbyder historiske data fra 2023 og frem til privat brug. I vejledningen om godkendelse kan du læse, hvordan du får adgang til livedata.

2. Hvordan giver du agenten dens første to handlinger?

  1. Opret en konto hos Quickchat AI, eller log ind. Vælg Add new AI Agent → Set up manually, og giv agenten navnet Stint Notebook. Du skal bruge kreditter til AI-svar og test.
  2. Åbn Identity → Main Prompt, indsæt instruktionerne nedenfor, og gem. De fortæller agenten, hvilke data den skal indsamle, før den forklarer en omgang.
  3. Gå til Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. Skriv identify_session i API Action Name. Lad What to ask the user first stå tomt. Vælg GET under API Endpoint, og indsæt URL’en nedenfor. Lad Headers og Body stå tomme.
  4. Indsæt beskrivelsen nedenfor i API Action Description. Gem handlingen, og slå den til. Gentag med identify_driver. For den handling tilføjer du driver_number under What to ask the user first, vælger Number, gør parameteren obligatorisk og indsætter den i URL’en med Add AI Data → Parameters.

Editoren til API Action i Quickchat AI med det faste løbsopslag og GET-endpointet Løbet er fastlagt i den gemte URL. Køreropslaget er den første handling, der skal bruge en værdi fra samtalen.

Kopiér Main Prompt til 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.
Kopiér indstillingerne for sessions- og køreropslag
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.

Åbn AI Preview, og spørg Which session is this, and is driver 44 in it? Kontrollér, at svaret indeholder løbsdatoen og Hamiltons navn, før du går videre. Hvis det er din første handling, gennemgår guiden til at bygge en agent, der kalder et API editoren trin for trin.

3. Hvordan finder du de rigtige syv omgange?

Lad pitdataene bestemme intervallet. Hamilton gik i pit to gange i løbet, på omgang 8 og 31. Vælg det første pitstop, og bed om tre omgange før og tre efter. Det giver omgang 5 til og med 11. Hvis du beder om omgangene først, må agenten gætte, hvor den skal lede.

Formel 1’s pitstopoversigt for omgang 8 ved siden af OpenF1-felterne for 21,601 sekunder i pitlanen og 2,4 sekunder i stilstand Formel 1’s pitstopoversigt angiver 21,601 sekunder. OpenF1 registrerer både den samlede tid i pitlanen og de 2,4 sekunder i stilstand, der indgår i den.

  1. Tilføj get_driver_pits og get_driver_stints under Custom Actions. Begge bruger samme obligatoriske driver_number som køreropslaget. Brug endpointet pit i ental til pitstop og stints til dækkenes omgangsintervaller. OpenF1’s feltreference beskriver tidsfelterne, herunder pit_duration, det ældre alias for tiden i pitlanen.
  2. Tilføj get_driver_laps med tre obligatoriske parametre af typen Number. Brug Add AI Data til at indsætte driver_number, first_lap og last_lap i URL’en. Behold de kodede tegn fra opskriften. Filtrene betyder omgangsnummer ≥ første omgang og omgangsnummer ≤ sidste omgang.
  3. Indtast 44, 5 og 11 i Test Response. Kontrollér den første og sidste række i det returnerede array, gem handlingerne, og slå alle tre til. Hold denne handling på højst ti omgange pr. spørgsmål. Prompten angiver grænsen. Selve API-URL’en accepterer større intervaller.

Handlingen til omgangstider i Quickchat AI med parametre for kører, første omgang og sidste omgang Begge grænser skal med i samme GET-forespørgsel. Hvis en grænse mangler, kan resten af løbet komme med.

Kopiér indstillingerne for opslag af pitstop, stint og omgange
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. Hvad ændrede sig på omgang 8 og 9?

Send Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. i AI Preview. Tag udgangspunkt i pitstoppet, når du læser svaret. Omgang 8 er den sidste omgang, OpenF1 regner med til stintet på bløde dæk. Omgang 9 er den første på hårde dæk og den eneste række i intervallet, hvor is_pit_out_lap er sat til true.

Hamiltons løb på 58 omgange med bløde dæk på omgang 1–8, hårde på 9–31 og mediumdæk på 32–58 Find dæktypen ved at placere omgangen mellem stintets første og sidste omgang. Omgang 8 hører stadig til det første stint.

OmgangOmgangstid (sek.)DæktypePitregistrering
590,229Bløde
690,254Bløde
790,539Bløde
892,249BlødeIndkørsel i pit
9108,500HårdeUdkørsel fra pit
1088,517Hårde
1189,022Hårde

Den længste omgang i intervallet, 108,500 sekunder, omfatter turen fra pit og tilbage ud på banen. Den første fulde omgang derefter tog 88,517 sekunder. Hvis du sammenligner de to rækker som almindelige omgange på samme dæktype, overser du udkørslen fra pit. Du kan gennemgå alle tallene i dataene for de syv omgange og kontrollere dækkenes omgangsintervaller.

Hamiltons omgangstider fra omgang 5 til 11, med udomgangen på 108,500 sekunder markeret Pitstoppet og den længste omgangstid står på to rækker lige efter hinanden. Markeringen for udomgangen viser, hvilken omgang du skal udelade, når du sammenligner tempo.

Prøv selv at regne på omgangene. Pak Stint Notebook-pakken ud, og kør python3 worksheet.py i den udpakkede mappe. Scriptet viser alle omgange, både dem, der tæller med, og dem, der er udeladt. Når du udelader pitomgangen, udomgangen og eventuelle omgange uden tid, står du tilbage med fem omgange med en median på 90,229 sekunder. Det beskriver de udvalgte omgange på tværs af to dæktyper. Hvis du vil undersøge tempoet i et af de to stint, skal du vælge et interval inden for det pågældende stint og angive, hvilke omgange du udelader.

5. Hvordan kontrollerer du AI’ens forklaring af løbet?

  1. Åbn samtalen i Inbox, fold de kaldte handlinger ud, og vælg View logs for handlingen til omgangstider. I vores test gav alle fem opslag HTTP 200. Kontrollér, at opslaget med session 9839, kører 44 og grænserne 5 og 11 svarer til de syv returnerede rækker.
  2. Spørg Did Hamilton pit because Ferrari wanted an undercut? Stint Notebook hentede begge pitstop og forklarede, at Ferrari-holdets begrundelse ikke fremgår af dataene. Kontrollér tiden i stilstand i feltet stop_duration i de oprindelige pitdata.
  3. Åbn Testing → Simulation, vælg Create Dataset og derefter Paste messages, og indsæt testspørgsmålene fra pakken. En linje, der kun indeholder ---, adskiller hvert spørgsmål fra det næste. Gem datasættet, og vælg Run. Medtag en ukendt kører og en anmodning om liveopdateringer. Vores opslag hos dataleverandøren gav 404 for kører 999. Bed om et gyldigt kørernummer, når opslaget ikke giver noget resultat. Hvis en tid mangler i svaret fra OpenF1, eller OpenF1 returnerer en midlertidig fejl, skal værdien stå som utilgængelig.

Kaldeloggen for omgangsopslaget i Quickchat AI viser køreren, begge omgangsgrænser og det returnerede svar I kaldeloggen kan du sammenholde den faktiske forespørgsel med det pitstop, svaret beskriver.

Testing i Quickchat AI med spørgsmålene fra Stint Notebook om løbet og om, hvad tidsdataene kan vise Brug de samme spørgsmål, når du har ændret beskrivelsen af en handling. Kontrollér både svaret og de data, handlingen hentede.

Quickchat AI svarer på spørgsmålet om et undercut med de registrerede pitstop og forklarer, hvor meget tidsdataene kan vise Pitstoppene viser, hvornår Ferrari kaldte Hamilton i pit. Tidsdataene har intet felt for holdets hensigt.

En ændring, du kan teste. Vi simulerede et HTTP 429-svar på omgangsopslaget, mens de fire øvrige opslag lykkedes. Agenten forsøgte at hente omgangene to gange. Vi tilføjede en instruktion i beskrivelsen af handlingen til omgangstider om at stoppe, hvis grænsen for antal forespørgsler blev nået, og kørte samme spørgsmål igen. Denne gang forsøgte agenten én gang, oplyste det verificerede pitstop og angav omgangstiderne som utilgængelige. Du kan tælle forsøgene i View logs, når du tester din egen formulering.

Hvis du allerede administrerer Quickchat AI fra ChatGPT eller Claude, kan du give assistenten actions.json og main-prompt.txt fra pakken og bede den om at klargøre de fem GET-handlinger til session 9839. Gennemgå deres URL’er, før du slår dem til. Når du kører en test, bruger du kreditter i Quickchat AI.

Følg løbet frem til andet pitstop. Spørg til Hamiltons næste dækskift. Denne gang bør pitdataene pege på omgang 31, og første omgang i stintet på mediumdæk bør være 32. Du har nu to steder, hvor du kan kontrollere svaret, inden du læser forklaringen.

Ofte stillede spørgsmål

Hvad er et dækstint i Formel 1?

Et dækstint er de omgange, en kører tilbagelægger på samme sæt dæk. OpenF1 angiver stintets nummer, dæktype samt første og sidste omgang. Hamiltons første stint i Abu Dhabi-løbet i 2025 strækker sig fra omgang 1 til 8 på bløde dæk.

Skal jeg bruge en API-nøgle til historiske data fra OpenF1?

Nej. OpenF1 giver adgang til historiske data fra sessioner fra 2023 og frem til privat brug uden API-nøgle. Quickchat AI bruger kreditter på samtaler og test. Der gælder særskilte krav til liveadgang.

Hvor længe varede Hamiltons første pitstop i Abu Dhabi i 2025?

OpenF1 registrerer 21,601 sekunder i pitlanen og 2,4 sekunder i stilstand på omgang 8. I pit-endpointet hedder felterne lane_duration og stop_duration. Tiden i stilstand er allerede medregnet i den samlede tid i pitlanen.

Hvordan henter jeg F1-omgangstider og dæktyper fra OpenF1 API’et?

Hent laps og stints med samme session_key og driver_number. For hvert lap_number bruger du dæktypen fra det stint, hvor omgangen ligger mellem lap_start og lap_end, begge inklusive. Endpointet laps angiver lap_duration i sekunder.

Kan de her omgange vise, hvorfor Ferrari kaldte Hamilton i pit?

Dataene viser, hvornår Hamilton gik i pit, hvor længe bilen stod stille, og hvilke dæk han kørte videre på. Holdets beslutning fremgår ikke. Hvis du vil fastslå, om der var tale om en strategi som et undercut, skal du have oplysninger om en konkurrent og om holdets hensigt.

Kan jeg bruge de syv omgange til at vurdere tempoet i et stint?

Du kan beskrive tempoet i intervallet, hvis du angiver, hvilke omgange du har taget med. Det lille Python-script udelader pitomgangen, udomgange og omgange uden registreret tid og viser antal og median. Et interval, der strækker sig over to dæktyper, kan ikke bruges til at fastslå et repræsentativt tempo for nogen af de to stint.

Quickchat AI Quickchat AI Ask Quickchat AI a question