Planirate subotu oko Arsenalovog gostovanja u Newcastleu. Prijatelju u New Yorku treba vrijeme početka utakmice. Zatim netko u grupnom chatu pita kako je Arsenal prošao na zadnjem gostovanju. Odgovor na prvo pitanje nalazi se u rasporedu utakmica. Za drugo, morate znati tko je zabio gol za rezultat „Liverpool 0, Arsenal 1”.
Napravit ćete Matchday Notebook, nogometnog chatbota koji traži sljedeće tri utakmice Premier lige, čita zadnjih pet Arsenalovih prvenstvenih rezultata i pronalazi njihovo mjesto na ljestvici. Primjer je postavljen na 18. studenog 2026. Gostovanje kod Newcastlea bilo je zakazano za subotu, 21. studenog u 17:30 UTC, odnosno 12:30 po njujorškom vremenu.
Stranica utakmice kod pružatelja usluge i privatni Agent slažu se oko vremena početka. Razgovor u Quickchat AI odvijao se korištenjem datirane snimke javnih podataka, što možete reproducirati u nastavku.
Provjerite utakmicu protiv Newcastlea ili preuzmite komplet za Matchday Notebook. Otpakirajte ga i pokrenite python3 replay.py kako biste vidjeli tri utakmice, pet rezultata i redak na ljestvici bez potrebe za računom. Isti komplet uključuje postavke akcije i Main Prompt za povezivanje vlastitog izvora podataka.
1. Koji će klub i natjecanje chatbot pratiti?
Prvo odredite klub i ligu. Arsenalova prvenstvena forma može se razlikovati ovisno o tome računate li i europske utakmice utorkom. U ovoj bilježnici Arsenal označava momčad 57, a liga označava Premier ligu 2021, poznatu i pod kodom PL.
- Otvorite obrazac za registraciju na football-data.org. Unesite svoje ime i adresu e-pošte, prihvatite uvjete i odaberite Create account. Provjerite je li vaše natjecanje na popisu pokrivenosti. Besplatni plan uključuje Premier ligu, s rasporedima i rezultatima koji kasne.
Upotrijebite adresu e-pošte koju možete provjeriti. football-data.org šalje API ključ na tu adresu nakon registracije. Besplatni plan dopušta 10 zahtjeva u minuti.
Ako već imate račun, prijavite se svojom e-poštom i API tokenom. Ako trebate drugu kopiju tokena, zatražite je e-poštom koristeći adresu s kojom ste se registrirali. Sačuvajte token za zaštićeno zaglavlje u 2. koraku.
Provjerite svoj plan pod Subscription i potražite svoju ligu pod Available competitions. Ovaj izvadak prikazuje UEFA Ligu prvaka (CL) i Bundesligu (BL1).
- Da biste pratili drugi klub, pronađite ga na popisu momčadi u natjecanju, na primjer
GET /v4/competitions/PL/teams. Koristite dobiveni ID momčadi i ID natjecanja u zahtjevima za utakmice u nastavku. Vodič za brzi početak v4 objašnjava oba pretraživanja. - Stvorite Quickchat AI Agenta, nazovite ga Matchday Notebook i držite ga privatnim dok testirate. Trebat će vam dostupni krediti za razgovore i simulacije. Otvorite Identity → AI Persona → Main Prompt i zalijepite upute u nastavku. Snimke zaslona i postavke koje se mogu kopirati koriste engleski jezik.
Koristite isti klub na oba mjesta. U proizvodu se upute za Agenta nalaze pod Identity.
Kopirajte 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. Kako dohvatiti sljedeću Arsenalovu utakmicu?
Započnite s akcijom koja odgovara na pitanje o početku utakmice iz grupnog chata. Jedan zahtjev vraća oba kluba, zakazano vrijeme i status utakmice. Ovdje ostavite filtar statusa otvorenim kako bi se i eventualna odgoda mogla prikazati. Zapis sa statusom TIMED ima vrijeme početka. Za SCHEDULED, recite korisniku da termin još treba biti potvrđen.
- Otvorite Actions & MCPs → Add Action → API Action → Create manually. Postavite API Action Name na
get_club_fixtures, a When to run na AI decides. Pod What to ask the user first, dodajte obavezne Text unosedate_fromidate_to, oba s opcijom No default. Njihovi opisi su „Početni UTC datum za uključivanje, YYYY-MM-DD” i „Krajnji UTC datum za isključivanje, YYYY-MM-DD”. - Za API Endpoint, odaberite GET i unesite URL ispod. Otvorite Query Params i postavite
competitionsna vrijednost2021. DodajtedateFromidateTo. Za svaku vrijednost, koristite Add AI Data → Parameters kako biste umetnuli odgovarajući unos datuma. Ostavite Body prazno. - Zalijepite opis u nastavku pod API Action Description i spremite akciju. Pod Headers, vjerodajnica će ići u redak
X-Auth-Tokensamo za pisanje. Postavite to prije prvog zahtjeva. Dodajte drugo, obično zaglavlje sAcceptkao ključem iapplication/jsonkao vrijednošću. Koristite ista dva zaglavlja za sve tri akcije.
https://api.football-data.org/v4/teams/57/matches
Slijedite rutu za utakmice momčadi iz reference davatelja usluge u akciju. Arsenal je fiksiran u URL-u, liga u Query Params, a dva datuma dolaze iz razgovora.
Kopirajte opis akcije za utakmice
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.
Primjeri zahtjeva davatelja usluge stavljaju API ključ u X-Auth-Token. Upotrijebite isti naziv zaglavlja u Headers na get_club_fixtures.
Obrazac za prijavu traži vašu e-poštu i API token. U aplikaciji Quickchat AI samo se token unosi u zaštićeni redak X-Auth-Token.
Unesite token na siguran način. Nadzorna ploča može zamijeniti spremljenu tajnu vrijednost. Kako bi zaglavlje bilo samo za upis, upotrijebite povezivanje s računom jednom po Akciji. Povežite svoj račun pomoću Quickchat AI vodiča za postavljanje u ChatGPT ili Claude. Zatražite od povezanog asistenta da pripremi zaglavlje s bezopasnom oznakom pomoću uputa u nastavku. Zatim sami otvorite karticu Headers Akcije, zamijenite vrijednost u istom retku svojim sirovim football-data.org tokenom i odaberite Save changes. Ponovno otvorite uređivač i provjerite prikazuje li [redacted]. Držite token na nadzornoj ploči i izvan razgovora.
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.
Ovo je spremljeno zaglavlje. Davatelj usluge očekuje sam token, bez prefiksa Bearer.
Isprobajte prvo dohvaćanje. U Test Response → Test the API navedite datum početka i dan nakon željenog datuma završetka. Zatim omogućite Akciju i u AI Preview zatražite sljedeće tri prvenstvene utakmice u tom razdoblju. Za podatke uživo odaberite nadolazeće datume. Primjer iz arhive koristio je 2026-11-18 i 2026-12-03, pa je večer 2. prosinca bila uključena. Provjerite najbližu utakmicu otvaranjem njezine izvorne poveznice. Referentni vodič za v4 filtar datuma objašnjava isključivi datum završetka.
U primjeru, gostovanje kod Newcastlea bilo je 21. studenog, utakmica s Manchester Cityjem kod kuće 29. studenog, a gostovanje kod Brentforda 2. prosinca. Da je zahtjev završio s 2. prosinca, utakmica s Brentfordom bila bi izostavljena.
3. Kako očitati zadnjih pet rezultata za Arsenal?
Najbolji primjer je utakmica koja je završila rezultatom Liverpool 0, Arsenal 1. Ako chatbot svaki put prvu brojku tretira kao Arsenalov rezultat, pobjedu u gostima pretvorit će u poraz. Zadržite svaki rezultat u poretku domaćin-gost i upotrijebite ID momčadi da biste utvrdili kako je Arsenal prošao.
- Stvorite drugu API Action pod nazivom
get_recent_results. Upotrijebite istu GET krajnju točku, unose za datum, oznake za datum i filtar za natjecanje. Dodajte redak upitastatuss doslovnom vrijednošćuFINISHED. - Postavite opis ispod. Ponovite postavljanje zaglavlja samo za pisanje za
get_recent_results, provjerite masku i omogućite Akciju. - Zatražite pet najnovijih prvenstvenih utakmica u zadanom razdoblju. Za primjer, upotrijebite razdoblje od 1. listopada do 17. studenog 2026. Sortirajte po
utcDateprije nego što uzmete pet rezultata. Ako razdoblje vrati samo tri, prikažite te tri i ponudite pretraživanje starijih utakmica.
Kopirajte opis Akcije za rezultate
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.
Prvo pronađite Arsenal kao gostujuću momčad, a zatim očitajte gol u gostima. Liverpoolova nula znači da nisu primili gol.
Čitajte niz od najnovijeg. Arsenal je pobijedio Hull 1:0, slavio 1:0 u gostima kod Liverpoola, pobijedio Everton 2:0, slavio 1:0 u gostima kod Nottingham Foresta i pobijedio Leeds 2:1. To je ukupno pet pobjeda, sedam postignutih i jedan primljeni gol. Zapisnik utakmice s Liverpoolom dobar je test jer je pobjednička momčad navedena kao druga.
U spremljenim testnim podacima vraćeni popis namjerno počinje utakmicom protiv Leedsa, a završava onom protiv Hulla. Sortiranjem po vremenu početka utakmice, utakmica protiv Hulla premješta se na vrh odgovora. Otvorite odgovor akcije pokraj razgovora i usporedite prvu i zadnju utakmicu na oba popisa.
Pet pobjeda može sakriti važan detalj. Dvije od njih bile su u gostima, pa je pobjednički broj na desnoj strani.
4. Odakle dolaze pozicija na ljestvici i bodovi?
Pet pobjeda govori vam o formi u zadnjih nekoliko tjedana. Pozicija na prvenstvenoj ljestvici ovisi i o svim prethodnim utakmicama te o rezultatima svih ostalih momčadi. Dajte Agentu zasebnu Akciju za ljestvicu.
- Nazovite je
get_league_standings. Odaberite GET, zalijepite donju krajnju točku i ostavite ulaze, parametre upita i tijelo praznima. Koristite AI decides, dodajte donji opis i ponovite postavljanje zaglavlja samo za pisanje za ovu akciju. - U Test Response potražite u
standingsunos čiji jetypejednakTOTAL. Unutar njegovogtablepronađiteteam.idjednak57. Omogućite Akciju i pitajte „Gdje je Arsenal na ljestvici Premier lige?” - Usporedite
position,playedGamesipointss izvorom za istu sezonu i datum. Dana 18. studenog ljestvica Premier lige u Native Stats pokazivala je 1. mjesto, 10 odigranih utakmica, 27 bodova. Trenutna ljestvica mijenjat će se kako drugi klubovi budu igrali.
https://api.football-data.org/v4/competitions/PL/standings
Kopirajte opis Akcije za ljestvicu
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.
Očitajte podatke iz jednog retka u TOTAL. 27 bodova odnosi se na svih deset prvenstvenih utakmica u trenutku snimanja.
5. Možete li pratiti izvještaj za dan utakmice do njegovih izvora?
Započnite novi razgovor u AI Preview. Zatražite sljedeće tri utakmice, nastavite s pitanjem „Kako smo prošli u zadnjih pet prvenstvenih utakmica?”, navedite razdoblje za rezultate, a zatim pitajte „Gdje nas to stavlja na ljestvici?” U Inbox otvorite oznaku pozvane Akcije za svaki odgovor. View logs Akcije omogućuje vam usporedbu parametara i odgovora s onim što je navijač vidio. Vodič za izradu API Action pokazuje gdje pronaći te kontrole.
Da biste dobili kombinirani sažetak prikazan na početku članka, postavite pitanje u nastavku koristeći datume iz spremljenog primjera. Za ažurirani sažetak, koristite nadolazeće datume za raspored utakmica i nedavne datume za rezultate.
Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.
Provjerite datume i ID utakmice u pozivu. U lokalnom primjeru, 560651 je utakmica s Newcastleom.
Za ponovljivu provjeru otvorite Conversations → Testing, stvorite skup podataka i spremite tri pitanja. Dodajte dva granična pitanja prikazana u nastavku. Pokrenite skup podataka nakon promjene opisa Akcije i pregledajte pozive uz odgovore. Upotrijebite kontrolirani odgovor da biste isprobali rijedak status ili pogrešku. Samo hipotetsko pitanje testira formulaciju odgovora.
Upotrijebite ista pitanja nakon svake izmjene. Rezultat u gostima otkriva pogrešku u bodovanju koju bi test samo s domaćim utakmicama propustio.
| Testni slučaj | Što bi navijač trebao čuti |
|---|---|
Utakmica je odgođena i oba gola su null. Je li bio neriješen rezultat? | Utakmica je odgođena. Nema zabilježenog rezultata. |
Uspješno pretraživanje vraća prazan popis matches. Je li cijela sezona prazna? | U tom razdoblju nisu pronađene utakmice. Navedite datume koje ste pretraživali. |
| Davatelj usluge vraća 401 ili 403. | Dohvaćanje nije uspjelo. Provjerite spremljeni token i pokrivenost natjecanja. |
| Davatelj vraća 429. | Dosegnuto je ograničenje broja zahtjeva. Pričekajte i pokušajte ponovno. |
Prazan vremenski okvir i dalje znači da je zahtjev bio uspješan. Asistent može ponuditi proširenje raspona datuma.
Ako sumnjate u promjenu početka utakmice, usporedite termin s objavljenim izmjenama rasporeda na stranicama lige. Zabilježite zakazani datum, vremensku zonu i datum provjere. Besplatni izvor podataka može kasniti za promjenama u rasporedu TV prijenosa, što je važno ako netko planira subotu prema dobivenom odgovoru.
Football data provided by the Football-Data.org API. Zastarjeli primjer koristi javne stranice Native Stats davatelja usluge. Za trenutnu pokrivenost i ažurnost podataka pogledajte planove i ograničenja broja zahtjeva.
Često postavljana pitanja
Koji nogometni API mogu koristiti za chatbot s rasporedom utakmica?
API football-data.org v4 pruža rasporede, rezultate i ljestvice za pokrivena natjecanja. Koristite krajnju točku za utakmice momčadi za raspored i nedavnu formu, a krajnju točku za ljestvice natjecanja za poziciju u ligi.
Jesu li football-data.org rezultati uživo na besplatnom planu?
Besplatni plan uključuje rezultate i rasporede s odgodom, prvenstvene ljestvice za pokrivena natjecanja i ograničenje od 10 API poziva po minuti. Uključite izvor i datum uz svaki odgovor i provjerite svoj plan ako trebate rezultate uživo.
Kako promijeniti Arsenal u drugu momčad?
Pronađite ID kluba i natjecanje u football-data.org. Zamijenite ID momčadi 57 u obje akcije za utakmice, promijenite numerički filtar natjecanja i URL ljestvice, zatim ažurirajte naziv kluba i ID momčadi u uputama. Testirajte na utakmici koju prepoznajete.
Kako dohvatiti zadnjih pet utakmica iz perspektive momčadi?
Filtrirajte završene prvenstvene utakmice u zadanom vremenskom okviru, poredajte ih po vremenu početka od najnovije do najstarije i uzmite najviše pet. Za svaki rezultat provjerite je li vaša momčad igrala kod kuće ili u gostima prije nego što zabilježite pobjedu, neriješen ishod ili poraz. Ako ih ima manje od pet, prikažite koliko ste ih pronašli.
Što znači prazan rezultat za odgođenu utakmicu?
Prazan rezultat znači da pružatelj usluge nije dostavio ukupan broj golova za tu stranu. Neka status utakmice bude vidljiv, a rezultat ostavite nepoznatim. Za neriješen ishod bez golova potrebna je završena utakmica s dvije zabilježene nule.
Kako pretvoriti početak nogometne utakmice u moju vremensku zonu?
Započnite s početkom utakmice u UTC, koristite nazvanu vremensku zonu kao što je America/New_York i zadržite datum u odgovoru. Ljetno računanje vremena i promjena kalendarskog dana mogu utjecati na prikazano vrijeme.