Sobotu si plánujete podľa zápasu Arsenalu vonku proti Newcastle. Priateľ v New Yorku potrebuje vedieť čas výkopu. Potom sa niekto v skupinovom chate spýta, ako sa Arsenalu darilo v poslednom zápase vonku. Prvá odpoveď sa nachádza v rozpise zápasov. Pre druhú musíte vedieť, komu patrí gól pri výsledku „Liverpool 0, Arsenal 1“.
Vytvoríte si Matchday Notebook, futbalového chatbota, ktorý vyhľadá najbližšie tri zápasy Premier League, načíta posledných päť ligových výsledkov Arsenalu a nájde jeho umiestnenie v tabuľke. Príklad je fixovaný na 18. november 2026. Zápas vonku proti Newcastle bol naplánovaný na sobotu 21. novembra o 17:30 UTC, čiže o 12:30 v New Yorku.
Stránka zápasu u poskytovateľa a súkromný Agent sa zhodujú v čase výkopu. Konverzácia v Quickchat AI prebehla s použitím archivovaného záznamu verejných dát, ktorý si môžete zopakovať nižšie.
Skontrolujte rozpis zápasu s Newcastle alebo si stiahnite súpravu Matchday Notebook. Rozbaľte ju a spustením python3 replay.py si bez potreby účtu zobrazíte tri zápasy, päť výsledkov a riadok tabuľky. Tá istá súprava obsahuje nastavenia akcie a Main Prompt na pripojenie vášho vlastného zdroja dát.
1. Ktorý klub a súťaž bude chatbot sledovať?
Najprv si zvoľte klub a ligu. Ligová forma Arsenalu sa môže meniť podľa toho, či rátate aj utorňajší večer v európskej súťaži. V tomto zápisníku Arsenal znamená tím 57 a liga znamená Premier League 2021, známu aj pod kódom PL.
- Otvorte registračný formulár football-data.org. Zadajte svoje krstné meno a e-mailovú adresu, prijmite podmienky a vyberte Create account. Skontrolujte svoju ligu v zozname pokrytia. Bezplatný plán zahŕňa Premier League s oneskorenými rozpismi zápasov a výsledkami.
Použite e-mailovú adresu, ktorú si viete skontrolovať. Služba football-data.org vám tam po registrácii pošle kľúč API. Bezplatný plán povoľuje 10 požiadaviek za minútu.
Ak už máte účet, prihláste sa pomocou svojho e-mailu a tokenu API. Ak potrebujete ďalšiu kópiu tokenu, vyžiadajte si ju e-mailom na adresu, ktorú ste zaregistrovali. Token si odložte pre chránenú hlavičku v kroku 2.
Svoj plán si skontrolujte v časti Subscription Subscription a svoju ligu si vyhľadajte v časti Available competitions Available competitions. Tento úryvok zobrazuje Ligu majstrov UEFA (CL) a Bundesligu (BL1).
- Ak chcete sledovať iný klub, vyhľadajte ho v zozname tímov danej súťaže, napríklad príkazom
GET /v4/competitions/PL/teams. V požiadavkách na zápasy nižšie použite vrátené ID tímu a ID súťaže. Stručný návod pre v4 obsahuje oba spôsoby vyhľadávania. - Vytvorte si Agenta Quickchat AI, pomenujte ho Matchday Notebook a počas testovania ho udržujte súkromného. Potrebujete dostupné kredity na konverzácie a simulácie. Otvorte Identity → AI Persona → Main Prompt a vložte pokyny nižšie. Snímky obrazovky a kopírovateľné nastavenia používajú angličtinu.
Udržujte rovnaký klub na oboch miestach. V produkte sú pokyny Agenta pod Identity.
Skopírujte 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. Ako získate najbližší zápas Arsenalu?
Začnite s akciou, ktorá odpovie na otázku o čase výkopu v skupinovom chate. Jedna požiadavka vráti oba kluby, plánovaný čas a stav zápasu. Filter stavu tu nechajte otvorený, aby sa mohol zobraziť aj odložený zápas. Záznam so stavom TIMED má čas výkopu. Pri stave SCHEDULED informujte používateľa, že hodina ešte nebola potvrdená.
- Otvorte Actions & MCPs → Add Action → API Action → Create manually. Nastavte API Action Name na
get_club_fixturesa When to run na AI decides. Pod What to ask the user first pridajte požadované vstupy typu Text s názvamidate_fromadate_to, oba s nastavením No default. Ich popisy sú „Počiatočný dátum na zahrnutie (UTC), YYYY-MM-DD“ a „Koncový dátum na vylúčenie (UTC), YYYY-MM-DD“. - Pre API Endpoint vyberte GET a zadajte URL adresu nižšie. Otvorte Query Params a nastavte
competitionsna hodnotu2021. PridajtedateFromadateTo. Pre každú hodnotu použite Add AI Data → Parameters na vloženie zodpovedajúceho dátumového vstupu. Pole Body nechajte prázdne. - Vložte popis nižšie pod API Action Description a uložte akciu. Pod Headers sa poverenie uloží do riadka
X-Auth-Tokenlen na zápis. Nastavte to pred prvou požiadavkou. Pridajte druhú, bežnú hlavičku sAcceptako kľúčom aapplication/jsonako hodnotou. Použite rovnaké dve hlavičky pre všetky tri akcie.
https://api.football-data.org/v4/teams/57/matches
Postupujte podľa cesty k zápasom tímu z referenčnej príručky poskytovateľa do akcie. Arsenal je pevne daný v URL, liga v Query Params a dva dátumy pochádzajú z konverzácie.
Skopírujte popis akcie pre rozpis zápasov
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.
V príkladoch požiadaviek od poskytovateľa je kľúč API uvedený v X-Auth-Token. Rovnaký názov hlavičky použite v Headers v akcii get_club_fixtures.
Do prihlasovacieho formulára zadajte svoj e-mail a token API. V Quickchat AI sa do chráneného riadka X-Auth-Token vkladá iba token.
Zadajte token súkromne. Ovládací panel môže nahradiť uložený tajný kľúč. Ak chcete, aby bola táto hlavička od začiatku iba na zápis, použite pripojenie k účtu raz pre každú Akciu. Pripojte svoj účet pomocou sprievodcu nastavením Quickchat AI v ChatGPT alebo Claude. Požiadajte pripojeného asistenta, aby pripravil hlavičku s neškodným označením pomocou pokynu nižšie. Potom sami otvorte kartu Headers danej Akcie, nahraďte hodnotu v tom istom riadku vaším nespracovaným tokenom football-data.org a vyberte Save changes. Znova otvorte editor a skontrolujte, či zobrazuje [redacted]. Token uchovávajte na ovládacom paneli a mimo konverzácie.
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.
Toto je uložená hlavička. Poskytovateľ očakáva samotný token, bez predpony Bearer.
Vyskúšajte prvé načítanie. V Test Response → Test the API zadajte počiatočný dátum a deň po poslednom požadovanom dátume. Potom povoľte Akciu a v AI Preview požiadajte o najbližšie tri ligové zápasy v tomto časovom okne. Pre aktuálne zostavenie vyberte nadchádzajúce dátumy. Príklad z archívu použil 2026-11-18 a 2026-12-03, takže sa započítal aj večer 2. decembra. Skontrolujte najbližší zápas otvorením odkazu na jeho zdroj. Referenčná príručka pre filter dátumov v4 vysvetľuje, prečo sa koncový dátum nezahŕňa.
V dátovej ukážke pripadol zápas vonku proti Newcastlu na 21. novembra, domáci zápas s Manchester City na 29. novembra a zápas vonku proti Brentfordu na 2. decembra. Ukončenie požiadavky dátumom 2. december by zápas s Brentfordom vynechalo.
3. Ako zistíte posledných päť výsledkov z pohľadu Arsenalu?
Najdôležitejší zápas v tomto príklade sa skončil Liverpool 0, Arsenal 1. Ak chatbot zakaždým považuje prvé číslo za skóre Arsenalu, zmení víťazstvo na ihrisku súpera na prehru. Ponechajte každé skóre v poradí domáci-hostia a pomocou ID tímu rozhodnite, ako sa darilo Arsenalu.
- Vytvorte druhú API Action s názvom
get_recent_results. Použite rovnaký koncový bod GET, vstupy pre dátum, dátumové čipy a filter súťaže. Pridajte riadok dopytustatuss doslovnou hodnotouFINISHED. - Nastavte popis nižšie. Zopakujte nastavenie hlavičky len na zápis pre
get_recent_results, skontrolujte masku a povoľte akciu. - Požiadajte o päť najnovších ligových zápasov v zadanom časovom okne. Pre tento príklad použite obdobie od 1. októbra do 17. novembra 2026. Pred výberom piatich zápasov ich zoraďte podľa
utcDate. Ak okno vráti iba tri, zobrazte tieto tri a ponúknite možnosť hľadať ďalej do minulosti.
Skopírovať popis Akcie pre výsledky
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.
Najprv nájdite Arsenal na strane hostí, potom si prečítajte počet gólov hostí. Nula na strane Liverpoolu znamená čisté konto.
Čítajte sériu od najnovších zápasov. Arsenal porazil Hull 1:0, vyhral 1:0 na ihrisku Liverpoolu, porazil Everton 2:0, vyhral 1:0 na ihrisku Nottinghamu Forest a porazil Leeds 2:1. To je spolu päť víťazstiev, sedem strelených a jeden inkasovaný gól. Záznam zápasu s Liverpoolom je dobrým testom, pretože víťazný tím je uvedený ako druhý.
V uložených testovacích dátach sa vrátený zoznam zámerne začína zápasom s Leedsom a končí zápasom s Hullom. Zoradenie podľa času výkopu presunie Hull na začiatok odpovede. Otvorte odpoveď akcie vedľa četu a porovnajte prvý a posledný zápas v oboch zoznamoch.
Päť víťazstiev môže skrývať dôležitý detail. Dve z nich boli na ihrisku súpera, takže víťazné číslo je vpravo.
4. Odkiaľ pochádza umiestnenie v lige a počet bodov?
Päť víťazstiev vám napovie, ako sa tímu darilo v posledných týždňoch. Umiestnenie v lige však závisí aj od všetkých predchádzajúcich zápasov a od výsledkov ostatných tímov. Dajte Agentovi samostatnú Akciu pre ligovú tabuľku.
- Pomenujte ju
get_league_standings. Zvoľte GET, vložte koncový bod nižšie a vstupy, parametre dopytu a telo nechajte prázdne. Použite AI decides, pridajte popis nižšie a zopakujte nastavenie hlavičky iba na zápis pre túto Akciu. - V Test Response hľadajte v
standingszáznam, ktoréhotypejeTOTAL. V rámci jehotablenájditeteam.idrovné57. Povoľte Akciu a položte otázku „Kde je Arsenal v tabuľke Premier League?“ - Porovnajte
position,playedGamesapointsso zdrojom pre rovnakú sezónu a dátum. Dňa 18. novembra tabuľka Premier League v Native Stats ukazovala 1. miesto, 10 odohraných zápasov, 27 bodov. Vaša aktuálna tabuľka sa bude meniť podľa toho, ako budú hrať ostatné kluby.
https://api.football-data.org/v4/competitions/PL/standings
Skopírovať popis Akcie pre ligovú tabuľku
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.
Prečítajte si jeden riadok v TOTAL. Tých 27 bodov zahŕňa všetkých desať ligových zápasov v tejto snímke.
5. Dá sa predzápasový brífing vystopovať až k jeho zdrojom?
Začnite novú konverzáciu v AI Preview. Opýtajte sa na najbližšie tri zápasy, pokračujte otázkou „Ako sa nám darilo v posledných piatich ligových zápasoch?“, zadajte časové okno pre výsledky a potom sa opýtajte „Na ktorom mieste v tabuľke sa nachádzame?“. V Inbox otvorte pre každú odpoveď značku volanej Akcie. View logs danej Akcie vám umožní porovnať parametre a odpoveď s tým, čo videl fanúšik. Sprievodca vytváraním API Action ukazuje, kde tieto ovládacie prvky nájdete.
Ak chcete získať súhrn z hracieho dňa zobrazený na začiatku článku, položte otázku nižšie s použitím dátumov z uloženého príkladu. Pre aktuálny súhrn použite nadchádzajúce dátumy pre rozpis zápasov a nedávne dátumy pre výsledky.
Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.
Skontrolujte dátumy a ID zápasu vo volaní. V lokálnej dátovej ukážke je 560651 zápas s Newcastlom.
Pre opakovateľnú kontrolu otvorte Conversations → Testing, vytvorte dátovú sadu a uložte tri otázky. Pridajte dve hraničné otázky uvedené nižšie. Spustite dátovú sadu po zmene popisu Akcie a skontrolujte volania spolu s odpoveďami. Použite kontrolovanú odpoveď na otestovanie zriedkavého stavu alebo chyby. Samotná hypotetická otázka testuje iba formuláciu odpovede.
Po každej úprave použite rovnaké otázky. Výsledok zo zápasu vonku odhalí chybu v skóre, ktorú by test iba s domácimi zápasmi prehliadol.
| Testovací prípad | Čo by mal fanúšik počuť |
|---|---|
Zápas je odložený a oba góly sú null. Bola to remíza? | Zápas bol odložený. Nie je zaznamenané žiadne skóre. |
Úspešné vyhľadávanie vráti prázdny zoznam matches. Je celá sezóna prázdna? | V danom časovom okne sa nenašli žiadne zápasy. Uveďte dátumy, v ktorých ste hľadali. |
| Poskytovateľ vráti 401 alebo 403. | Vyhľadávanie zlyhalo. Skontrolujte uložený token a pokrytie súťaže. |
| Poskytovateľ vráti 429. | Dosiahli ste limit počtu požiadaviek. Počkajte a skúste to znova neskôr. |
Prázdne okno má stále úspešnú požiadavku. Asistent môže ponúknuť rozšírenie dátumov.
Ak si chcete overiť zmenený čas výkopu, porovnajte ho s oficiálnymi zmenami v rozpise zápasov, ktoré zverejnila liga. Poznačte si pôvodný dátum, časové pásmo a dátum, kedy ste si údaj vyhľadali. Bezplatný zdroj údajov môže mať oproti zmenám vo vysielaní oneskorenie, čo je dôležité, ak si niekto podľa odpovede plánuje sobotu.
Football data provided by the Football-Data.org API. Tento príklad s konkrétnym dátumom využíva verejné stránky poskytovateľa Native Stats. Aktuálne pokrytie a čerstvosť dát nájdete v časti Dátové balíčky a limity počtu požiadaviek.
Často kladené otázky
Aké futbalové API môžem použiť pre chatbota s rozpisom zápasov?
API football-data.org v4 poskytuje rozpis zápasov, výsledky a ligové tabuľky pre podporované súťaže. Pre rozpis a nedávnu formu tímu použite koncový bod pre zápasy tímu a pre postavenie v lige koncový bod pre tabuľku súťaže.
Sú výsledky football-data.org živé na bezplatnom pláne?
Bezplatný plán zahŕňa oneskorené výsledky a rozpisy, ligové tabuľky pre podporované súťaže a limit 10 volaní API za minútu. Ku každej odpovedi uveďte zdroj a dátum a ak potrebujete živé výsledky, skontrolujte si svoj plán.
Ako zmením Arsenal na iný tím?
Nájdite ID klubu a súťaž v football-data.org. V oboch akciách pre zápasy nahraďte tím 57, zmeňte číselný filter súťaže a URL adresu tabuľky, potom v pokynoch aktualizujte názov klubu a ID tímu. Otestujte to na zápase, ktorý poznáte.
Ako získam posledných päť zápasov z pohľadu tímu?
Filtrujte ukončené ligové zápasy v zadanom časovom okne, zoraďte ich podľa času výkopu od najnovšieho po najstarší a vyberte najviac päť. Pri každom výsledku skontrolujte, či váš tím hral doma alebo vonku, a až potom priraďte výhru, remízu alebo prehru. Ak sa kvalifikuje menej ako päť zápasov, uveďte, koľko ste ich našli.
Čo znamená prázdne skóre pre odložený zápas?
Prázdne skóre znamená, že poskytovateľ neuviedol celkový počet gólov pre danú stranu. Ponechajte stav zápasu viditeľný a skóre nechajte neznáme. Bezgólová remíza si vyžaduje ukončený zápas s dvoma zaznamenanými nulami.
Ako prepočítam futbalový výkop na moje časové pásmo?
Začnite s výkopom zápasu v UTC, použite pomenované časové pásmo ako America/New_York a dátum ponechajte v odpovedi. Letný čas aj zmena kalendárneho dňa môžu ovplyvniť zobrazený čas.