Plánujete si sobotu podle výjezdu Arsenalu do Newcastlu. Kamarád v New Yorku potřebuje vědět čas výkopu. Pak se někdo ve skupinovém chatu zeptá, jak si Arsenal vedl při posledním venkovním zápase. První odpověď najdete v rozpisu zápasů. Pro tu druhou musíte vědět, čí je ten gól v zápise „Liverpool 0, Arsenal 1“.
Sestavíte si Matchday Notebook, fotbalového chatbota, který vyhledá tři nejbližší zápasy Premier League, zobrazí pět posledních ligových výsledků Arsenalu a najde jeho umístění v tabulce. Příklad je navázán na datum 18. listopadu 2026. Zápas venku s Newcastlem se měl hrát v sobotu 21. listopadu v 17:30 UTC, tedy ve 12:30 v New Yorku.
Stránka zápasu u poskytovatele a soukromý Agent se na čase výkopu shodnou. Konverzace v Quickchat AI proběhla na základě datované simulace veřejných záznamů, kterou si můžete zopakovat níže.
Zkontrolujte si zápas s Newcastlem nebo si stáhněte sadu pro Matchday Notebook. Rozbalte ji a spuštěním python3 replay.py si bez nutnosti účtu zobrazíte tři zápasy, pět výsledků a řádek tabulky. Sada obsahuje také nastavení akcí a Main Prompt pro připojení vlastního zdroje dat.
1. Který klub a soutěž bude chatbot sledovat?
Nejprve si pevně stanovte klub a ligu. Ligová forma Arsenalu se může lišit podle toho, jestli započítáte i úterní evropský pohár. V tomto zápisníku znamená Arsenal tým 57 a liga znamená Premier League 2021, známou také pod kódem PL.
- Otevřete registrační formulář football-data.org. Zadejte své jméno a e-mailovou adresu, přijměte podmínky a vyberte Create account. Svou ligu si ověřte v seznamu pokrytí. Bezplatný tarif zahrnuje Premier League se zpožděnými rozpisy zápasů a výsledky.
Použijte e-mailovou adresu, ke které máte přístup. Služba football-data.org vám na ni po registraci zašle klíč API. Bezplatný tarif umožňuje 10 požadavků za minutu.
Pokud již máte účet, přihlaste se pomocí svého e-mailu a tokenu API. Pokud potřebujete další kopii tokenu, vyžádejte si ji e-mailem na adresu, kterou jste zaregistrovali. Token si uschovejte pro chráněnou hlavičku v kroku 2.
Svůj tarif si zkontrolujte v části Subscription a svou ligu si vyhledejte v části Available competitions. Tento výřez ukazuje Ligu mistrů UEFA (CL) a Bundesligu (BL1).
- Pokud chcete sledovat jiný klub, vyhledejte si ho v seznamu týmů dané soutěže, například pomocí
GET /v4/competitions/PL/teams. Vrácené ID týmu a ID soutěže použijte v níže uvedených požadavcích na zápasy. Obě vyhledání najdete v rychlém průvodci pro v4. - Vytvořte si Agenta v Quickchat AI, pojmenujte ho Matchday Notebook a během testování ho ponechte jako soukromého. Pro konverzace a simulace potřebujete mít k dispozici kredity. Otevřete Identity → AI Persona → Main Prompt a vložte níže uvedené pokyny. Snímky obrazovky a nastavení, která lze zkopírovat, jsou v angličtině.
Udržujte stejný klub na obou místech. V produktu jsou pokyny Agenta pod Identity.
Zkopí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. Jak zjistíte příští zápas Arsenalu?
Začněte akcí, která odpoví na otázku ohledně času výkopu z vašeho skupinového chatu. Jeden požadavek vrátí oba kluby, plánovaný čas a stav zápasu. Filtr stavu zde nechte otevřený, aby se mohl zobrazit i případný odložený zápas. Záznam se stavem TIMED má čas výkopu. U stavu SCHEDULED sdělte uživateli, že čas bude teprve potvrzen.
- Otevřete Actions & MCPs → Add Action → API Action → Create manually. Nastavte API Action Name na
get_club_fixturesa When to run na AI decides. V části What to ask the user first přidejte požadované vstupy typu Textdate_fromadate_to, oba s nastavením No default. Jejich popisy jsou „První datum UTC (včetně), YYYY-MM-DD“ a „První datum UTC (vyjma), YYYY-MM-DD“. - Pro API Endpoint zvolte GET a zadejte níže uvedenou URL. Otevřete Query Params a nastavte
competitionsna literál2021. PřidejtedateFromadateTo. Pro každou hodnotu použijte Add AI Data → Parameters k vložení odpovídajícího vstupního data. Pole Body ponechte prázdné. - Vložte popis níže pod API Action Description a uložte akci. Pod Headers se přihlašovací údaje uloží do řádku
X-Auth-Tokenpouze pro zápis. Nastavte to před prvním požadavkem. Přidejte druhou, běžnou hlavičku sAcceptjako klíčem aapplication/jsonjako hodnotou. Použijte stejné dvě hlavičky u všech tří akcí.
https://api.football-data.org/v4/teams/57/matches
Postupujte podle cesty k zápasům týmu z referenčních materiálů poskytovatele do akce. Arsenal je pevně daný v URL, liga v Query Params a dvě data pocházejí z konverzace.
Zkopírujte popis akce zápasu
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.
Příklady požadavků poskytovatele vkládají klíč API do X-Auth-Token. Stejný název hlavičky použijte v Headers u get_club_fixtures.
Přihlašovací formulář vyžaduje váš e-mail a token API. V Quickchat AI se do chráněného řádku X-Auth-Token vkládá pouze token.
Token zadejte soukromě. Ovládací panel může nahradit uložený tajný klíč. Chcete-li, aby byla tato hlavička od začátku pouze pro zápis, použijte připojení účtu pro každou akci pouze jednou. Připojte svůj účet pomocí průvodce nastavením Quickchat AI v ChatGPT nebo Claude. Požádejte připojeného asistenta, aby pomocí níže uvedeného pokynu připravil hlavičku se zástupným symbolem. Poté sami otevřete kartu Headers dané akce, na stejném řádku nahraďte hodnotu svým tokenem football-data.org a vyberte Save changes. Znovu otevřete editor a zkontrolujte, zda se zobrazuje [redacted]. Token uchovávejte na ovládacím panelu a mimo konverzaci.
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é záhlaví. Poskytovatel očekává samotný token, bez předpony Bearer.
Vyzkoušejte první načtení. V Test Response → Test the API zadejte počáteční datum a den po posledním požadovaném datu. Poté akci povolte a v AI Preview se zeptejte na tři nejbližší ligové zápasy v daném období. Pro aktuální sestavení zvolte nadcházející data. Příklad z archivu použil 2026-11-18 a 2026-12-03, takže se započítal i večer 2. prosince. Nejbližší zápas zkontrolujte otevřením jeho zdrojového odkazu. Referenční příručka k filtrování podle data v4 vysvětluje, proč se koncové datum nezahrnuje.
V datové replice se zápas venku s Newcastlem hrál 21. listopadu, doma s Manchesterem City 29. listopadu a venku s Brentfordem 2. prosince. Pokud by požadavek končil datem 2. prosince, zápas s Brentfordem by v seznamu chyběl.
3. Jak zjistíte posledních pět výsledků Arsenalu?
Nejlepším příkladem je zápas, který skončil Liverpool 0, Arsenal 1. Pokud chatbot považuje první číslo vždy za skóre Arsenalu, změní výhru venku na prohru. Každé skóre uvádějte v pořadí domácí-hosté a pomocí ID týmu určete, jak si Arsenal vedl.
- Vytvořte druhou akci API Action s názvem
get_recent_results. Použijte stejný koncový bod GET, stejné vstupy pro datum, datové čipy a filtr soutěže. Přidejte řádek dotazustatuss hodnotouFINISHED. - Nastavte popis uvedený níže. Pro
get_recent_resultszopakujte nastavení hlavičky pouze pro zápis, zkontrolujte maskování a akci povolte. - Požádejte o pět posledních ligových zápasů v zadaném období. Pro tento příklad použijte období od 1. října do 17. listopadu 2026. Před výběrem pěti zápasů výsledky seřaďte podle
utcDate. Pokud se v daném období najdou jen tři zápasy, zobrazte je a nabídněte vyhledání starších výsledků.
Zkopírovat popis akce pro 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.
Nejprve najděte Arsenal na straně hostů, poté si přečtěte počet gólů hostů. Nula na straně Liverpoolu znamená čisté konto.
Čtěte sérii od nejnovějšího zápasu. Arsenal porazil Hull 1:0, vyhrál 1:0 na hřišti Liverpoolu, porazil Everton 2:0, vyhrál 1:0 na hřišti Nottinghamu Forest a porazil Leeds 2:1. To je celkem pět výher, sedm vstřelených a jeden obdržený gól. Záznam zápasu s Liverpoolem je dobrým testem, protože vítězný tým je uveden jako druhý.
V uložených testovacích datech vrácený seznam záměrně začíná zápasem s Leedsem a končí zápasem s Hullem. Seřazení podle času výkopu přesune Hull na začátek odpovědi. Otevřete si vedle chatu odpověď akce a porovnejte první a poslední zápas v obou seznamech.
Pět výher může skrývat důležitý detail. Dva z těchto zápasů se hrály venku, takže vítězné skóre je na pravé straně.
4. Odkud se berou pozice v lize a body?
Pět výher vám napoví, jak se dařilo v posledních týdnech. Umístění v lize ale závisí také na všech předchozích zápasech a na výsledcích ostatních týmů. Dejte agentovi samostatnou akci pro ligovou tabulku.
- Pojmenujte ji
get_league_standings. Zvolte GET, vložte níže uvedený koncový bod a vstupní pole, parametry dotazu i tělo požadavku nechte prázdné. Použijte AI decides, přidejte níže uvedený popis a zopakujte pro tuto akci nastavení hlavičky pouze pro zápis. - V Test Response se podívejte do
standingsna položku, jejížtypejeTOTAL. V její částitablenajděteteam.ids hodnotou57. Povolte akci a položte otázku „Kde je Arsenal v tabulce Premier League?“ - Porovnejte
position,playedGamesapointsse zdrojem pro stejnou sezónu a datum. Dne 18. listopadu tabulka Premier League v Native Stats ukazovala 1. místo, 10 odehraných zápasů, 27 bodů. Vaše aktuální tabulka se bude měnit, jak budou hrát ostatní kluby.
https://api.football-data.org/v4/competitions/PL/standings
Zkopírovat popis akce pro ligovou tabulku
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.
Přečtěte si jeden řádek v TOTAL. 27 bodů pokrývá všech deset ligových zápasů v tomto snímku.
5. Můžete dohledat předzápasový přehled až k jeho zdrojům?
Začněte novou konverzaci v AI Preview. Zeptejte se na tři nejbližší zápasy, navažte dotazem „Jak jsme si vedli v posledních pěti ligových zápasech?“, zadejte období pro výsledky a poté se zeptejte „Na jakém místě v tabulce nás to nechává?“. V Inbox otevřete u každé odpovědi značku volané akce. V View logs dané akce můžete porovnat parametry a odpověď s tím, co viděl fanoušek. Průvodce vytvořením API Action ukazuje, kde tyto ovládací prvky najdete.
Chcete-li získat souhrn pro hrací den zobrazený na začátku článku, položte níže uvedenou otázku s daty z uloženého příkladu. Pro aktuální souhrn použijte nadcházející data pro rozpis zápasů a nedávná data pro 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.
Zkontrolujte data a ID zápasu ve volání. V místní datové replice je 560651 zápas s Newcastlem.
Pro opakovatelnou kontrolu otevřete Conversations → Testing, vytvořte datovou sadu a uložte tři otázky. Přidejte dvě hraniční otázky uvedené níže. Spusťte datovou sadu po změně popisu akce a zkontrolujte volání spolu s odpověďmi. Použijte řízenou odpověď k procvičení vzácného stavu nebo chyby. Samotná hypotetická otázka testuje formulaci odpovědi.
Po každé úpravě použijte stejné otázky. Výsledek z venkovního zápasu odhalí chybu ve skóre, kterou by test pouze s domácími zápasy přehlédl.
| Testovací případ | Co by měl fanoušek slyšet |
|---|---|
Zápas je odložen a oba góly mají hodnotu null. Byla to remíza? | Zápas byl odložen. Není zaznamenáno žádné skóre. |
Úspěšné vyhledávání vrátí prázdný seznam matches. Je celá sezóna prázdná? | V zadaném období nebyly nalezeny žádné zápasy. Uveďte data, ve kterých jste hledali. |
| Poskytovatel vrátí 401 nebo 403. | Vyhledávání selhalo. Zkontrolujte uložený token a pokrytí soutěže. |
| Poskytovatel vrátí 429. | Byl dosažen limit počtu požadavků. Chvíli počkejte a zkuste to znovu. |
I pro časové okno bez zápasů je požadavek úspěšný. Asistent může nabídnout rozšíření časového období.
Pokud si chcete ověřit změnu času výkopu, porovnejte ji s publikovanými změnami v rozpisu zápasů na webu ligy. Poznamenejte si naplánované datum, časové pásmo a datum, kdy jste informaci vyhledali. Bezplatný zdroj dat může mít oproti změnám ve vysílání zpoždění, což je důležité, pokud si někdo podle odpovědi plánuje sobotu.
Football data provided by the Football-Data.org API. Tento datovaný příklad používá veřejné stránky Native Stats poskytovatele. Aktuální pokrytí a aktuálnost najdete v tarifech a limitech požadavků.
Často kladené otázky
Jaké fotbalové API mohu použít pro chatbota s rozpisy zápasů?
API football-data.org v4 poskytuje rozpisy zápasů, výsledky a tabulky pro pokryté soutěže. Použijte koncový bod zápasů týmu pro rozpis a nedávnou formu a koncový bod tabulek soutěže pro ligovou pozici.
Jsou na bezplatném tarifu football-data.org výsledky živě?
Bezplatný tarif zahrnuje výsledky a rozpisy se zpožděním, ligové tabulky pro podporované soutěže a limit 10 volání API za minutu. Ke každé odpovědi uveďte zdroj a datum a pokud potřebujete živé výsledky, zkontrolujte si svůj tarif.
Jak změním Arsenal na jiný tým?
Najděte si v football-data.org ID týmu a soutěže. V obou akcích pro zápasy nahraďte tým 57, změňte číselný filtr soutěže a URL adresu tabulky a poté v pokynech aktualizujte název klubu a ID týmu. Funkčnost si ověřte na zápase, který znáte.
Jak získám posledních pět zápasů z pohledu týmu?
Filtrujte dohrané ligové zápasy v zadaném časovém okně, seřaďte je od nejnovějšího po nejstarší a vyberte jich až pět. U každého výsledku zkontrolujte, zda váš tým hrál doma, nebo venku, a podle toho mu přiřaďte výhru, remízu, nebo prohru. Pokud jich najdete méně než pět, uveďte, kolik se vám jich podařilo najít.
Co znamená prázdné skóre u odloženého zápasu?
Prázdné skóre znamená, že poskytovatel pro danou stranu neuvedl žádný počet gólů. Ponechte stav zápasu viditelný a skóre nechte nevyplněné. Bezbranková remíza vyžaduje dohraný zápas se dvěma zaznamenanými nulami.
Jak převedu čas fotbalového výkopu do svého časového pásma?
Začněte s výkopem zápasu v UTC, použijte pojmenované časové pásmo, jako je America/New_York, a v odpovědi ponechte datum. Letní čas a změna kalendářního dne mohou ovlivnit zobrazený čas.