루이스 해밀턴은 2025년 아부다비 그랑프리 8랩에서 피트 레인에 21.601초 머물렀습니다. 그중 그의 페라리가 피트 박스에 정차한 시간은 2.4초였습니다. 두 수치 모두 같은 피트 스톱에서 나온 기록입니다. 타이밍 기록을 보면 이 구간에서 가장 오래 걸린 랩은 9랩입니다.
이 과정을 직접 재구성해 볼 수 있습니다. OpenF1 API를 조회하는 Quickchat AI 에이전트 Stint Notebook을 만들어 보세요. 해밀턴의 첫 피트 스톱 전후로 세 랩씩 보여 달라고 하면, 해당 랩을 포함한 일곱 랩의 타임과 소프트에서 하드로 바뀐 타이어, 답변의 근거가 된 기록의 링크를 확인할 수 있습니다.
이번 로컬 테스트에서 Quickchat AI는 일곱 랩의 데이터와 피트 스톱, 타이어 스틴트, 개별 랩의 공개 기록을 확인할 수 있는 링크를 반환했습니다.
Stint Notebook 키트 다운로드에서 Action 다섯 개의 설정 예시, Main Prompt, 저장된 OpenF1 응답, 실행 가능한 짧은 Python 스크립트를 받을 수 있습니다. OpenF1 계정이나 API 토큰 없이도 OpenF1 기록을 확인할 수 있습니다. 2단계에서는 Quickchat AI에 로그인합니다.
1. 아부다비의 어느 세션을 봐야 할까요?
먼저 레이스와 드라이버부터 확인하세요. 그랑프리 주말에는 여러 세션이 열리며, 해밀턴은 모든 세션에서 44번을 달고 달립니다. 세션과 드라이버를 모두 특정해야 랩 번호가 어떤 주행 기록을 가리키는지 알 수 있습니다.
- OpenF1 세션 기록을 엽니다.
Race,Yas Marina Circuit와 날짜가 2025년 12월 7일인지 확인하세요. 모든 요청에session_key=9839을 넣으세요. - 44번 드라이버 기록을 열면 루이스 해밀턴과 Ferrari가 표시됩니다. Action을 추가하는 동안 이 탭을 열어 두세요.
레이스는 그대로 두세요. 드라이버 번호만 바꾸면 같은 레이스에서 다른 차량에 대해 같은 질문을 할 수 있습니다.
OpenF1 홈페이지의 예제를 실행해 보세요. Shell 탭을 선택하고 Run 버튼을 누르면 해밀턴의 첫 세 랩 기록이 나옵니다. JSON 응답에서 driver_number와 lap_number 필드를 찾아보세요.
이 예제는 1랩부터 3랩까지의 기록을 보여 줍니다. 뒤에서 피트 스톱에 관해 질문할 때는 5랩부터 11랩까지의 기록을 요청합니다.
OpenF1은 2023년 이후의 과거 데이터를 개인 용도로 제공합니다. 실시간 데이터에 접근하는 방법은 인증 가이드에서 확인할 수 있습니다.
2. 에이전트에 첫 두 개의 Action을 어떻게 추가할까요?
- Quickchat AI 계정을 만들거나 로그인하세요. Add new AI Agent → Set up manually를 선택하고 이름을 Stint Notebook으로 지정하세요. AI 답변과 테스트에는 크레딧이 필요합니다.
- 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을 선택하고 아래 URL을 입력합니다. Headers와 Body는 비워 두세요. - API Action Description에 아래 설명을 입력하세요. Action을 저장하고 활성화합니다.
identify_driver에도 같은 과정을 적용하세요. 이 Action에서는 What to ask the user first에driver_number을 추가하고 Number를 선택한 뒤 필수 항목으로 지정하세요. 그런 다음 Add AI Data → Parameters를 사용해 URL에 삽입합니다.
조회할 레이스는 저장된 URL에 들어 있습니다. 드라이버 조회는 대화에서 값을 받아야 하는 첫 번째 Action입니다.
Stint Notebook의 Main Prompt 복사하기
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.
세션 및 드라이버 조회 Action 설정 복사하기
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? 레이스 날짜와 해밀턴의 이름이 맞는지 확인한 뒤 다음 단계로 넘어가세요. 처음 Action을 만드는 경우 API를 호출하는 에이전트 만들기 안내에서 편집기 사용법을 확인할 수 있습니다.
3. 필요한 일곱 랩을 어떻게 찾을까요?
피트 기록을 기준으로 조회 범위를 정하세요. 해밀턴은 이 레이스에서 8랩과 31랩에 두 차례 피트 스톱을 했습니다. 첫 번째 기록을 선택하고 앞뒤로 세 랩씩 요청하세요. 그러면 양 끝을 포함해 5랩부터 11랩까지 조회됩니다. 랩 기록부터 요청하면 에이전트가 어디를 살펴볼지 추정해야 합니다.
포뮬러 1의 피트 스톱 요약에는 21.601초가 표시됩니다. OpenF1은 피트 레인 전체 시간과 그 안에 포함된 정차 시간 2.4초를 모두 기록합니다.
- Custom Actions에서
get_driver_pits및get_driver_stints을 추가하세요. 두 Action 모두 드라이버 조회와 같은 필수 매개변수driver_number를 사용합니다. 피트 스톱에는 단수형 엔드포인트 pit을, 타이어 사용 구간에는 stints를 사용하세요. OpenF1 필드 참조 문서에는 타이밍 필드의 정의와 함께 피트 레인 시간에 예전에 쓰던 별칭pit_duration도 나와 있습니다. get_driver_laps을 추가하고 Number 매개변수 세 개를 필수로 지정하세요. Add AI Data로driver_number,first_lap,last_lap을 URL에 삽입합니다. 설정 예시에 나온 인코딩된 기호는 그대로 두세요. 이 필터는 랩 번호 ≥ 시작 랩 번호, 랩 번호 ≤ 마지막 랩 번호를 뜻합니다.- Test Response에 44, 5, 11을 입력하세요. 반환된 배열의 첫 항목과 마지막 항목을 확인한 뒤 Action을 저장하고 세 개 모두 활성화합니다. 이 Action은 질문 한 건당 최대 10랩까지만 조회하도록 하세요. 프롬프트에서 이 제한을 지키도록 지시하며, API URL 자체는 더 넓은 범위도 허용합니다.
범위의 양 끝값을 같은 GET 요청에 넣으세요. 한쪽 값이 빠지면 레이스의 나머지 랩까지 조회될 수 있습니다.
피트, 스틴트, 랩 조회 Action 설정 복사하기
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. 8랩과 9랩 사이에 무엇이 달라졌을까요?
AI Preview에서 다음 메시지를 보내세요. Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. 피트 스톱을 기준으로 앞뒤 랩을 살펴보세요. OpenF1에서 8랩은 소프트 스틴트의 마지막 랩입니다. 9랩은 하드 타이어로 달린 첫 랩이며, 이 범위에서 is_pit_out_lap 값이 true로 설정된 유일한 행입니다.
해당 랩이 어느 스틴트의 시작 랩과 마지막 랩 사이에 있는지 보면 컴파운드를 알 수 있습니다. 8랩은 첫 스틴트에 속합니다.
| 랩 번호 | 랩 타임 (초) | 타이어 컴파운드 | 피트 진입·출차 기록 |
|---|---|---|---|
| 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. AI의 레이스 설명을 어떻게 검증할까요?
- Inbox에서 대화를 열고 호출된 Action 목록을 펼친 뒤, 랩 조회 Action에서 View logs를 엽니다. 이 예제에서는 다섯 번의 조회가 모두 HTTP 200을 반환했습니다. 랩 조회 요청의 세션 9839, 드라이버 44, 범위의 양 끝인 5와 11을 반환된 일곱 행과 대조하세요.
- 이렇게 물어보세요.
Did Hamilton pit because Ferrari wanted an undercut?Stint Notebook은 두 차례의 피트 스톱 기록을 가져와, 이 기록만으로는 페라리가 어떤 판단을 내렸는지 알 수 없다고 설명했습니다. 정차 시간은 원본 피트 기록의stop_duration에서 확인하세요. - Testing → Simulation을 열고 Create Dataset을 선택한 다음, Paste messages를 선택해 키트의 테스트 질문을 붙여넣으세요. 질문과 질문 사이는
---만 있는 한 줄로 구분합니다. 데이터셋을 저장하고 Run을 선택하세요. 등록되지 않은 드라이버에 대한 질문과 실시간 업데이트 요청도 넣으세요. 이 예제에서 드라이버 999로 조회했을 때 데이터 제공처는 404를 반환했습니다. 조회 결과에 해당 기록이 없으면 유효한 드라이버 번호를 요청하세요. OpenF1 응답에서 시간이 누락되거나 일시적인 오류가 발생하면 해당 값은 확인 불가로 남겨 두세요.
호출 로그를 보면 실제 요청을 답변에서 설명한 피트 스톱과 대조할 수 있습니다.
Action 설명을 바꾼 뒤 같은 질문으로 다시 테스트해 보세요. 답변과 Action이 가져온 데이터를 모두 확인하세요.
피트 스톱 기록으로 페라리가 언제 해밀턴을 불러들였는지 확인할 수 있습니다. 타이밍 데이터에는 팀의 의도를 나타내는 필드가 없습니다.
테스트해 볼 만한 변경 사항이 하나 있습니다. 다른 네 건의 조회는 성공하고 랩 조회에서만 HTTP 429가 발생하는 상황을 재현했습니다. 에이전트는 랩 조회를 두 번 시도했습니다. 랩 조회 Action 설명에 요청 한도에 도달하면 중단하라는 지침을 추가하고 같은 질문을 다시 실행했습니다. 이번에는 한 번만 시도하고 확인된 피트 스톱을 알려 줬으며, 랩 타임은 확인 불가로 남겼습니다. 직접 작성한 문구를 테스트할 때는 View logs에서 시도 횟수를 확인할 수 있습니다.
이미 ChatGPT나 Claude에서 Quickchat AI를 관리하고 있다면, 해당 어시스턴트에 키트의 actions.json 및 main-prompt.txt을 제공하고 세션 9839에 사용할 GET Action 다섯 개를 준비해 달라고 요청할 수 있습니다. 활성화하기 전에 각 URL을 검토하세요. 테스트를 실행하면 Quickchat AI 크레딧이 사용됩니다.
두 번째 피트 스톱도 살펴보세요. 해밀턴의 다음 타이어 교체를 물어보세요. 이번에는 피트 기록이 31랩을 가리키고, 미디엄 스틴트의 첫 랩은 32랩으로 나와야 합니다. 설명을 읽기 전에 이 두 지점에서 답변이 맞는지 확인할 수 있습니다.
자주 묻는 질문
포뮬러 1에서 타이어 스틴트란 무엇인가요?
타이어 스틴트는 드라이버가 같은 타이어 세트로 연속해서 달린 랩 구간입니다. OpenF1은 각 스틴트의 번호, 컴파운드, 시작 랩과 마지막 랩을 제공합니다. 2025년 아부다비 레이스에서 해밀턴은 1랩부터 8랩까지 소프트 타이어로 첫 스틴트를 달렸습니다.
OpenF1의 과거 데이터를 이용하려면 API 키가 필요한가요?
아니요. OpenF1은 2023년 이후 세션의 과거 데이터를 개인 용도로 이용할 때 API 키를 요구하지 않습니다. Quickchat AI에서 대화와 테스트에는 크레딧이 사용됩니다. 실시간 데이터에는 별도의 이용 요건이 있습니다.
2025년 아부다비에서 해밀턴의 첫 피트 스톱은 얼마나 걸렸나요?
OpenF1에 따르면 해밀턴은 8랩에서 피트 레인에 21.601초 머물렀으며, 그중 2.4초는 정차 상태였습니다. pit 엔드포인트에서 두 값의 필드 이름은 각각 lane_duration과 stop_duration입니다. 피트 레인 전체 시간에는 정차 시간이 이미 포함돼 있습니다.
OpenF1 API에서 F1 랩 타임과 타이어 컴파운드를 어떻게 가져오나요?
같은 session_key와 driver_number로 laps와 stints를 조회하세요. 각 lap_number에는 lap_start부터 lap_end까지의 범위에 해당 랩이 포함된 스틴트의 컴파운드를 적용합니다. laps 엔드포인트는 lap_duration을 초 단위로 제공합니다.
이 랩 기록으로 페라리가 해밀턴을 피트로 불러들인 이유를 알 수 있나요?
기록을 보면 해밀턴이 언제 피트 스톱을 했고, 얼마나 정차했으며, 이후 어떤 타이어를 썼는지 알 수 있습니다. 팀의 판단 근거는 기록에 남지 않습니다. 언더컷 같은 전략을 확인하려면 경쟁 상대의 상황과 팀의 의도를 보여 주는 근거가 필요합니다.
이 일곱 랩으로 스틴트 페이스를 추정할 수 있나요?
어떤 랩을 포함했는지 밝히면 이 구간의 페이스를 설명할 수 있습니다. 키트에 포함된 짧은 Python 스크립트는 피트 인 랩, 피트에서 나온 아웃 랩, 랩 타임이 누락된 랩을 제외하고 남은 랩 수와 중앙값을 보여 줍니다. 두 컴파운드에 걸친 구간으로는 어느 쪽 스틴트의 대표 페이스도 판단할 수 없습니다.