आप आर्सेनल के न्यूकैसल दौरे को ध्यान में रखकर शनिवार की योजना बना रहे हैं। न्यूयॉर्क में आपके एक दोस्त को मैच शुरू होने का समय जानना है। फिर ग्रुप चैट में कोई पूछता है कि आर्सेनल ने अपने पिछले बाहरी मैच में कैसा प्रदर्शन किया था। पहले सवाल का जवाब मैचों के कार्यक्रम की सूची में है। दूसरे के लिए, आपको यह जानना होगा कि “लिवरपूल 0, आर्सेनल 1” में 1 गोल किसने किया।
आप Matchday Notebook बनाएँगे, जो एक ऐसा फुटबॉल चैटबॉट है जो अगले तीन प्रीमियर लीग मैचों का कार्यक्रम देखता है, आर्सेनल के पिछले पाँच लीग मैचों के नतीजे बताता है और अंक तालिका में उनका स्थान ढूँढ़ता है। यह उदाहरण 18 नवंबर 2026 पर आधारित है। न्यूकैसल के साथ बाहरी मैच शनिवार, 21 नवंबर को 17:30 UTC पर, या न्यूयॉर्क में दोपहर 12:30 बजे होना था।
प्रदाता का मैच पेज और निजी एजेंट मैच शुरू होने के समय पर सहमत हैं। Quickchat AI की बातचीत सार्वजनिक रिकॉर्ड के एक पुराने डेटा रीप्ले पर की गई थी, जिसे आप नीचे फिर से देख सकते हैं।
न्यूकैसल के साथ होने वाले मैच की जाँच करें या Matchday Notebook किट डाउनलोड करें। इसे अनज़िप करें और बिना खाते के तीन मैचों का कार्यक्रम, पाँच नतीजे और अंक तालिका की पंक्ति देखने के लिए python3 replay.py चलाएँ। इसी किट में एक्शन सेटिंग्स और अपनी खुद की फ़ीड जोड़ने के लिए Main Prompt शामिल है।
1. चैटबॉट किस क्लब और प्रतियोगिता को फ़ॉलो करेगा?
सबसे पहले क्लब और लीग तय करें। आर्सेनल का लीग प्रदर्शन इस बात पर निर्भर कर सकता है कि आप यूरोप में मंगलवार रात के मैच को गिनते हैं या नहीं। इस नोटबुक में आर्सेनल का मतलब टीम 57 है और लीग का मतलब प्रीमियर लीग 2021 है, जिसे इसके कोड PL से भी जाना जाता है।
- football-data.org रजिस्ट्रेशन फ़ॉर्म खोलें। अपना पहला नाम और ईमेल पता दर्ज करें, शर्तों को स्वीकार करें और Create account चुनें। कवरेज सूची पर अपनी लीग की जाँच करें। मुफ़्त प्लान में प्रीमियर लीग शामिल है, जिसमें मैचों के कार्यक्रम और स्कोर देरी से मिलते हैं।
ऐसे ईमेल पते का उपयोग करें जिसे आप देख सकें। रजिस्ट्रेशन के बाद football-data.org वहीं पर API कुंजी भेजता है। मुफ़्त प्लान में प्रति मिनट 10 अनुरोधों की सीमा है।
अगर आपका पहले से ही एक खाता है, तो अपने ईमेल और API टोकन से साइन इन करें। अगर आपको टोकन की एक और कॉपी चाहिए, तो जिस पते से आपने रजिस्टर किया था, उसका उपयोग करके ईमेल द्वारा इसका अनुरोध करें। चरण 2 में सुरक्षित हेडर के लिए टोकन अपने पास रखें।
Subscription के तहत अपने प्लान की जाँच करें और Available competitions के तहत अपनी लीग खोजें। यह अंश यूएफ़ा चैंपियंस लीग (CL) और बुंदेसलीगा (BL1) को दिखाता है।
- किसी दूसरे क्लब को फ़ॉलो करने के लिए, उसे प्रतियोगिता की टीमों की सूची में देखें, उदाहरण के लिए
GET /v4/competitions/PL/teams। नीचे दिए गए मैच अनुरोधों में मिली टीम आईडी और प्रतियोगिता आईडी का उपयोग करें। v4 क्विकस्टार्ट में दोनों को ढूँढ़ने का तरीका बताया गया है। - एक Quickchat AI एजेंट बनाएं, इसे Matchday Notebook नाम दें, और परीक्षण करते समय इसे निजी रखें। आपको वार्तालापों और सिमुलेशन के लिए उपलब्ध क्रेडिट की आवश्यकता है। Identity → AI Persona → Main Prompt खोलें और नीचे दिए गए निर्देशों को पेस्ट करें। स्क्रीनशॉट और कॉपी करने योग्य सेटिंग्स अंग्रेजी का उपयोग करती हैं।
दोनों जगहों पर एक ही क्लब रखें। उत्पाद में, एजेंट के निर्देश Identity के तहत रहते हैं।
Matchday Notebook Main Prompt कॉपी करें
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 के लिए, पाठक को बताएँ कि समय की पुष्टि होना अभी बाकी है।
- 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”। - API Endpoint के लिए, GET चुनें और नीचे दिया गया यूआरएल दर्ज करें। Query Params खोलें और
competitionsको शाब्दिक मान2021पर सेट करें।dateFromऔरdateToजोड़ें। हर मान के लिए, मिलती-जुलती तारीख इनपुट डालने के लिए Add AI Data → Parameters का उपयोग करें। Body को खाली छोड़ दें। - नीचे दिए गए विवरण को API Action Description के तहत पेस्ट करें और एक्शन को सेव करें। Headers के तहत, क्रेडेंशियल एक केवल-लिखने वाली
X-Auth-Tokenपंक्ति में जाएगा। अपने पहले अनुरोध से पहले उसे सेट करें।Acceptको कुंजी के रूप में औरapplication/jsonको मान के रूप में एक दूसरा, सामान्य हेडर जोड़ें। तीनों एक्शन पर समान दो हेडर का उपयोग करें।
https://api.football-data.org/v4/teams/57/matches
प्रोवाइडर संदर्भ से टीम मैचों के रूट का पालन करके एक्शन में जाएँ। आर्सेनल 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 में डालते हैं। get_club_fixtures पर Headers में उसी हेडर नाम का उपयोग करें।
साइन-इन फ़ॉर्म आपका ईमेल और API टोकन लेता है। Quickchat AI में, केवल टोकन सुरक्षित X-Auth-Token पंक्ति में जाता है।
टोकन को गोपनीय रूप से दर्ज करें। डैशबोर्ड पहले से सेव किए गए सीक्रेट को बदल सकता है। उस हेडर को शुरू में ही राइट-ओनली बनाने के लिए, हर एक्शन के लिए एक बार अकाउंट कनेक्शन का इस्तेमाल करें। ChatGPT या Claude में Quickchat AI सेटअप गाइड का उपयोग करके अपना अकाउंट कनेक्ट करें। कनेक्टेड असिस्टेंट से नीचे दिए गए निर्देश का उपयोग करके एक हानिरहित मार्कर के साथ हेडर तैयार करने के लिए कहें। फिर एक्शन का 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.
यह सेव किया गया हेडर है। प्रोवाइडर को सिर्फ़ टोकन चाहिए, बिना Bearer प्रीफ़िक्स के।
पहली बार पढ़कर देखें। Test Response → Test the API में, एक शुरुआती तारीख और अपनी अंतिम मनचाही तारीख के बाद का दिन डालें। फिर एक्शन को चालू करें और AI Preview में उस अवधि के अगले तीन लीग मैचों के कार्यक्रम के बारे में पूछें। लाइव बिल्ड के लिए, आने वाली तारीखें चुनें। आर्काइव के उदाहरण में 2026-11-18 और 2026-12-03 का इस्तेमाल किया गया था, इसलिए 2 दिसंबर की शाम की गिनती हुई। सबसे करीबी मैच की जांच करने के लिए उसका सोर्स लिंक खोलें। v4 डेट-फ़िल्टर संदर्भ बताता है कि अंतिम तारीख शामिल क्यों नहीं है।
डेटा रीप्ले में, न्यूकैसल का अवे मैच 21 नवंबर को, मैनचेस्टर सिटी का होम मैच 29 नवंबर को और ब्रेंटफ़ोर्ड का अवे मैच 2 दिसंबर को था। अगर अनुरोध 2 दिसंबर को समाप्त होता, तो ब्रेंटफ़ोर्ड का मैच छूट जाता।
3. आप आर्सेनल के पिछले पाँच मैचों के नतीजे कैसे देखेंगे?
इस उदाहरण में सबसे अहम मैच लिवरपूल 0, आर्सेनल 1 पर खत्म हुआ। अगर चैटबॉट हर बार पहले नंबर को आर्सेनल का स्कोर मानता है, तो वह अवे मैच की जीत को हार में बदल देगा। हर स्कोर को होम-अवे क्रम में रखें और यह तय करने के लिए टीम आईडी का उपयोग करें कि आर्सेनल का प्रदर्शन कैसा रहा।
get_recent_resultsनाम का एक दूसरा API Action बनाएं। उसी GET एंडपॉइंट, तारीख इनपुट, तारीख चिप्स और प्रतियोगिता फ़िल्टर का उपयोग करें। शाब्दिक मानFINISHEDके साथ क्वेरी पंक्तिstatusजोड़ें।- नीचे दिए गए विवरण को सेट करें।
get_recent_resultsके लिए राइट-ओनली हेडर सेटअप दोहराएं, मास्क की जाँच करें और एक्शन को सक्षम करें। - एक बताई गई अवधि में सबसे हाल के पाँच लीग मैचों के बारे में पूछें। उदाहरण के लिए, 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.
पहले अवे टीम की तरफ़ आर्सेनल को ढूँढ़ें, फिर अवे गोल की संख्या पढ़ें। लिवरपूल का शून्य क्लीन शीट है।
सबसे नए से शुरू करते हुए नतीजों को पढ़ें। आर्सेनल ने हल को 1-0 से हराया, लिवरपूल में 1-0 से जीता, एवर्टन को 2-0 से हराया, नॉटिंघम फ़ॉरेस्ट में 1-0 से जीता और लीड्स को 2-1 से हराया। यानी पाँच जीत, सात गोल किए और एक खाया। लिवरपूल मैच का रिकॉर्ड एक अच्छा टेस्ट है क्योंकि जीतने वाली टीम का नाम दूसरे नंबर पर है।
सेव किए गए टेस्ट डेटा में, लौटाई गई सूची जान-बूझकर लीड्स मैच से शुरू होती है और हल मैच पर समाप्त होती है। मैच शुरू होने के समय (किकऑफ़ टाइमस्टैम्प) के अनुसार छाँटने पर हल जवाब में सबसे ऊपर चला जाता है। चैट के बगल में एक्शन प्रतिक्रिया खोलें और दोनों सूचियों में पहले और आखिरी मैचों की तुलना करें।
पाँच जीतें एक ज़रूरी जानकारी छिपा सकती हैं। इनमें से दो मैच अवे थे, इसलिए जीतने वाला स्कोर दाईं ओर है।
4. लीग में टीम की जगह और अंक कहाँ से आते हैं?
पाँच जीतें बताती हैं कि पिछले कुछ हफ़्ते कैसे गए। लीग में टीम की जगह उन सभी से पहले के मैचों और बाकी सभी टीमों के नतीजों पर भी निर्भर करती है। एजेंट को अंक तालिका के लिए एक अलग एक्शन दें।
- इसका नाम
get_league_standingsरखें। GET चुनें, नीचे एंडपॉइंट पेस्ट करें और इनपुट, क्वेरी पैरामीटर और बॉडी को खाली छोड़ दें। AI decides का उपयोग करें, नीचे विवरण जोड़ें और इस Action के लिए राइट-ओनली हेडर सेटअप दोहराएं। - Test Response में,
standingsके अंदर उस एंट्री को देखें जिसकाtypeTOTALहै। उसकेtableमें, वह एंट्री ढूँढ़ें जहाँteam.id57के बराबर हो। एक्शन को चालू करें और पूछें “प्रीमियर लीग की अंक तालिका में आर्सेनल कहाँ है?” - उसी सीज़न और तारीख के लिए
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.
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.
कॉल में तारीखों और मैच आईडी की जाँच करें। स्थानीय डेटा रीप्ले में, 560651 न्यूकैसल का मैच है।
दोहराने योग्य जांच के लिए, Conversations → Testing खोलें, एक डेटासेट बनाएं और तीन प्रश्न सहेजें। नीचे दिखाए गए दो सीमा प्रश्न जोड़ें। एक Action विवरण बदलने के बाद डेटासेट चलाएं और उत्तरों के साथ कॉल का निरीक्षण करें। एक दुर्लभ स्थिति या त्रुटि का अभ्यास करने के लिए एक नियंत्रित प्रतिक्रिया का उपयोग करें। एक काल्पनिक प्रश्न अकेले एक उत्तर के शब्दों का परीक्षण करता है।
हर बदलाव के बाद उन्हीं सवालों का इस्तेमाल करें। अवे मैच का नतीजा स्कोरिंग की ऐसी गलती पकड़ लेता है जो सिर्फ़ होम मैचों के टेस्ट में छूट जाती।
| परीक्षण मामला | समर्थक को क्या जवाब मिलना चाहिए |
|---|---|
एक मैच स्थगित कर दिया गया है और दोनों गोल null हैं। क्या यह ड्रॉ था? | मैच स्थगित कर दिया गया था। कोई स्कोर दर्ज नहीं है। |
एक सफल खोज एक खाली matches सूची लौटाती है। क्या पूरा सीज़न खाली है? | उस अवधि में कोई मैच नहीं मिला। वे तारीखें बताएं जिन्हें आपने खोजा था। |
| प्रदाता 401 या 403 लौटाता है। | जानकारी नहीं मिल सकी। सेव किए गए टोकन और प्रतियोगिता कवरेज की जाँच करें। |
| प्रदाता 429 लौटाता है। | अनुरोध की सीमा पूरी हो गई है। रुकें और बाद में फिर से प्रयास करें। |
एक खाली विंडो का मतलब भी अनुरोध सफल होना है। सहायक तारीखों की सीमा बढ़ाने का सुझाव दे सकता है।
मैच शुरू होने के बदले हुए समय की दूसरी राय के लिए, इसकी तुलना लीग के प्रकाशित मैच कार्यक्रम संशोधनों से करें। निर्धारित तारीख, समय क्षेत्र और जिस तारीख को आपने इसे देखा था, उसे एक साथ रखें। मुफ़्त फ़ीड किसी प्रसारण में हुए बदलाव को दिखाने में देर कर सकता है, जो तब मायने रखता है जब कोई आपके जवाब के आधार पर अपने शनिवार की योजना बना रहा हो।
Football data provided by the Football-Data.org API. इस पुराने उदाहरण में प्रदाता के सार्वजनिक Native Stats पेजों का उपयोग किया गया है। वर्तमान कवरेज और ताज़ा जानकारी के लिए फ़ीड प्लान और अनुरोध की सीमाएं देखें।
अक्सर पूछे जाने वाले प्रश्न
मैचों के कार्यक्रम बताने वाले चैटबॉट के लिए मैं किस फुटबॉल API का उपयोग कर सकता हूँ?
football-data.org v4 API कवर की गई प्रतियोगिताओं के लिए मैचों का कार्यक्रम, नतीजे और अंक तालिका प्रदान करता है। टीम के मैचों के कार्यक्रम और हालिया प्रदर्शन के लिए टीम के मैचों के एंडपॉइंट का, और लीग में स्थिति जानने के लिए प्रतियोगिता के अंक तालिका एंडपॉइंट का उपयोग करें।
क्या football-data.org के मुफ़्त प्लान पर स्कोर लाइव होते हैं?
मुफ़्त प्लान में देरी से मिलने वाले स्कोर और मैचों के कार्यक्रम, कवर की गई प्रतियोगिताओं के लिए लीग की अंक तालिकाएँ और प्रति मिनट 10 API कॉल शामिल हैं। हर जवाब के साथ स्रोत और तारीख शामिल करें और अगर आपको लाइव स्कोर चाहिए तो अपना प्लान जाँचें।
मैं आर्सेनल को दूसरी टीम में कैसे बदलूँ?
football-data.org में क्लब की टीम आईडी और प्रतियोगिता खोजें। दोनों मैच एक्शन में टीम 57 को बदलें, संख्यात्मक प्रतियोगिता फ़िल्टर और अंक तालिका का यूआरएल बदलें, फिर निर्देशों में क्लब का नाम और टीम आईडी अपडेट करें। किसी ऐसे मैच से जाँच करें जिसे आप पहचानते हैं।
मैं टीम के नज़रिए से पिछले पाँच मैच कैसे देख सकता हूँ?
एक तय तारीख की सीमा में समाप्त हो चुके लीग मैचों के लिए फ़िल्टर करें, मैच शुरू होने के समय के अनुसार सबसे नए से सबसे पुराने क्रम में लगाएँ और अधिकतम पाँच मैच चुनें। हर स्कोर के लिए, जीत, ड्रॉ या हार तय करने से पहले यह जाँचें कि आपकी टीम घरेलू मैदान पर खेली थी या बाहर। यदि पाँच से कम मैच मिलते हैं, तो बताएँ कि आपको कितने मिले।
स्थगित मैच के लिए खाली स्कोर का क्या मतलब है?
एक खाली स्कोर का मतलब है कि प्रदाता ने उस पक्ष के लिए कोई गोल कुल प्रदान नहीं किया है। मैच की स्थिति को दृश्यमान रखें और स्कोर को अज्ञात छोड़ दें। एक गोल रहित ड्रॉ के लिए दो रिकॉर्ड किए गए शून्य के साथ एक समाप्त मैच की आवश्यकता होती है।
मैं किसी फुटबॉल मैच के शुरू होने के समय को अपने समय क्षेत्र में कैसे बदलूँ?
मैच के UTC किकऑफ़ से शुरू करें, America/New_York जैसे नामित समय क्षेत्र का उपयोग करें और उत्तर में तारीख रखें। डेलाइट सेविंग और कैलेंडर दिन का परिवर्तन दोनों प्रदर्शित समय को प्रभावित कर सकते हैं।