Lewis Hamilton passou 21,601 segundos no pit lane na volta 8 do GP de Abu Dhabi de 2025. Sua Ferrari ficou parada por 2,4 segundos. Os dois tempos vêm da mesma parada. Na cronometragem, porém, a volta mais demorada desse trecho da corrida é a 9.
Você pode reconstituir essa sequência. Vamos montar o Stint Notebook, um agente do Quickchat AI que consulta a API OpenF1. Peça as três voltas anteriores e posteriores à primeira parada de Hamilton. Você verá sete tempos de volta, a troca dos pneus macios pelos duros e os links para conferir cada dado.
Neste teste local, o Quickchat AI retornou os dados de sete voltas e links para os registros públicos de paradas nos boxes, trechos com cada jogo de pneus e voltas individuais.
Baixe o kit Stint Notebook para obter a configuração das cinco ações, o Main Prompt, as respostas salvas do OpenF1 e um pequeno script em Python. Você pode consultar os registros do OpenF1 sem conta no OpenF1 nem token de API. No passo 2, você vai entrar no Quickchat AI.
1. Qual sessão do GP de Abu Dhabi você vai analisar?
Comece pela corrida e pelo piloto. Um fim de semana de Grande Prêmio tem várias sessões, e Hamilton usa o número 44 em todas elas. O número de uma volta só identifica a passagem que interessa depois que você fixa a sessão e o piloto.
- Abra o registro da sessão no OpenF1. Procure
Race,Yas Marina Circuite a data 7 de dezembro de 2025. Mantenhasession_key=9839em todas as requisições. - Abra o registro do piloto de número 44. Ele traz Lewis Hamilton e Ferrari. Deixe a aba aberta enquanto adiciona as ações.
Mantenha a mesma corrida. Basta trocar o número do piloto para fazer a mesma pergunta sobre outro carro naquela prova.
Experimente o exemplo na página inicial do OpenF1. Selecione Shell e clique em Run. O exemplo retorna as três primeiras voltas de Hamilton. Procure driver_number e lap_number na resposta em JSON.
Este exemplo retorna as voltas de 1 a 3. Mais adiante, a pergunta sobre o pit stop pede as voltas de 5 a 11.
O OpenF1 oferece dados históricos desde 2023 para uso pessoal. O guia de autenticação explica como acessar os dados ao vivo.
2. Como configurar as duas primeiras ações do agente?
- Crie uma conta no Quickchat AI ou entre na sua. Selecione Add new AI Agent → Set up manually e dê o nome Stint Notebook ao agente. As respostas da IA e os testes consomem créditos.
- Abra Identity → Main Prompt, cole as instruções abaixo e salve. Elas orientam o agente sobre quais registros buscar antes de explicar uma volta.
- Acesse Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. Em API Action Name, digite
identify_session. Deixe What to ask the user first em branco. Em API Endpoint, selecione GET e insira a URL abaixo. Deixe Headers e Body em branco. - Em API Action Description, insira a descrição abaixo. Salve e ative a ação. Repita com
identify_driver. Para essa ação, adicionedriver_numberem What to ask the user first, escolha Number, marque o parâmetro como obrigatório e insira-o na URL com Add AI Data → Parameters.
A corrida faz parte da URL salva. A busca do piloto é a primeira ação que usa um valor vindo da conversa.
Copiar o Main Prompt do 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.
Copiar a configuração das ações de sessão e piloto
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.
Abra AI Preview e pergunte: Which session is this, and is driver 44 in it? Confira a data da corrida e o nome de Hamilton antes de prosseguir. Se esta for sua primeira ação, consulte o guia para criar um agente que chama uma API para conhecer o editor.
3. Como encontrar as sete voltas certas?
Deixe que o registro da parada determine o intervalo. Hamilton parou duas vezes nessa corrida, nas voltas 8 e 31. Selecione a primeira parada e solicite as três voltas anteriores e as três seguintes. Assim, você obtém as voltas de 5 a 11, inclusive. Se você pedir as voltas primeiro, o agente terá de adivinhar onde procurar.
O resumo das paradas nos boxes da Fórmula 1 indica 21,601 segundos. O OpenF1 registra tanto esse tempo total no pit lane quanto os 2,4 segundos que o carro ficou parado dentro desse intervalo.
- Em Custom Actions, adicione
get_driver_pitseget_driver_stints. As duas usam o mesmodriver_numberobrigatório da consulta do piloto. Use o endpoint no singular pit para as paradas e stints para os intervalos de uso dos pneus. A referência de campos do OpenF1 define os campos de cronometragem, incluindopit_duration, o nome alternativo mais antigo para o tempo no pit lane. - Adicione
get_driver_lapscom três parâmetros obrigatórios do tipo Number. Use Add AI Data para inserirdriver_number,first_lapelast_lapna URL. Mantenha os sinais codificados como no exemplo. Os filtros resultantes significam número da volta ≥ volta inicial e número da volta ≤ volta final. - Em Test Response, insira 44, 5 e 11. Confira o primeiro e o último item da lista retornada, salve as Actions e ative as três. Limite essa Action a dez voltas por pergunta. O prompt pede esse limite. A URL da API aceita intervalos maiores.
Os dois limites devem ficar na mesma requisição GET. Se faltar um deles, a consulta pode trazer o restante da corrida.
Copiar a configuração das Actions de paradas, stints e voltas
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. O que mudou nas voltas 8 e 9?
Em AI Preview, envie Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Leia a resposta começando pela parada. A volta 8 é a última que o OpenF1 atribui ao stint com pneus macios. A volta 9 é a primeira com pneus duros e a única linha desse intervalo em que is_pit_out_lap tem o valor true.
Para identificar o composto, veja em qual stint o número da volta se encaixa, considerando a volta inicial e a final. A volta 8 ainda faz parte do primeiro stint.
| Número da volta | Tempo de volta (s) | Composto | Registro dos boxes |
|---|---|---|---|
| 5 | 90,229 | Macios | |
| 6 | 90,254 | Macios | |
| 7 | 90,539 | Macios | |
| 8 | 92,249 | Macios | Entrada nos boxes |
| 9 | 108,500 | Duros | Saída dos boxes |
| 10 | 88,517 | Duros | |
| 11 | 89,022 | Duros |
A volta mais longa do intervalo, de 108,500 segundos, inclui o trajeto de volta à pista. A primeira volta completa depois dela levou 88,517 segundos. Tratar essas duas linhas como voltas normais com o mesmo composto esconderia a diferença entre elas. Você pode conferir cada número nos sete registros de volta e consultar os intervalos de uso dos pneus.
O registro da parada e o maior tempo de volta aparecem em linhas consecutivas. O indicador de saída dos boxes mostra qual volta deixar de fora da comparação de ritmo.
Experimente fazer um cálculo. Descompacte o kit e execute python3 worksheet.py na pasta do kit. O script lista todas as voltas incluídas e excluídas. Ao retirar a volta da parada, a volta de saída dos boxes e as voltas sem tempo registrado, restam cinco voltas, com mediana de 90,229 segundos. Esse valor descreve o conjunto de voltas selecionadas, que abrange dois compostos. Para analisar o ritmo de um dos stints, escolha um intervalo dentro dele e indique quais voltas ficaram de fora.
5. Como conferir uma explicação da IA sobre a corrida?
- Abra a conversa em Inbox, expanda as Actions acionadas e abra View logs na Action de voltas. No nosso teste, as cinco consultas retornaram HTTP 200. Na chamada de voltas, confira se a sessão 9839, o piloto 44 e os limites 5 e 11 correspondem às sete linhas retornadas.
- Pergunte
Did Hamilton pit because Ferrari wanted an undercut?O Stint Notebook recuperou as duas paradas e explicou que os registros deixam em aberto o motivo da decisão da Ferrari. Para saber quanto tempo o carro ficou parado, confirastop_durationno registro original da parada. - Abra Testing → Simulation, selecione Create Dataset, escolha Paste messages e cole as perguntas de teste do kit. Uma linha contendo apenas
---separa uma pergunta da seguinte. Salve o conjunto de dados e selecione Run. Inclua um piloto desconhecido e um pedido de atualizações ao vivo. Para o piloto 999, a consulta à fonte retornou 404. Peça um número de piloto válido quando a consulta não encontrar um registro. Se o OpenF1 retornar um tempo ausente ou um erro temporário, deixe o valor como indisponível.
O log da chamada permite comparar a requisição feita com a parada descrita na resposta.
Use as mesmas perguntas depois de alterar a descrição de uma Action. Confira tanto a resposta quanto os dados que a Action recuperou.
As paradas mostram quando a Ferrari chamou Hamilton para os boxes. Os dados de cronometragem não têm um campo para a intenção da equipe.
Uma mudança que vale testar. Simulamos um HTTP 429 na consulta de voltas enquanto as outras quatro consultas foram bem-sucedidas. O agente tentou consultar as voltas duas vezes. Incluímos na descrição da Action de voltas uma instrução para parar ao atingir o limite de requisições e fizemos a mesma pergunta de novo. Dessa vez, o agente fez uma única tentativa, informou a parada que conseguiu confirmar e deixou os tempos de volta como indisponíveis. Ao testar sua própria redação, você pode contar as tentativas em View logs.
Se você já gerencia o Quickchat AI pelo ChatGPT ou pelo Claude, pode passar actions.json e main-prompt.txt do kit ao assistente e pedir que prepare as cinco Actions GET para a sessão 9839. Revise as URLs antes de ativá-las. Rodar um teste consome créditos do Quickchat AI.
Use o Stint Notebook para investigar a segunda parada. Pergunte pela próxima troca de pneus de Hamilton. Dessa vez, o registro da parada deve levar você à volta 31, e a primeira volta do stint com pneus médios deve ser a 32. Você já tem dois pontos para conferir na resposta antes mesmo de ler a explicação.
Perguntas frequentes
O que é um stint de pneus na Fórmula 1?
Um stint é a sequência de voltas que o piloto completa com o mesmo jogo de pneus. No OpenF1, cada stint tem um número, um composto e as voltas inicial e final. No GP de Abu Dhabi de 2025, Hamilton fez seu primeiro stint com pneus macios, da volta 1 à 8.
Preciso de uma chave de API para consultar o histórico do OpenF1?
Não. Para uso pessoal, o OpenF1 permite consultar sem chave as sessões realizadas desde 2023. As conversas e os testes no Quickchat AI consomem créditos. O acesso ao vivo tem requisitos próprios.
Quanto tempo durou a primeira parada de Hamilton em Abu Dhabi em 2025?
O OpenF1 registra 21,601 segundos no pit lane e 2,4 segundos com o carro parado na volta 8. No endpoint pit, os campos se chamam lane_duration e stop_duration. O tempo parado já está incluído no total do pit lane.
Como consultar tempos de volta e compostos de pneus da F1 na API OpenF1?
Busque as voltas e os stints com os mesmos session_key e driver_number. Para cada lap_number, use o composto do stint cujo intervalo de lap_start a lap_end inclui aquela volta. O endpoint laps informa lap_duration em segundos.
Essas voltas mostram por que a Ferrari chamou Hamilton para os boxes?
Os registros mostram quando Hamilton parou, quanto tempo ficou parado e quais pneus usou em seguida. A decisão da equipe não consta neles. Para confirmar uma estratégia como o undercut, seria preciso saber o que acontecia com um rival e qual era a intenção da equipe.
Dá para estimar o ritmo de um stint a partir dessas sete voltas?
Você pode descrever esse trecho se disser quais voltas considerou. O script exclui a volta da parada, as voltas de saída dos boxes e as que não têm tempo registrado. Ele informa a quantidade de voltas restantes e a mediana. Um trecho que abrange dois compostos não revela o ritmo típico de nenhum dos dois stints.