كيف تبني روبوت دردشة كرويًا لمتابعة المباريات والنتائج وترتيب الدوري؟

Piotr Grudzień
تاريخ النشر مدة القراءة: 8 دقائق
موجز يوم المباراة لأرسنال المكون من ثلاثة أسطر في Quickchat AI بجانب صفحة Account Settings في football-data.org التي تعرض اشتراكًا Free

أنت تخطط ليوم السبت لمشاهدة مباراة أرسنال خارج أرضه أمام نيوكاسل. أحد أصدقائك في نيويورك يسأل عن موعد انطلاق المباراة. ثم يسأل شخص آخر في مجموعة الدردشة عن أداء أرسنال في آخر مباراة لعبها خارج أرضه. الإجابة الأولى موجودة في جدول المباريات. أما الثانية، فتحتاج إلى معرفة لمن يُنسب الهدف في نتيجة “ليفربول 0 - 1 أرسنال”.

ستقوم ببناء Matchday Notebook، وهو روبوت دردشة رياضي يبحث عن المباريات الثلاث القادمة في الدوري الإنجليزي الممتاز، ويعرض آخر خمس نتائج لأرسنال في الدوري، ويحدد مركزه في جدول الترتيب. هذا المثال مرتبط بتاريخ 18 نوفمبر 2026. كانت مباراة نيوكاسل خارج الديار مقررة يوم السبت 21 نوفمبر الساعة 17:30 بتوقيت UTC، أو 12:30 مساءً بتوقيت نيويورك.

مباراة نيوكاسل في Native Stats وإجابة يوم المباراة المقابلة في Quickchat AI تتفق صفحة المباراة لدى مزود البيانات مع موعد الانطلاق الظاهر في الوكيل الخاص. تم إجراء محادثة Quickchat AI باستخدام بيانات محفوظة بتاريخ قديم من السجلات العامة، والتي يمكنك استعراضها أدناه.

تحقق من مباراة نيوكاسل أو قم بتنزيل حزمة Matchday Notebook. بعد فك ضغطها، شغّل python3 replay.py لرؤية المباريات الثلاث والنتائج الخمس وجدول الترتيب دون الحاجة إلى حساب. تتضمن الحزمة نفسها إعدادات الإجراء وMain Prompt لربطها بمصدر بياناتك الخاص.

1. أي نادٍ ومسابقة سيتبعها روبوت الدردشة؟

حدد النادي والدوري أولاً. يمكن أن يتغير مستوى أرسنال في الدوري اعتمادًا على ما إذا كنت تحتسب نتائج مبارياته الأوروبية. في هذه المفكرة، أرسنال يعني الفريق 57 والدوري يعني الدوري الإنجليزي الممتاز 2021، المعروف أيضًا بالرمز PL.

  1. افتح نموذج تسجيل football-data.org. أدخل اسمك الأول وعنوان بريدك الإلكتروني، ووافق على الشروط، ثم اختر Create account. تحقق من بطولتك في قائمة التغطية. تشمل الخطة المجانية الدوري الإنجليزي الممتاز، مع جداول ونتائج بتحديث متأخر.

نموذج تسجيل football-data.org مع حقلي الاسم الأول والبريد الإلكتروني، وزر Create account، وتفاصيل Free Tier استخدم عنوان بريد إلكتروني يمكنك التحقق منه. يرسل football-data.org مفتاح API إليه بعد التسجيل. تسمح الخطة المجانية بعشرة طلبات في الدقيقة.

إذا كان لديك حساب بالفعل، سجل الدخول باستخدام بريدك الإلكتروني ورمز API المميز. إذا احتجت إلى نسخة أخرى من الرمز المميز، اطلبها عبر البريد الإلكتروني باستخدام العنوان الذي سجلت به. احتفظ بالرمز المميز من أجل الترويسة المحمية في الخطوة 2.

صفحة Account Settings في football-data.org تعرض اشتراكًا Free وجزءًا من قائمة Available competitions تحقق من خطتك تحت Subscription وابحث عن دوريك تحت Available competitions. يوضح هذا المقتطف دوري أبطال أوروبا (CL) والدوري الألماني (BL1).

  1. لمتابعة نادٍ آخر، ابحث عنه في قائمة فرق البطولة، على سبيل المثال GET /v4/competitions/PL/teams. استخدم معرّف الفريق ومعرّف البطولة اللذين يظهران لك في طلبات المباريات أدناه. يحتوي دليل البدء السريع للإصدار v4 على كلتا عمليتي البحث.
  2. أنشئ وكيلاً في Quickchat AI، وأطلق عليه اسم Matchday Notebook، وأبقهِ خاصاً أثناء الاختبار. ستحتاج إلى رصيد متاح للمحادثات والمحاكاة. افتح Identity ← AI Persona ← Main Prompt والصق التعليمات أدناه. تستخدم لقطات الشاشة والإعدادات القابلة للنسخ اللغة الإنجليزية.

صفحة نادي أرسنال في Native Stats وإعدادات Identity لـ Matchday Notebook في Quickchat AI حافظ على نفس النادي في كلا المكانين. داخل المنتج، توجد تعليمات الوكيل ضمن Identity.

انسخ Main Prompt لـ Matchday Notebook
You are Matchday Notebook, an Arsenal Premier League companion. Use get_club_fixtures for the schedule, get_recent_results for form and get_league_standings for the league table. For match reads, use an inclusive UTC start date and an exclusive end date. Ask for dates when the window is unclear.

List up to the requested number of TIMED or SCHEDULED fixtures in kickoff order. Give the date, time and timezone; say when the hour is unconfirmed. Flag postponed or cancelled games separately. For form, sort FINISHED matches newest first, take up to five and read full-time scores home first. Judge wins, draws and losses from Arsenal's side. For standings, find Arsenal (team 57) in the TOTAL table. Give the season, position, games played and points.

Keep answers short. Link a match to https://native-stats.org/match/ID using its returned ID, and the Premier League table to https://native-stats.org/competition/PL/. Attribute football-data.org, give the relevant date and identify any snapshot as a snapshot. Quote a retrieval time only if supplied. Keep null scores unknown. Report empty windows, missing scores and failed reads accurately. Stop after a rate limit. Do not predict scores.

2. كيف تحصل على مباراة أرسنال القادمة؟

ابدأ بالإجراء الذي يجيب على سؤال مجموعة الدردشة حول موعد انطلاق المباراة. يعرض طلب واحد كلا الناديين والوقت المحدد وحالة المباراة. اترك مُرشِّح الحالة مفتوحًا هنا حتى تظهر المباريات المؤجلة. السجل الذي حالته TIMED له وقت انطلاق محدد. أما إذا كانت حالته SCHEDULED، فأخبر المستخدم أن الموعد لم يتأكد بعد.

  1. افتح Actions & MCPs ← Add Action ← API Action ← Create manually. اضبط API Action Name على get_club_fixtures وWhen to run على AI decides. ضمن What to ask the user first، أضف مدخلي Text المطلوبين date_from وdate_to، وكلاهما بـ No default. وصفهما هو “أول تاريخ UTC يتم تضمينه، YYYY-MM-DD” و”أول تاريخ UTC يتم استبعاده، YYYY-MM-DD”.
  2. بالنسبة لـ API Endpoint، اختر GET وأدخل عنوان URL أدناه. افتح Query Params واضبط competitions على القيمة الحرفية 2021. أضف dateFrom وdateTo. لكل قيمة، استخدم Add AI Data → Parameters لإدراج إدخال التاريخ المطابق. اترك Body فارغًا.
  3. الصق الوصف أدناه ضمن API Action Description واحفظ الإجراء. ضمن Headers، ستوضع بيانات الاعتماد في صف X-Auth-Token للقراءة فقط. قم بإعداد ذلك قبل طلبك الأول. أضف رأسًا ثانيًا عاديًا مع Accept كمفتاح وapplication/json كقيمة. استخدم نفس الرأسين في جميع الإجراءات الثلاثة.
https://api.football-data.org/v4/teams/57/matches

مسار Team matches في football-data.org ونقطة النهاية GET في Quickchat AI مع Query Params للمسابقة 2021 وتاريخين اتبع مسار مباريات الفريق من مرجع المزود إلى الإجراء. أرسنال ثابت في عنوان URL، والدوري في Query Params، والتاريخان يأتيان من المحادثة.

انسخ وصف إجراء المباراة
Use for Arsenal's upcoming Premier League fixtures in the requested date window. Sort by utcDate ascending. Show TIMED or SCHEDULED matches and flag postponements or cancellations separately. State the window if fewer fixtures are returned.

تضع أمثلة الطلبات لدى المزود مفتاح API في X-Auth-Token. استخدم اسم الترويسة نفسه في Headers على get_club_fixtures.

نموذج Sign in العام في football-data.org، ومثال على X-Auth-Token للإصدار v4، وعلامة التبويب Headers في Quickchat AI يأخذ نموذج تسجيل الدخول بريدك الإلكتروني ورمز API المميز. في Quickchat AI، يوضع الرمز المميز فقط في صف X-Auth-Token المحمي.

أدخل الرمز المميز بشكل خاص. يمكن للوحة التحكم استبدال بيانات سرية محفوظة. لجعل هذا الرأس للكتابة فقط في المقام الأول، استخدم اتصال الحساب مرة واحدة لكل إجراء. قم بتوصيل حسابك باستخدام دليل إعداد Quickchat AI في ChatGPT أو Claude. اطلب من المساعد المتصل إعداد الرأس بعلامة مؤقتة باستخدام التعليمات أدناه. ثم افتح علامة تبويب Headers الخاصة بالإجراء بنفسك، واستبدل القيمة في نفس الصف برمز football-data.org الخام الخاص بك، وحدد Save changes. أعد فتح المحرر وتحقق من أنه يعرض [redacted]. احتفظ بالرمز المميز في لوحة التحكم وبعيدًا عن المحادثة.

On Matchday Notebook, set the X-Auth-Token header of get_club_fixtures to the literal value REPLACE_IN_DASHBOARD with is_secret=true. Preserve the rest of the settings. Read the Action back and confirm that the header is secret and the value is [redacted]. Stop before testing.

علامة التبويب Headers في إجراء جلب المباريات تظهر X-Auth-Token بقيمة محجوبة هذا هو الرأس المحفوظ. يتوقع المزود الرمز المميز بمفرده، بدون بادئة Bearer.

جرب القراءة الأولى. في Test Response → Test the API، قم بتوفير تاريخ بدء واليوم بعد آخر تاريخ مرغوب فيه. ثم قم بتمكين الإجراء واسأل في AI Preview عن المباريات الثلاث القادمة في الدوري في تلك النافذة. لبناء مباشر، اختر التواريخ القادمة. استخدم مثال الأرشيف 2026-11-18 و2026-12-03، لذلك تم احتساب مساء 2 ديسمبر. تحقق من أقرب مباراة بفتح رابط مصدرها. يشرح مرجع عامل تصفية التاريخ v4 تاريخ الانتهاء الحصري.

ثلاثة تواريخ مباريات بين البداية الشاملة في 18 نوفمبر والنهاية الحصرية في 3 ديسمبر في مثال الاستجابة المحفوظة، كانت مباراة نيوكاسل خارج الأرض يوم 21 نوفمبر، ومباراة مانشستر سيتي على أرضنا يوم 29 نوفمبر، ومباراة برينتفورد خارج الأرض يوم 2 ديسمبر. لو انتهى الطلب بتاريخ 2 ديسمبر، لتم استبعاد مباراة برينتفورد.

3. كيف تقرأ نتائج آخر خمس مباريات لآرسنال؟

المباراة الأهم في هذا المثال انتهت بنتيجة ليفربول 0 - آرسنال 1. إذا تعامل روبوت الدردشة مع الرقم الأول على أنه نتيجة آرسنال في كل مرة، فسيحول الفوز خارج الأرض إلى هزيمة. احتفظ بكل نتيجة بترتيب الفريق المضيف ثم الضيف واستخدم مُعرّف الفريق لتحديد أداء آرسنال.

  1. أنشئ API Action ثانية باسم get_recent_results. استخدم نفس نقطة نهاية GET، ومدخلات التاريخ، وشرائح التاريخ، وعامل تصفية المسابقة. أضف صف الاستعلام status بالقيمة الحرفية FINISHED.
  2. اضبط الوصف أدناه. كرر إعداد الرأس للقراءة فقط لـ get_recent_results، وتحقق من القناع وقم بتمكين الإجراء.
  3. اطلب آخر خمس مباريات دوري في نافذة محددة. للمثال، استخدم من 1 أكتوبر حتى 17 نوفمبر 2026. قم بالفرز حسب utcDate قبل أخذ خمس مباريات. إذا أعادت النافذة ثلاث مباريات فقط، فأظهر تلك الثلاث واعرض البحث عن المزيد.
انسخ وصف إجراء النتائج
Use for Arsenal's recent Premier League form in the requested date window. Sort FINISHED matches newest first, then take up to five. Use both full-time goals and the home and away team IDs to judge each result from Arsenal's perspective.

ليفربول 0، أرسنال 1 في صفحة المباراة المصدر مع تحديد نتيجة أرسنال خارج أرضه ابحث أولاً عن آرسنال في خانة الفريق الضيف، ثم اقرأ عدد أهدافه. نتيجة ليفربول (صفر) تعني أن آرسنال حافظ على نظافة شباكه.

اقرأ سلسلة النتائج من الأحدث إلى الأقدم. فاز آرسنال على هال سيتي 1–0، وفاز على ليفربول 1–0 خارج أرضه، وتغلب على إيفرتون 2–0، وفاز على نوتينغهام فورست 1–0 خارج أرضه، وتغلب على ليدز يونايتد 2–1. وهذا يعني خمسة انتصارات، سبعة أهداف مسجلة وهدف واحد في شباكنا. يعد سجل مباراة ليفربول اختبارًا جيدًا لأن الفريق الفائز يظهر ثانيًا.

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

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

4. من أين يأتي مركز الفريق في الدوري ونقاطه؟

خمسة انتصارات تخبرك كيف سارت الأسابيع القليلة الماضية. يعتمد مركز الدوري أيضًا على جميع المباريات التي سبقتها ونتائج جميع الفرق الأخرى. امنح الوكيل إجراءً منفصلاً لترتيب الدوري.

  1. سمها get_league_standings. اختر GET، الصق نقطة النهاية أدناه واترك المدخلات ومعلمات الاستعلام والجسم فارغة. استخدم AI decides، أضف الوصف أدناه وكرر إعداد الرأس للقراءة فقط لهذا الإجراء.
  2. في Test Response، ابحث في standings عن الإدخال الذي يكون type فيه TOTAL. ضمن table، ابحث عن team.id يساوي 57. قم بتمكين الإجراء واسأل “أين آرسنال في جدول الدوري الإنجليزي الممتاز؟”
  3. قارن position وplayedGames وpoints بالمصدر لنفس الموسم والتاريخ. في 18 نوفمبر، أظهر جدول الدوري الإنجليزي الممتاز في Native Stats المركز الأول، 10 مباريات، 27 نقطة. سيتغير جدولك الحالي مع لعب الأندية الأخرى.
https://api.football-data.org/v4/competitions/PL/standings
انسخ وصف إجراء الترتيب
Use for the current Premier League table. Find team ID 57 in standings where type is TOTAL. Report season, position, playedGames and points. If the row is missing, say the position is unavailable.

صف آرسنال في المركز الأول في جدول ترتيب الدوري الإنجليزي الممتاز والحقول التي يستخدمها Matchday Notebook اقرأ عبر صف واحد في TOTAL. تغطي النقاط الـ 27 جميع مباريات الدوري العشر في اللقطة.

5. هل يمكنك تتبع موجز يوم المباراة وصولًا إلى مصادره؟

ابدأ محادثة جديدة في AI Preview. اطلب جدول المباريات الثلاث القادمة، ثم اسأل “كيف كان أداؤنا في آخر خمس مباريات بالدوري؟”، وقدم النافذة الزمنية للنتائج، ثم اسأل “ما هو مركزنا في جدول الترتيب؟”. في Inbox، افتح علامة الإجراء الذي تم استدعاؤه لكل إجابة. تتيح لك قائمة View logs الخاصة بالإجراء مقارنة المعلمات والاستجابة بما رآه المشجع. يوضح دليل بناء API Action مكان العثور على عناصر التحكم هذه.

للحصول على ملخص يوم المباراة المجمع الذي يظهر في بداية المقال، اطرح السؤال أدناه باستخدام تواريخ المثال المحفوظ. للحصول على ملخص محدث، استخدم تواريخ قادمة للمباريات المقبلة وتواريخ حديثة للنتائج.

Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.

استدعاء إجراء جلب المباريات في Quickchat AI مع الطلب وسجل المباراة المُرجع تفحص التواريخ ومُعرّف المباراة في الاستدعاء. في مثال الاستجابة المحفوظة، 560651 هو مُعرّف مباراة نيوكاسل.

لإجراء فحص قابل للتكرار، افتح Conversations ← Testing، أنشئ مجموعة بيانات واحفظ الأسئلة الثلاثة. أضف السؤالين الحدين الموضحين أدناه. قم بتشغيل مجموعة البيانات بعد تغيير وصف الإجراء وافحص الاستدعاءات جنبًا إلى جنب مع الردود. استخدم استجابة متحكم بها لممارسة حالة نادرة أو خطأ. سؤال افتراضي وحده يختبر صياغة الإجابة.

مجموعة بيانات Matchday Notebook في Quickchat AI تحتوي على أسئلة حول جدول المباريات والنتائج الأخيرة والترتيب وأسئلة للحالات الحدودية استخدم نفس الأسئلة بعد كل تعديل. نتيجة المباراة خارج الأرض تكشف عن خطأ في قراءة النتيجة قد لا يظهر عند اختبار مباريات الفريق على أرضه فقط.

حالة الاختبارماذا يجب أن يسمع المشجع
تأجلت مباراة وكلا الهدفين null. هل كانت تعادلاً؟تأجلت المباراة. لا يوجد سجل للنتيجة.
بحث ناجح يعيد قائمة matches فارغة. هل الموسم بأكمله فارغ؟لم يتم العثور على أي مباريات في تلك الفترة الزمنية. اذكر التواريخ التي بحثت فيها.
يعيد المزود 401 أو 403.فشل البحث. تحقق من الرمز المميز المحفوظ وتغطية المسابقة.
يعيد المزود 429.تم الوصول إلى الحد الأقصى لعدد الطلبات. يُرجى التوقف والمحاولة مرة أخرى لاحقًا.

إجابة Quickchat AI عن فترة لا توجد بها مباريات، مقترنة بالطلب الناجح الذي لم يُرجع أي نتائج حتى مع عدم وجود نتائج، يظل الطلب ناجحًا. يمكن للمساعد أن يعرض توسيع نطاق التواريخ.

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

Football data provided by the Football-Data.org API. يستخدم المثال المذكور صفحات Native Stats العامة للمزوّد. راجع خطط البيانات والحد الأقصى لعدد طلبات API للاطلاع على التغطية الحالية ومواعيد التحديث.

الأسئلة المتكررة

ما هي واجهة برمجة تطبيقات كرة القدم التي يمكنني استخدامها لروبوت دردشة المباريات؟

توفر واجهة برمجة التطبيقات football-data.org v4 جداول المباريات والنتائج وترتيب الفرق للبطولات التي تغطيها. استخدم نقطة نهاية مباريات الفريق للحصول على جدول المباريات والنتائج الأخيرة، ونقطة نهاية ترتيب البطولة لمعرفة مركز الفريق في الدوري.

هل نتائج football-data.org مباشرة على الخطة المجانية؟

تشمل الخطة المجانية النتائج والجداول الزمنية بتحديث متأخر، وجداول ترتيب الدوري للبطولات المغطاة، مع حد أقصى يبلغ 10 استدعاءات لواجهة برمجة التطبيقات في الدقيقة. احرص على ذكر المصدر والتاريخ مع كل إجابة، وراجع تفاصيل خطتك إذا كنت بحاجة إلى نتائج مباشرة.

كيف أغير أرسنال إلى فريق آخر؟

ابحث عن معرّف النادي والبطولة في football-data.org. استبدل الفريق 57 في كلا إجراءي المباراة، وغيّر مُرشِّح البطولة الرقمي ورابط الترتيب، ثم حدّث اسم النادي ومعرّف الفريق في التعليمات. اختبر الإعدادات على مباراة تعرفها.

كيف أحصل على آخر خمس مباريات من وجهة نظر الفريق؟

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

ماذا تعني النتيجة الفارغة للمباراة المؤجلة؟

النتيجة الفارغة تعني أن مزود البيانات لم يوفر مجموع أهداف لذلك الفريق. أبقِ حالة المباراة ظاهرة واترك النتيجة غير معروفة. يتطلب التعادل السلبي مباراة منتهية بنتيجة صفر-صفر مسجلة لكلا الفريقين.

كيف أحول موعد انطلاق مباراة كرة قدم إلى منطقتي الزمنية؟

ابدأ بموعد انطلاق المباراة بتوقيت UTC، واستخدم منطقة زمنية مسماة مثل America/New_York، واحتفظ بالتاريخ في الإجابة. يمكن أن يؤثر التوقيت الصيفي وتغيير يوم التقويم على الوقت المعروض.

Quickchat AI Quickchat AI Ask Quickchat AI a question