أعِد بناء وقفة هاميلتون في أبوظبي باستخدام OpenF1 API

Piotr Grudzień
تاريخ النشر مدة القراءة: 8 دقائق
رسم لسيارة فورمولا 1 حمراء بجوار زمن هاميلتون في ممر الحظائر ومدة بقاء سيارته متوقفة في اللفة 8

أمضى لويس هاميلتون 21٫601 ثانية في ممر الحظائر في اللفة 8 من جائزة أبوظبي الكبرى 2025. وبقيت سيارته Ferrari متوقفة لمدة 2٫4 ثانية. الرقمان من التوقّف نفسه. لكن جدول التوقيت يبيّن أن أطول لفة في ذلك الجزء من سباقه كانت اللفة 9.

يمكنك تتبّع هذه الأحداث بنفسك. ستنشئ Stint Notebook، وهو وكيل في Quickchat AI يقرأ بيانات واجهة OpenF1. اطلب ثلاث لفات قبل أول توقّف لهاميلتون وثلاثًا بعده. ستحصل على أزمنة سبع لفات، وتفاصيل الانتقال من الإطارات اللينة إلى الصلبة، وروابط السجلات التي تستند إليها الإجابة.

إجابة Quickchat AI عن سبع لفات لهاميلتون أسفل قياسَي الزمن اللذين سجّلهما OpenF1 لتوقفه في الحظائر في اللفة الثامنة عرض Quickchat AI في هذا التشغيل المحلي بيانات سبع لفات وروابط إلى السجلات العامة للتوقفات في الحظائر وفترات القيادة على كل مجموعة إطارات واللفات.

نزّل حزمة Stint Notebook لتحصل على إعدادات الإجراءات الخمسة ونص Main Prompt واستجابات OpenF1 المحفوظة وبرنامج Python صغير قابل للتشغيل. يمكنك الاطّلاع على سجلات OpenF1 دون حساب في OpenF1 أو رمز وصول إلى واجهة API. في الخطوة 2 ستسجّل الدخول إلى Quickchat AI.

1. أيّ حصة في أبوظبي تريد متابعتها؟

ابدأ بتحديد السباق والسائق. يتضمّن برنامج عطلة نهاية أسبوع الجائزة الكبرى عدة حصص، ويحمل هاميلتون الرقم 44 في كلٍّ منها. ولا يتحدّد المقصود برقم اللفة إلا بعد تحديد الحصة والسائق.

  1. افتح سجل الحصة في OpenF1. ابحث عن Race وYas Marina Circuit وتاريخ 7 ديسمبر 2025. استخدم session_key=9839 في كل طلب.
  2. افتح سجل السائق رقم 44. يعرض السجل اسم لويس هاميلتون وفريق Ferrari. أبقِ علامة التبويب مفتوحة أثناء إضافة الإجراءات.

رقم حصة السباق 9839 ورقم هاميلتون 44 يربطان سجلات التوقفات وفترات الإطارات واللفات في OpenF1 أبقِ السباق نفسه. بتغيير رقم السائق وحده، يمكنك طرح السؤال نفسه عن سيارة أخرى في السباق.

جرّب المثال على الصفحة الرئيسية لـ OpenF1. اختر Shell ثم انقر على Run. يعرض المثال بيانات اللفات الثلاث الأولى لهاميلتون. ابحث عن driver_number وlap_number في استجابة JSON.

مثال Shell في OpenF1 وزر Run وبيانات اللفات التي أعادها المثال للسائق رقم 44 يعرض هذا المثال اللفات من 1 إلى 3. أمّا السؤال عن التوقّف في الحظائر لاحقًا فيطلب اللفات من 5 إلى 11.

تتيح OpenF1 البيانات التاريخية منذ عام 2023 للاستخدام الشخصي. ويشرح دليل المصادقة كيفية الوصول إلى البيانات المباشرة.

2. كيف تضيف أول إجراءين إلى الوكيل؟

  1. أنشئ حسابًا في Quickchat AI أو سجّل الدخول. اختر Add new AI Agent → Set up manually وسمِّ الوكيل Stint Notebook. ستحتاج إلى رصيد لتوليد الردود وإجراء الاختبارات.
  2. افتح Identity → Main Prompt، ثم الصق التعليمات أدناه واحفظها. تحدّد هذه التعليمات السجلات التي يجمعها الوكيل قبل شرح ما حدث في اللفة.
  3. انتقل إلى Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. أدخل identify_session في API Action Name. اترك What to ask the user first فارغًا. ضمن API Endpoint، اختر GET وأدخل عنوان URL أدناه. اترك Headers وBody فارغين.
  4. أدخل الوصف أدناه في API Action Description. احفظ الإجراء وفعّله. كرّر الخطوات مع identify_driver. في هذا الإجراء، أضف driver_number ضمن What to ask the user first، واختر Number واجعل المعلمة إلزامية، ثم أدرجها في عنوان URL عبر Add AI Data → Parameters.

محرّر API Action في Quickchat AI يعرض إعداد البحث عن السباق المحدّد ونقطة نهاية طلب GET السباق محدّد في عنوان URL المحفوظ. والبحث عن السائق هو أول إجراء يحتاج إلى قيمة من المحادثة.

انسخ نص Main Prompt الخاص بـ 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.
انسخ إعدادات إجراءَي الحصة والسائق
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? تحقّق من تاريخ السباق واسم هاميلتون قبل المتابعة. إذا كان هذا أول إجراء لك، يشرح دليل إنشاء وكيل يستدعي واجهة API خطوات العمل في المحرّر.

3. كيف تحدّد اللفات السبع المطلوبة؟

حدّد نطاق اللفات من سجل التوقّف. توقّف هاميلتون مرتين في هذا السباق، في اللفتين 8 و31. اختر التوقّف الأول، ثم اطلب ثلاث لفات قبله وثلاثًا بعده. ستحصل على اللفات من 5 إلى 11، بما في ذلك اللفتان عند الحدّين. ولو طلبت اللفات أولًا، لاضطر الوكيل إلى تخمين أين يبحث.

ملخّص الفورمولا 1 لتوقّف اللفة 8 بجوار حقلَي OpenF1 اللذين يعرضان 21٫601 ثانية في ممر الحظائر و2٫4 ثانية بقيت فيها السيارة متوقفة يعرض ملخّص توقفات الحظائر للفورمولا 1 زمنًا قدره 21٫601 ثانية. وتسجّل OpenF1 إجمالي زمن ممر الحظائر، وتسجّل أيضًا مدة بقاء السيارة متوقفة ضمنه، وهي 2٫4 ثانية.

  1. في Custom Actions، أضف get_driver_pits وget_driver_stints. يستخدم كلاهما المعلمة الإلزامية نفسها driver_number التي يستخدمها إجراء البحث عن السائق. استخدم نقطة النهاية pit بصيغة المفرد للتوقفات، وstints لفترات الإطارات. يعرّف مرجع حقول OpenF1 حقول التوقيت، ومنها الاسم البديل الأقدم pit_duration لزمن ممر الحظائر.
  2. أضف get_driver_laps مع ثلاث معلمات إلزامية من نوع Number. استخدم Add AI Data لإدراج driver_number وfirst_lap وlast_lap في عنوان URL. أبقِ رموز المقارنة مشفّرة كما هي في الإعدادات. وتعني عوامل التصفية الناتجة رقم اللفة ≥ رقم أول لفة ورقم اللفة ≤ رقم آخر لفة.
  3. في Test Response، أدخل 44 و5 و11. تحقّق من أول عنصر وآخر عنصر في المصفوفة المُعادة، ثم احفظ الإجراءات وفعّلها جميعًا. اجعل نطاق هذا الإجراء عشر لفات أو أقل لكل سؤال. تنص تعليمات الوكيل على هذا الحد، بينما يقبل عنوان URL الخاص بالواجهة نطاقات أوسع.

إجراء اللفات في Quickchat AI مع معلمات السائق وأول لفة وآخر لفة ضع الحدّين في طلب GET نفسه. إذا غاب أحدهما، فقد يشمل الطلب بقية لفات السباق.

انسخ إعدادات إجراءات التوقفات وفترات الإطارات واللفات
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. ابدأ بقراءة التوقّف نفسه ثم انظر إلى اللفات المحيطة به. اللفة 8 هي آخر لفة تدرجها OpenF1 ضمن فترة الإطارات اللينة. واللفة 9 هي أول لفة على الإطارات الصلبة والصف الوحيد في هذا النطاق الذي يحمل فيه الحقل is_pit_out_lap القيمة true.

توزيع لفات هاميلتون الـ58 في السباق بحسب تركيبة الإطارات، لينة في اللفات 1–8، وصلبة في 9–31، ومتوسطة في 32–58 لمعرفة تركيبة الإطارات، حدّد الفترة التي تقع فيها اللفة بين بدايتها ونهايتها. اللفة 8 ما زالت ضمن الفترة الأولى.

رقم اللفةزمن اللفة (ثانية)تركيبة الإطاراتسجل الحظائر
590٫229لينة
690٫254لينة
790٫539لينة
892٫249لينةدخول الحظائر
9108٫500صلبةالخروج من الحظائر
1088٫517صلبة
1189٫022صلبة

تشمل أطول لفة في النطاق، وزمنها 108٫500 ثانية، العودة من الحظائر إلى الحلبة. أما أول لفة كاملة بعدها فاستغرقت 88٫517 ثانية. ولو قارنت الصفّين على أنهما لفتان عاديتان على التركيبة نفسها، لأغفلت أثر الخروج من الحظائر. يمكنك مراجعة كل رقم في سجلات اللفات السبع والتحقّق من فترات الإطارات.

أزمنة لفات هاميلتون من اللفة 5 إلى اللفة 11، مع تمييز لفة الخروج من الحظائر التي استغرقت 108٫500 ثانية يظهر التوقّف وأطول زمن للفة في صفّين متتاليين. وتحدّد علامة الخروج من الحظائر اللفة التي ينبغي استبعادها عند مقارنة الوتيرة.

جرّب إجراء عملية حسابية. فكّ ضغط الحزمة وشغّل python3 worksheet.py داخل مجلدها. يعرض البرنامج كل اللفات المدرجة والمستبعدة. بعد استبعاد لفة التوقّف ولفة الخروج من الحظائر واللفات التي لا تتوفر أزمنتها، تبقى خمس لفات وسيط أزمنتها 90٫229 ثانية. تصف هذه النتيجة اللفات المختارة على تركيبتين مختلفتين من الإطارات. ولدراسة وتيرة أيٍّ من الفترتين، اختر نطاقًا يقع بالكامل ضمنها واذكر اللفات التي استبعدتها.

5. كيف تتحقّق من شرح الذكاء الاصطناعي لما حدث في السباق؟

  1. افتح المحادثة في Inbox، ووسّع قائمة الإجراءات التي استدعاها الوكيل، ثم افتح View logs لإجراء اللفات. في تجربتنا، أعادت طلبات القراءة الخمسة جميعها رمز الاستجابة HTTP 200. في طلب اللفات، تحقّق من أن الحصة 9839 والسائق 44 والحدّين 5 و11 تطابق الصفوف السبعة المُعادة.
  2. اطرح السؤال Did Hamilton pit because Ferrari wanted an undercut? استرجع Stint Notebook التوقّفين وبيّن أن السجلات لا تحسم سبب قرار Ferrari. وللتحقّق من مدة بقاء السيارة متوقفة، راجع stop_duration في سجل التوقّف الأصلي.
  3. افتح Testing → Simulation، واختر Create Dataset ثم Paste messages، والصق أسئلة الاختبار من الحزمة. يفصل بين كل سؤال والذي يليه سطر لا يحتوي إلا على ---. احفظ مجموعة البيانات واختر Run. أدرج سؤالًا عن سائق مجهول وطلبًا للحصول على تحديثات مباشرة. عند البحث عن السائق رقم 999، أعاد مزوّد البيانات الرمز 404. اطلب رقم سائق صالحًا عندما لا يعثر البحث على سجل. وإذا أعادت OpenF1 زمنًا مفقودًا أو خطأً مؤقتًا، فاترك تلك القيمة على أنها غير متاحة.

يعرض سجل استدعاء اللفات في Quickchat AI رقم السائق وحدَّي نطاق اللفات والاستجابة المُعادة يتيح لك سجل الاستدعاء مقارنة الطلب الفعلي بالتوقّف الذي تصفه الإجابة.

واجهة Testing في Quickchat AI تعرض أسئلة Stint Notebook عن السباق وحدود بيانات التوقيت استخدم الأسئلة نفسها بعد تعديل وصف أحد الإجراءات. راجع الإجابة والبيانات التي استرجعها الإجراء.

يجيب Quickchat AI عن سؤال التوقّف المبكر لكسب مركز بالرجوع إلى التوقفات المسجّلة، ويوضّح حدود بيانات التوقيت تبيّن سجلات التوقف متى استدعت Ferrari هاميلتون إلى الحظائر. ولا تتضمّن بيانات التوقيت حقلًا يوضّح نية الفريق.

تعديل يستحق التجربة. حاكينا استجابة بالرمز HTTP 429 عند طلب بيانات اللفات، فيما نجحت طلبات القراءة الأربعة الأخرى. حاول الوكيل طلب اللفات مرتين. أضفنا إلى وصف إجراء اللفات تعليمات بالتوقّف عند بلوغ حدّ الطلبات، ثم أعدنا طرح السؤال نفسه. هذه المرة حاول الوكيل مرة واحدة، وذكر التوقّف الذي تحقّق منه، وأبقى أزمنة اللفات على أنها غير متاحة. يمكنك عدّ المحاولات في View logs عند اختبار صياغتك.

إذا كنت تدير Quickchat AI بالفعل من ChatGPT أو Claude، يمكنك تزويد المساعد بـ actions.json وmain-prompt.txt من الحزمة والطلب منه إعداد إجراءات GET الخمسة للحصة 9839. راجع عناوين URL الخاصة بها قبل تفعيلها. يستهلك تشغيل الاختبار من رصيدك في Quickchat AI.

تابع التوقّف الثاني في Stint Notebook. اسأل عن تبديل هاميلتون التالي للإطارات. هذه المرة، يُفترض أن يقودك سجل التوقّف إلى اللفة 31، وأن تكون أول لفة على الإطارات المتوسطة هي اللفة 32. أصبح لديك الآن موضعان للتحقّق من الإجابة قبل قراءة الشرح.

الأسئلة الشائعة

ما المقصود بفترة القيادة على مجموعة إطارات واحدة في الفورمولا 1؟

هي مجموعة اللفات التي يقطعها السائق على طقم إطارات واحد. وتحدّد OpenF1 لكل فترة رقمها وتركيبة الإطارات وأول لفة فيها وآخر لفة. امتدت فترة هاميلتون الأولى في سباق أبوظبي 2025 من اللفة 1 إلى اللفة 8 على الإطارات اللينة.

هل أحتاج إلى مفتاح API للوصول إلى بيانات OpenF1 التاريخية؟

لا. تتيح OpenF1 بيانات الحصص منذ عام 2023 للاستخدام الشخصي دون مفتاح. وتُحتسب المحادثات والاختبارات في Quickchat AI من رصيدك. أما الوصول إلى البيانات المباشرة فله متطلبات منفصلة.

كم استغرق أول توقّف لهاميلتون في حظائر أبوظبي عام 2025؟

تسجّل OpenF1 في اللفة 8 زمنًا قدره 21٫601 ثانية في ممر الحظائر ومدة قدرها 2٫4 ثانية بقيت فيها السيارة متوقفة. يظهر الزمنان في نقطة النهاية الخاصة بالتوقفات تحت الحقلين lane_duration وstop_duration. ويشمل إجمالي زمن ممر الحظائر مدة بقاء السيارة متوقفة.

كيف أحصل على أزمنة لفات الفورمولا 1 وتركيبات الإطارات من واجهة OpenF1؟

اجلب سجلات اللفات وفترات الإطارات باستخدام القيم نفسها للحقلين session_key وdriver_number. لكل lap_number، استخدم قيمة compound للفترة التي تقع فيها اللفة بين lap_start وlap_end، بما في ذلك اللفتان عند الحدّين. وتوفّر نقطة النهاية الخاصة باللفات زمن اللفة بالثواني في الحقل lap_duration.

هل تكشف هذه اللفات سبب استدعاء Ferrari لهاميلتون إلى الحظائر؟

تُظهر السجلات متى توقّف هاميلتون وكم بقيت سيارته متوقفة وأي إطارات استخدم بعدها. ولا توثّق قرار الفريق. ولإثبات أن الفريق اتّبع استراتيجية مثل التوقّف قبل منافس لكسب مركز عليه، تحتاج إلى أدلة تتعلق بالمنافس وبنية الفريق.

هل يمكنني استخدام اللفات السبع لتقدير وتيرة القيادة على مجموعة الإطارات؟

يمكنك وصف الوتيرة في هذا النطاق إذا حدّدت اللفات التي أدرجتها. يستبعد برنامج Python لفة التوقّف ولفات الخروج من الحظائر وأي لفات لا تتوفر أزمنتها، ثم يعرض عدد اللفات المتبقية ووسيط أزمنتها. وإذا امتد النطاق عبر تركيبتين مختلفتين من الإطارات، فلا يصلح لتحديد وتيرة تمثّل أيًا من الفترتين.

Quickchat AI Quickchat AI Ask Quickchat AI a question