אתם מתכננים את השבת סביב משחק החוץ של ארסנל בניוקאסל. חבר בניו יורק צריך את שעת הפתיחה. ואז מישהו בקבוצת הצ’אט שואל איך היה לארסנל במשחק החוץ האחרון שלה. התשובה הראשונה נמצאת בלוח המשחקים. בשביל השנייה, אתם צריכים לדעת למי שייך השער בתוצאה “ליברפול 0, ארסנל 1”.
תבנו את Matchday Notebook, צ’אטבוט כדורגל שמציג את שלושת המשחקים הבאים בפרמייר ליג, את חמש התוצאות האחרונות של ארסנל בליגה ואת מיקומה בטבלה. הדוגמה מבוססת על תאריך ה-18 בנובמבר 2026. משחק החוץ נגד ניוקאסל היה אמור להתקיים בשבת, 21 בנובמבר בשעה 17:30 UTC, או 12:30 בצהריים בניו יורק.
דף המשחק של הספק וה-Agent הפרטי מסכימים על שעת הפתיחה. שיחת ה-Quickchat AI התנהלה מול הדמיית נתונים מתוארכת, שתוכלו לשחזר למטה.
בדקו את המשחק נגד ניוקאסל או הורידו את ערכת Matchday Notebook. חלצו את הקבצים והריצו את python3 replay.py כדי לראות את שלושת המשחקים, חמש התוצאות ושורת הטבלה ללא צורך בחשבון. אותה ערכה כוללת את הגדרות ה-Action ואת ה-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 כולל את שתי הבדיקות. - צרו Agent ב-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. איך מקבלים את המשחק הבא של ארסנל?
התחילו עם ה-Action שעונה על השאלה לגבי שעת הפתיחה. בקשה אחת מחזירה את שני המועדונים, את השעה המתוכננת ואת סטטוס המשחק. השאירו את פילטר הסטטוס פתוח כדי שגם משחק שנדחה יוכל להופיע. לרשומה מסוג 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 והזינו את כתובת ה-URL למטה. פתחו את 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, ושני התאריכים מגיעים מהשיחה.
העתיקו את התיאור של ה-Action למשחקים
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. השתמשו באותו שם כותרת ב-Headers ב-get_club_fixtures.
טופס הכניסה מבקש את האימייל וטוקן ה-API שלכם. ב-Quickchat AI, רק הטוקן נכנס לשורת X-Auth-Token המאובטחת.
הזן את האסימון באופן פרטי. לוח המחוונים יכול להחליף סוד שמור. כדי להפוך את הכותרת הזו לכתיבה בלבד מלכתחילה, השתמש בחיבור החשבון פעם אחת לכל פעולה. חבר את חשבונך באמצעות מדריך ההגדרה של Quickchat AI ב-ChatGPT או ב-Claude. בקש מהעוזר המחובר להכין את הכותרת עם סמן לא מזיק באמצעות ההוראה למטה. לאחר מכן פתח בעצמך את לשונית 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. אם הצ’אטבוט יתייחס למספר הראשון כתוצאה של ארסנל בכל פעם, הוא יהפוך ניצחון חוץ להפסד. יש לשמור על סדר התוצאות בית-חוץ ולהשתמש במזהה הקבוצה כדי לקבוע את התוצאה של ארסנל.
- צרו API Action שני בשם
get_recent_results. השתמשו באותה נקודת קצה (endpoint) מסוג GET, באותם שדות קלט לתאריכים, צ’יפים של תאריכים ומסנן תחרות. הוסיפו את שורת השאילתהstatusעם הערך המדויקFINISHED. - הגדירו את התיאור למטה. חזרו על תהליך הגדרת הכותרת (header) לכתיבה בלבד עבור
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.
תחילה, זהו את ארסנל כקבוצת החוץ, ורק אז קראו את מספר השערים שהבקיעה. התוצאה 0 של ליברפול פירושה שהיא לא ספגה שערים (clean sheet).
קראו את רצף התוצאות מהמשחק האחרון אחורה. ארסנל ניצחה את האל 1–0, ניצחה את ליברפול בחוץ 1–0, ניצחה את אברטון 2–0, ניצחה את נוטינגהאם פורסט בחוץ 1–0 וניצחה את לידס 2–1. בסך הכול נרשמו חמישה ניצחונות, שבעה שערי זכות ושער חובה אחד. דף המשחק נגד ליברפול הוא מבחן טוב כי הקבוצה המנצחת מופיעה שנייה בתוצאה.
בדוגמת הנתונים השמורה, הרשימה המוחזרת מתחילה בכוונה במשחק נגד לידס ומסתיימת במשחק נגד האל. מיון לפי שעת הפתיחה מעביר את המשחק נגד האל לראש התשובה. פתחו את תגובת הפעולה (Action response) לצד הצ’אט והשוו את המשחקים הראשון והאחרון בשתי הרשימות.
חמישה ניצחונות יכולים להסתיר פרט חשוב. שניים מהם היו בחוץ, כך שהמספר המנצח נמצא מימין.
4. מאיפה מגיעים המיקום בטבלה והנקודות?
חמישה ניצחונות מראים את הכושר של הקבוצה בשבועות האחרונים. אבל המיקום בליגה תלוי גם בכל המשחקים הקודמים ובתוצאות של שאר הקבוצות. תנו לסוכן פעולה נפרדת עבור טבלת הליגה.
- תנו לה את השם
get_league_standings. בחרו GET, הדביקו את נקודת הקצה (endpoint) למטה, והשאירו את שדות הקלט, פרמטרי השאילתה וה-body ריקים. השתמשו ב-AI decides, הוסיפו את התיאור למטה וחזרו על הגדרת הכותרת (header) לכתיבה בלבד עבור פעולה זו. - ב-Test Response, חפשו בתוך
standingsאת הרשומה שבהtypeהואTOTAL. בתוךtableשלה, מצאו את הרשומה שבהteam.idשווה ל-57. הפעילו את הפעולה ושאלו “מה המיקום של ארסנל בטבלת הפרמייר ליג?” - השוו את
position,playedGamesו-pointsעם המקור לאותה עונה ותאריך. ב-18 בנובמבר, טבלת הפרמייר ליג ב-Native Stats הציגה עבור ארסנל מקום 1, 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, צרו סט בדיקות (dataset) ושמרו את שלוש השאלות. הוסיפו את שתי שאלות הקצה המוצגות למטה. הריצו את סט הבדיקות לאחר שינוי תיאור של פעולה ובדקו את הקריאות לצד התשובות. השתמשו בתגובה מבוקרת כדי לבחון סטטוס נדיר או שגיאה. שאלה היפותטית לבדה בודקת רק את ניסוח התשובה.
השתמשו באותן שאלות לאחר כל עריכה. תוצאת משחק חוץ תעזור לגלות שגיאת ניקוד שבדיקה של משחקי בית בלבד הייתה מפספסת.
| מקרה בדיקה | מה האוהד אמור לשמוע |
|---|---|
משחק נדחה ושני ערכי השערים הם null. האם התוצאה היא תיקו? | המשחק נדחה. לא נרשמה תוצאה. |
חיפוש מוצלח מחזיר רשימת matches ריקה. האם כל העונה ריקה? | לא נמצאו משחקים בחלון התאריכים שצוין. יש לציין את התאריכים שבהם חיפשתם. |
| הספק מחזיר 401 או 403. | החיפוש נכשל. בדקו את האסימון השמור ואת כיסוי התחרות. |
| הספק מחזיר 429. | הגעתם למגבלת הבקשות. עצרו ונסו שוב מאוחר יותר. |
גם חלון ריק מעיד על בקשה שהצליחה. הסוכן יכול להציע להרחיב את טווח התאריכים.
כדי לקבל חוות דעת שנייה על שעת פתיחה שהשתנתה, השוו אותה לתיקוני לוח המשחקים שפורסמו בליגה. שמרו יחד את התאריך המקורי, אזור הזמן והתאריך שבו ביצעתם את הבדיקה. הפיד החינמי עלול להתעדכן לאט יותר משינויים בשידור, וזה חשוב כשמישהו מתכנן את השבת שלו בהתבסס על התשובה.
Football data provided by the Football-Data.org API. הדוגמה המובאת משתמשת בדפי ה-Native Stats הציבוריים של הספק. למידע על הכיסוי ועל עדכניות הנתונים, עיינו במסלולי המידע ומגבלות השימוש.
שאלות נפוצות
באיזה API של כדורגל אפשר להשתמש כדי לבנות צ’אטבוט ללוח המשחקים?
ה-API של football-data.org בגרסה 4 מספק לוחות משחקים, תוצאות וטבלאות ליגה עבור התחרויות הנתמכות. השתמשו ב-endpoint של משחקי הקבוצה כדי לקבל את לוח המשחקים והתוצאות האחרונות, וב-endpoint של טבלאות הליגה כדי לקבל את המיקום בליגה.
האם תוצאות football-data.org חיות בתוכנית החינמית?
המסלול החינמי כולל תוצאות ולוחות משחקים בעיכוב, טבלאות ליגה לתחרויות נתמכות ומגבלה של 10 קריאות API בדקה. יש לציין את המקור והתאריך בכל תשובה, ולבדוק את תנאי המסלול שלכם אם אתם צריכים תוצאות חיות.
איך אני משנה את ארסנל לקבוצה אחרת?
מצאו את מזהה הקבוצה והתחרות של המועדון ב-football-data.org. החליפו את קבוצה 57 בשתי ה-Actions של המשחקים, שנו את פילטר התחרות המספרי ואת כתובת ה-URL של טבלת הליגה, ואז עדכנו את שם המועדון ומזהה הקבוצה בהוראות. בדקו את התוצאה מול משחק שאתם מזהים.
איך מקבלים את חמשת המשחקים האחרונים מנקודת המבט של הקבוצה?
סננו משחקי ליגה שהסתיימו בחלון תאריכים מוגדר, מיינו לפי שעת פתיחה מהחדש לישן וקחו עד חמישה. עבור כל תוצאה, בדקו אם הקבוצה שלכם שיחקה בבית או בחוץ לפני שאתם קובעים אם זה ניצחון, תיקו או הפסד. אם יש פחות מחמישה משחקים שעונים על הקריטריונים, הציגו כמה מצאתם.
מה משמעות תוצאה ריקה עבור משחק שנדחה?
תוצאה ריקה פירושה שהספק לא סיפק נתוני שערים עבור אותו צד. השאירו את סטטוס המשחק גלוי ואת התוצאה לא ידועה. תיקו מאופס דורש משחק שהסתיים עם שני אפסים שנרשמו בתוצאה.
איך אני ממיר שעת פתיחה של משחק כדורגל לאזור הזמן שלי?
התחל עם שעת הפתיחה UTC של המשחק, השתמש באזור זמן בעל שם כגון America/New_York ושמור את התאריך בתשובה. שעון קיץ ושינוי יום בלוח השנה יכולים שניהם להשפיע על השעה המוצגת.