Îți organizezi sâmbăta în funcție de deplasarea lui Arsenal la Newcastle. Un prieten din New York are nevoie de ora de start. Apoi cineva din grupul de chat întreabă ce a făcut Arsenal în ultima deplasare. Primul răspuns se găsește în programul meciurilor. Pentru al doilea, trebuie să știi cui aparține golul din „Liverpool 0, Arsenal 1”.
Vei construi Matchday Notebook, un chatbot de fotbal care caută următoarele trei meciuri din Premier League, afișează ultimele cinci rezultate de campionat ale lui Arsenal și găsește locul echipei în clasament. Exemplul este fixat la data de 18 noiembrie 2026. Meciul în deplasare cu Newcastle era programat pentru sâmbătă, 21 noiembrie, la 17:30 UTC, sau 12:30 la New York.
Pagina de meci a furnizorului și Agentul privat sunt de acord asupra orei de start. Conversația Quickchat AI a rulat folosind o simulare datată a înregistrărilor publice, pe care o poți reproduce mai jos.
Verifică meciul cu Newcastle sau descarcă kitul Matchday Notebook. Dezarhivează-l și rulează python3 replay.py pentru a vedea cele trei meciuri, cinci rezultate și rândul din clasament fără a avea un cont. Același kit include setările pentru Acțiuni și Main Prompt pentru a te conecta la propriul flux de date.
1. Ce club și competiție va urmări chatbot-ul?
Stabilește mai întâi clubul și campionatul. Forma lui Arsenal în campionat se poate schimba dacă iei în calcul și un meci european de marți seara. În acest jurnal, Arsenal înseamnă echipa 57 și campionat înseamnă Premier League 2021, cunoscut și după codul PL.
- Deschide formularul de înregistrare football-data.org. Introdu prenumele și adresa de e-mail, acceptă termenii și selectează Create account. Verifică-ți liga pe lista de acoperire. Abonamentul gratuit include Premier League, cu programul meciurilor și scoruri afișate cu întârziere.
Folosește o adresă de e-mail pe care o poți verifica. football-data.org trimite cheia API acolo după înregistrare. Abonamentul gratuit permite 10 solicitări pe minut.
Dacă ai deja un cont, autentifică-te cu adresa de e-mail și tokenul API. Dacă ai nevoie de o altă copie a tokenului, solicit-o prin e-mail folosind adresa cu care te-ai înregistrat. Păstrează tokenul pentru antetul protejat din Pasul 2.
Verifică-ți planul la Subscription și caută-ți liga la Available competitions. Acest extras arată UEFA Champions League (CL) și Bundesliga (BL1).
- Pentru a urmări un alt club, caută-l în lista de echipe a competiției, de exemplu
GET /v4/competitions/PL/teams. Folosește ID-ul echipei și ID-ul competiției returnate în solicitările de meci de mai jos. Ghidul rapid v4 conține ambele metode de căutare. - Creează un Agent Quickchat AI, numește-l Matchday Notebook, și păstrează-l privat în timp ce testezi. Ai nevoie de credite disponibile pentru conversații și simulări. Deschide Identity → AI Persona → Main Prompt și lipește instrucțiunile de mai jos. Capturile de ecran și setările copiabile folosesc limba engleză.
Păstrează același club în ambele locuri. În produs, instrucțiunile Agentului se află sub Identity.
Copiază 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. Cum obții următorul meci al lui Arsenal?
Începe cu Acțiunea care răspunde la întrebarea despre ora de start din grupul de chat. O singură solicitare returnează ambele cluburi, ora programată și starea meciului. Lasă filtrul de stare necompletat aici, pentru ca o eventuală amânare să poată fi afișată. O înregistrare TIMED are o oră de start. Pentru SCHEDULED, specifică cititorului că ora urmează a fi confirmată.
- Deschide Actions & MCPs → Add Action → API Action → Create manually. Setează API Action Name la
get_club_fixturesși When to run la AI decides. Sub What to ask the user first, adaugă câmpurile Text obligatoriidate_fromșidate_to, ambele cu No default. Descrierile lor sunt „Prima dată UTC de inclus, YYYY-MM-DD” și „Prima dată UTC de exclus, YYYY-MM-DD”. - Pentru API Endpoint, alege GET și introdu URL-ul de mai jos. Deschide Query Params și setează
competitionsla valoarea literală2021. AdaugădateFromșidateTo. Pentru fiecare valoare, folosește Add AI Data → Parameters pentru a insera intrarea de dată corespunzătoare. Lasă Body gol. - Lipiți descrierea de mai jos sub API Action Description și salvați Acțiunea. Sub Headers, acreditarea va fi într-un rând
X-Auth-Tokencu acces doar în scriere. Configurați acest lucru înainte de prima solicitare. Adăugați un al doilea antet obișnuit cuAcceptca cheie șiapplication/jsonca valoare. Utilizați aceleași două antete pentru toate cele trei Acțiuni.
https://api.football-data.org/v4/teams/57/matches
Urmează ruta meciurilor echipei din referința furnizorului în acțiune. Arsenal este fixat în URL, liga în Query Params, iar cele două date provin din conversație.
Copiază descrierea Acțiunii pentru programul meciurilor
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.
Exemplele de solicitări ale furnizorului plasează cheia API în X-Auth-Token. Folosește același nume de antet în Headers pe get_club_fixtures.
Formularul de autentificare necesită adresa de e-mail și tokenul API. În Quickchat AI, doar tokenul se introduce în rândul protejat X-Auth-Token.
Introdu token-ul în mod privat. Tabloul de bord poate înlocui un secret salvat. Pentru a face acel antet doar pentru scriere în primul rând, folosește conexiunea contului o dată pe Acțiune. Conectează-ți contul folosind ghidul de configurare Quickchat AI în ChatGPT sau Claude. Roagă asistentul conectat să pregătească antetul cu un marker inofensiv folosind instrucțiunea de mai jos. Apoi deschide singur fila Headers a Acțiunii, înlocuiește valoarea din același rând cu token-ul tău brut football-data.org și selectează Save changes. Redeschide editorul și verifică dacă afișează [redacted]. Păstrează token-ul în tabloul de bord și în afara conversației.
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.
Acesta este antetul salvat. Furnizorul se așteaptă la token-ul singur, fără un prefix Bearer.
Încearcă prima citire. În Test Response → Test the API, furnizează o dată de început și ziua după ultima dată dorită. Apoi activează Acțiunea și cere în AI Preview următoarele trei meciuri de campionat din acel interval. Pentru o construcție live, alege date viitoare. Exemplul de arhivă a folosit 2026-11-18 și 2026-12-03, deci seara de 2 decembrie a fost inclusă. Verifică cel mai apropiat meci deschizând linkul sursă. Referința filtrului de dată v4 explică data de sfârșit exclusivă.
În simulare, meciul în deplasare cu Newcastle a fost pe 21 noiembrie, cel cu Manchester City acasă pe 29 noiembrie, iar cel cu Brentford în deplasare pe 2 decembrie. Dacă solicitarea s-ar fi încheiat pe 2 decembrie, meciul cu Brentford ar fi fost omis.
3. Cum afli ultimele cinci rezultate ale lui Arsenal?
Cel mai revelator joc din acest exemplu s-a încheiat Liverpool 0, Arsenal 1. Dacă chatbot-ul tratează primul număr ca scorul lui Arsenal de fiecare dată, transformă o victorie în deplasare într-o înfrângere. Păstrează fiecare scor în ordine acasă-deplasare și folosește ID-ul echipei pentru a decide cum a jucat Arsenal.
- Creează o a doua API Action numită
get_recent_results. Folosește același endpoint GET, intrări de dată, etichete de dată și filtru de competiție. Adaugă rândul de interogarestatuscu valoarea literalăFINISHED. - Setează descrierea de mai jos. Repetă configurarea antetului doar pentru scriere pentru
get_recent_results, verifică masca și activează Acțiunea. - Cere cele cinci cele mai recente meciuri de campionat într-un interval specificat. Pentru exemplu, folosește 1 octombrie până pe 17 noiembrie 2026. Sortează după
utcDateînainte de a lua cinci. Dacă intervalul returnează doar trei, arată acele trei și oferă-te să cauți mai în spate.
Copiază descrierea Acțiunii de 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.
Mai întâi găsește Arsenal în dreptul echipei oaspete, apoi citește golul marcat în deplasare. Faptul că Liverpool are zero goluri înseamnă că Arsenal nu a primit gol.
Citește seria de rezultate începând cu cel mai recent. Arsenal a învins-o pe Hull cu 1–0, a câștigat cu 1–0 la Liverpool, a învins-o pe Everton cu 2–0, a câștigat cu 1–0 la Nottingham Forest și a învins-o pe Leeds cu 2–1. Asta înseamnă cinci victorii, șapte goluri marcate și unul primit. Rezumatul meciului cu Liverpool este un test bun, deoarece echipa câștigătoare apare a doua.
În datele de test salvate, lista returnată începe în mod deliberat cu meciul cu Leeds și se termină cu cel cu Hull. Sortarea după ora de start mută meciul cu Hull la începutul răspunsului. Deschideți răspunsul acțiunii lângă fereastra de chat și comparați primul și ultimul meci din ambele liste.
Cinci victorii pot ascunde un detaliu important. Două dintre acestea au fost în deplasare, deci cifra victoriei este în dreapta.
4. De unde provin poziția în clasament și punctele?
Cinci victorii îți spun cum au decurs ultimele săptămâni. Poziția în clasament depinde și de toate meciurile anterioare și de rezultatele tuturor celorlalți. Oferă Agentului o acțiune separată pentru clasament.
- Numește-o
get_league_standings. Alege GET, lipește endpoint-ul de mai jos și lasă goale intrările, parametrii de interogare și corpul. Folosește AI decides, adaugă descrierea de mai jos și repetă configurarea antetului doar pentru scriere pentru această Acțiune. - În Test Response, caută în
standingsînregistrarea al căreitypeesteTOTAL. În cadrultableal acesteia, găseșteteam.idegal cu57. Activează acțiunea și întreabă „Pe ce loc este Arsenal în clasamentul Premier League?” - Compară
position,playedGamesșipointscu sursa pentru același sezon și aceeași dată. Pe 18 noiembrie, clasamentul Premier League în Native Stats arăta locul 1, 10 meciuri jucate, 27 de puncte. Clasamentul tău actual se va modifica pe măsură ce joacă și alte cluburi.
https://api.football-data.org/v4/competitions/PL/standings
Copiază descrierea Acțiunii de clasament
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.
Citește pe un singur rând în TOTAL. Cele 27 de puncte acoperă toate cele zece meciuri de campionat din instantaneu.
5. Poți urmări rezumatul zilei de meci până la sursele sale?
Începe o conversație nouă în AI Preview. Întreabă care sunt următoarele trei meciuri, continuă cu „Ce rezultate am avut în ultimele cinci meciuri de campionat?”, specifică intervalul de date, apoi întreabă „Pe ce loc ne situează asta în clasament?”. În Inbox, deschide marcatorul acțiunii apelate pentru fiecare răspuns. Opțiunea View logs a acțiunii îți permite să compari parametrii și răspunsul cu ceea ce a văzut suporterul. Ghidul pentru crearea unei API Action arată unde poți găsi aceste comenzi.
Pentru a obține rezumatul combinat al etapei prezentat la începutul articolului, adresați întrebarea de mai jos folosind datele din exemplul salvat. Pentru un rezumat la zi, folosiți date viitoare pentru programul meciurilor și date recente pentru rezultate.
Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.
Verifică datele și ID-ul meciului în apel. În simularea locală, 560651 este meciul cu Newcastle.
Pentru o verificare repetabilă, deschide Conversations → Testing, creează un set de date și salvează cele trei întrebări. Adaugă cele două întrebări limită prezentate mai jos. Rulează setul de date după ce ai modificat o descriere a Acțiunii și inspectează apelurile alături de răspunsuri. Folosește un răspuns controlat pentru a exersa un status rar sau o eroare. O întrebare ipotetică testează doar formularea unui răspuns.
Folosește aceleași întrebări după fiecare modificare. Rezultatul din deplasare surprinde o eroare de scor pe care un test doar cu meciuri acasă ar omite-o.
| Caz de testare | Ce ar trebui să audă suporterul |
|---|---|
Un meci este amânat și ambele goluri sunt null. A fost egal? | Meciul a fost amânat. Nu există un scor înregistrat. |
O căutare reușită returnează o listă matches goală. Este întregul sezon gol? | Nu au fost returnate meciuri în acel interval. Precizează datele căutate. |
| Furnizorul returnează 401 sau 403. | Căutarea a eșuat. Verifică token-ul salvat și acoperirea competiției. |
| Furnizorul returnează 429. | A fost atinsă limita de solicitări. Opriți și reîncercați mai târziu. |
O fereastră goală are totuși o cerere reușită. Asistentul poate oferi să lărgească datele.
Pentru o a doua opinie privind o modificare a orei de start, comparați-o cu modificările de program publicate de ligă. Păstrați împreună data programată, fusul orar și data la care ați făcut verificarea. Fluxul gratuit poate avea întârzieri față de o modificare de televiziune, ceea ce este important atunci când cineva își planifică sâmbăta în funcție de răspuns.
Football data provided by the Football-Data.org API. Exemplul datat folosește paginile publice Native Stats ale furnizorului. Consultați planurile de date și numărul maxim de solicitări pentru acoperirea și actualitatea curente.
Întrebări frecvente
Ce API de fotbal pot folosi pentru un chatbot cu programul meciurilor?
API-ul v4 de la football-data.org furnizează programul meciurilor, rezultate și clasamente pentru competițiile acoperite. Folosește endpoint-ul de meciuri al echipei pentru program și forma recentă și endpoint-ul de clasament al competiției pentru poziția în ligă.
Sunt scorurile de la football-data.org live în abonamentul gratuit?
Abonamentul gratuit include scoruri și programe cu întârziere, clasamente pentru competițiile acoperite și un număr maxim de 10 solicitări pe minut. Include sursa și data la fiecare răspuns și verifică-ți abonamentul dacă ai nevoie de scoruri live.
Cum schimb Arsenal cu o altă echipă?
Găsește ID-ul echipei și competiția clubului în football-data.org. Înlocuiește echipa 57 în ambele Acțiuni de meci, schimbă filtrul numeric al competiției și URL-ul clasamentului, apoi actualizează numele clubului și ID-ul echipei în instrucțiuni. Testează folosind un meci pe care îl recunoști.
Cum obțin ultimele cinci meciuri din perspectiva echipei?
Filtrează meciurile de campionat încheiate într-un interval de date specificat, sortează-le după ora de start de la cel mai recent la cel mai vechi și preia maximum cinci. Pentru fiecare scor, verifică dacă echipa ta a jucat acasă sau în deplasare înainte de a atribui o victorie, un egal sau o înfrângere. Dacă se califică mai puțin de cinci meciuri, afișează câte ai găsit.
Ce înseamnă un scor necompletat pentru un meci amânat?
Un scor necompletat înseamnă că furnizorul nu a oferit un număr total de goluri pentru echipa respectivă. Păstrează starea meciului vizibilă și lasă scorul necunoscut. Un egal fără goluri necesită un meci încheiat cu două zerouri înregistrate.
Cum convertesc ora de start a unui meci de fotbal în fusul meu orar?
Începe cu ora de start UTC a meciului, folosește un fus orar specific, cum ar fi America/New_York, și păstrează data în răspuns. Trecerea la ora de vară și schimbarea zilei calendaristice pot afecta ora afișată.