בניית צ'אטבוט מוזיאוני למרדף חמניות במטרופוליטן

Piotr Grudzień
פורסם זמן קריאה: 7 דקות
התווית הספרדית של Collection Detective ב-Quickchat AI לצד "Sunflowers" של ואן גוך במציג של Google Arts & Culture

שתי חמניות קטופות מונחות על רקע כחול. בקשו אותן בספרדית ותקבלו תווית קיר עבור Sunflowers של וינסנט ואן גוך, הכוללת את השנה, החומר וקישור למקור. הוסיפו חתולים לרמז, והעקבות יובילו אתכם למניפת משי צרפתית.

תבנו את Collection Detective, צ’אטבוט מוזיאוני רב-לשוני שיחפש ב-API של אוסף המטרופוליטן ויכתוב תווית קצרה מיצירת האמנות שימצא. התחילו עם הציור למטה. בסיום תוכלו לעקוב אחר כל רמז ב-Quickchat AI ולבדוק את התשובה מול הקטלוג של המוזיאון עצמו.

תשובה בספרדית על חמניות ב-Quickchat AI והציור Sunflowers של ואן גוך בגלריה של המט ב-Google Arts & Culture Quickchat AI שמרה על הכותרת Sunflowers ותרגמה את המדיום ל-״óleo sobre lienzo״. השוו את התשובה לתווית המוזיאון ב-Google Arts & Culture. המט, Rogers Fund, 1949. פתחו את רשומת המוזיאון.

1. תנו לצ’אטבוט המוזיאוני שלכם את הרמז הראשון

המבקר מספק נושא ושפה. הבלש מבצע שני חיפושים. הראשון מוצא מזהי אובייקטים אפשריים. השני פותח מזהה אחד ומחזיר את האמן, הכותרת, התאריך, המדיום וקישור המקור. רק אז הבלש כותב את התווית.

  1. היכנסו או צרו חשבון Quickchat AI. השתמשו בסוכן ריק או בחרו Add new AI Agent → Set up manually. קראו לו Collection Detective. תזדקקו למספיק קרדיטים לכמה שיחות בדיקה. בדיקות המוזיאון פועלות ללא חשבון מטרופוליטן או מפתח API.
  2. פתחו את Identity → AI Persona → Main Prompt. הדביקו את ההוראות שלהלן וסגרו את החלונית. Identity שומר את העריכות שלכם באופן אוטומטי. ההוראות מנחות את הבלש כיצד לבחור רשומה ואילו פרטים לשמור בעת החלפת שפות.
העתיקו את Main Prompt עבור Collection Detective
Guide visitors through The Met’s online collection. Reply in the visitor’s requested language. For a theme, search the catalogue with a short English equivalent and tell the visitor which term you used. For an explicit object ID, go straight to the object lookup. Fetch the first returned record unless the visitor selects another. Use the record before stating any facts.
Keep original titles and artist names. Translate attribution qualifiers and approximate dates into the visitor’s language, preserving their uncertainty. Give dates and materials in that language. Link the returned objectURL with a short label. If isPublicDomain is true and primaryImageSmall or primaryImage is present, offer a short link to the image. Otherwise give the museum record only. Keep each answer to a short museum label.
For a comparison, check both records and compare their recorded materials. Empty fields are unknown. If a search is empty, ask for a broader term. If a request fails, say which lookup failed. For meaning, intent or today’s gallery location, explain what the record can establish and refer the visitor to the museum.
  1. ב-Identity → Languages, הוסיפו אנגלית וספרדית. הוספנו גם יפנית לבדיקת שפה שנייה. השפה הראשונה היא ברירת המחדל להודעות דו-משמעיות. איך רמזי שפה פועלים

השם של Collection Detective וה-Main Prompt בהגדרות Identity ב-Quickchat AI שם הסוכן וההוראות נמצאים ב-Identity. חיפושי הקטלוג יוגדרו ב-Actions & MCPs בשלב הבא.

  1. שמרו את הודעת המבקר הראשונה הזו עבור AI Preview לאחר הפעלת שתי הפעולות. המבקר מבקש למצוא חמניות ולהסביר את היצירה הראשונה בספרדית.

Busca girasoles en la colección del Met y explícame la primera obra en español.

שפת החיפוש חשובה. ב-19 בנובמבר 2026, המוזיאון החזיר אפס התאמות עבור girasoles ו-153 עבור sunflowers עם אותם מסננים. אפשרו למבקר לשאול בספרדית, חפשו את מונח הקטלוג הקצר באנגלית וציינו באיזו מילה השתמשתם.

2. כיצד מחפשים ב-The Met Collection API?

הגדירו לפעולה הראשונה קלט אחד: הנושא. שמרו על היקף חיפוש מצומצם מספיק כדי שהמבקר יוכל לעקוב אחר המסלול. שלושה אובייקטים אפשריים יאפשרו לכם לפתוח את היצירה הראשונה ועדיין להשאיר עוד אחת לבדיקה.

  1. ב-Actions & MCPs, בחרו Add Action → API Action → Create manually. הגדירו את API Action Name ל-search_met_collection ואת When to run ל-AI decides. מדריך הפעולות של ה-API מציג את אותו עורך עם בקשה פשוטה יותר.
  2. תחת What to ask the user first, הוסיפו פרמטר Text נדרש בשם theme. בתיאור שלו, הזינו ”A short English catalogue search phrase, such as sunflowers or cats and sunflowers.”
  3. ב-API Endpoint, בחרו GET והזינו https://collectionapi.metmuseum.org/public/collection/v1.1/search. ב-Query Params, צרו את ארבע השורות הללו. השתמשו ב-Add AI Data → Parameters עבור הערך הראשון כדי שנושא המבקר יוחדר לבקשה.
מפתח שאילתהערך להזנה
qהכניסו את שבב הפרמטר theme.
hasImagestrue
limit3
offset0

ההפניה ל-Search (v1.1) של המט וארבעת פרמטרי השאילתה בעורך הפעולות של Quickchat AI התאימו את ארבע השורות ב-Quickchat AI לפרמטרי החיפוש של המטרופוליטן. רק q מקבל את נושא המבקר. שלושת הערכים האחרים נשארים קבועים. קראו את ההפניה ל-Search (v1.1) של המטרופוליטן.

  1. תחת Headers, הזינו Accept עם הערך application/json. השאירו את Body ריק. הדביקו את הטקסט הבא לתוך API Action Description, בחרו Save changes וודאו שהמתג של הפעולה פועל.
העתיקו את תיאור פעולת החיפוש
Search The Met’s online collection for a visitor’s theme, using a short English catalogue term. Return up to three candidate object IDs. Call get_met_object for a selected ID before describing any work. For an empty result, ask for a broader theme.

פתחו את חיפוש החמניות בדפדפן שלכם. זוהי התגובה המלאה מהחיפוש שלנו. הספירה כוללת כל התאמה. הרשימה מכילה רק את שלושת המזהים שביקשנו, וסדרם עשוי להשתנות עם עדכון הקטלוג.

{"total":153,"objectIDs":[436524,480725,484935]}

3. הפיכת מזהה אובייקט לתווית מוזיאונית בספרדית

התחילו עם 436524, המזהה הראשון בתגובה. הפעולה השנייה מחפשת אותו ישירות. המטרופוליטן משתמש ב-v1.1 לחיפוש וב-v1 לאובייקטים בודדים. אם דוגמת חיפוש ישנה יותר מחזירה HTTP 410, שנו את נתיב החיפוש והשאירו את נתיב האובייקט ב-v1. תיעוד ה-API של אוסף המטרופוליטן

  1. צרו API Action נוספת. הגדירו את API Action Name ל-get_met_object ואת When to run ל-AI decides. תחת What to ask the user first, הוסיפו פרמטר Number נדרש בשם object_id. תארו אותו כך: ”The integer Met object ID from a search result or the visitor.”
  2. ב-API Endpoint, בחרו GET. הזינו https://collectionapi.metmuseum.org/public/collection/v1/objects/, השאירו את הקו הנטוי האחרון במקומו והשתמשו ב-Add AI Data → Parameters כדי להוסיף את שבב object_id. עם המזהה הראשון שלנו, הכתובת מסתיימת ב-/objects/436524.
  3. השאירו את Query Params ו-Body ריקים. ב-Headers השתמשו ב-Accept עם application/json. הדביקו את התיאור מטה לתוך API Action Description, בחרו Save changes וודאו שהמתג של הפעולה פועל.
העתיקו את תיאור פעולת האובייקט
Retrieve one Met object by a returned or visitor-supplied object ID. Use its title, names and qualifiers, date, medium and objectURL for the label. Offer an image only if the public-domain flag is true and an image URL is present.

חיפוש האובייקט ב-Quickchat AI עם מזהה האובייקט שהוחדר בסוף כתובת ה-URL של המט בפעולת החיפוש, מילת המבקר נכנסת לשורת שאילתה. כאן המספר הופך לחלק מהכתובת עצמה.

פתחו את AI Preview ושלחו את הרמז הראשון. חפשו את הכותרת המקורית Sunflowers, וינסנט ואן גוך, 1887, ו-óleo sobre lienzo. עקבו אחר הקישור למוזיאון בתשובה. הדף מציין גם את 49.41 כמספר האובייקט. זהו מספר הרכישה של המוזיאון. השתמשו ב-436524 ב-API. השנה 1949 בשורת הקרדיט מתייחסת לרכישה של קרן רוג’רס. הציור עצמו מתוארך לשנת 1887. קראו את נתוני האובייקט

המציג של Google Arts & Culture עבור "Sunflowers" ותקריב של החתימה "Vincent 87" בפינה השמאלית התחתונה פתחו את הציור עם זכוכית המגדלת ומצאו את “Vincent 87” בפינה השמאלית התחתונה. בדף היצירה, גללו אל Details והשוו את החתימה עם השנה המופיעה תחת Date Created. חקרו את “Sunflowers” של המטרופוליטן ב-Google Arts & Culture.

הגדירו את שתי הפעולות זהות מאסיסטנט AI מחובר

אם אתם מנהלים את Quickchat AI דרך ChatGPT או Claude, תוכלו להשתמש גם בשני המתכונים שלעיל עם בקשת הגדרה זו. סקרו את השדות שנוצרו, ולאחר מכן הפעילו את הרמז הראשון בעצמכם. הוראות חיבור חשבון

Draft the two API Action configurations for my Collection Detective agent here first. Use the supplied names, URLs, required parameters and descriptions. Bind the theme to the search query and the numeric object ID to the object path. Neither request needs authentication or a body. After I approve both configurations, create the Actions.

4. כיצד בודקים תווית יצירת אמנות מתורגמת?

ב-Inbox, פתחו את השיחה והרחיבו את 2 actions called מתחת לתשובה. לפרטי הבקשה, עברו ל-Actions & MCPs → Custom Actions ובחרו View logs עבור כל פעולה. מצאו את 436524 בתגובת החיפוש ובסוף הבקשה הבאה. התאמת מספרים אלה מאפשרת לכם לאתר את התווית הספרדית בחזרה לאובייקט אחד גם אם ליצירה אחרת יש את אותה כותרת.

תוצאת חיפוש החמניות והחיפוש שלאחר מכן עבור אובייקט 436524 עקבו אחר המזהה הראשון מתוצאת החיפוש אל חיפוש האובייקט. העברה זו היא שקושרת את התשובה לציור.

נסו את הרמזים האלה בשיחות חדשות. כדי לחזור עליהם לאחר עריכת ההנחיה, פתחו את Testing → Create Dataset, תנו שם למערך הנתונים והזינו את השאלות. בחרו Run Tests → Start Run, ואז View על תוצאה שהושלמה כדי לפתוח את השיחה שלה ב־Inbox.

בדקו את הייחוס. בקשו תווית בספרדית עבור אובייקט 437406. הרשומה שלו מציינת את Rembrandt כשם ואת Follower of כמילת ייחוס. התשובה הראשונה שלנו הסבירה את הייחוס בספרדית אך השאירה את שורת האמן באנגלית. שינינו הוראה אחת כדי לתרגם את מילת הייחוס וגם את המדיום. התשובה הבאה נתנה un seguidor de Rembrandt ושמרה על אי-הוודאות בתאריך, probablemente hacia 1658–62. קראו את רשומת הקטלוג של ”הכרוז”.

”הכרוז” עם הייחוס הקטלוגי שלו לחוג של רמברנדט והניסוח המקביל בספרדית שתי מילים נושאות את הייחוס. ”Follower of” שייך לשם האמן בשתי השפות. The Met, Bequest of Benjamin Altman, 1913.

בדקו את התמונה. בקשו לראות את אובייקט 480725, ההתאמה השנייה לחמניות. Large Sunflowers של אמיל נולדה מתוארך ל-1928 וצויר על לוח. הרשומה שלו מכילה isPublicDomain: false וכתובות URL ריקות לתמונות. תנו למבקר את קישור הקטלוג ואת החומר. דוגמה זו מסבירה מדוע hasImages=true לבדו אינו יכול לקבוע איזו תמונה להציג. קראו את רשומת נולדה.

תשובת הטקסט בלבד של Quickchat AI עבור אמיל נולדה, לצד סימון נחלת הכלל ושדות התמונה הריקים ברשומת המטרופוליטן המוזיאון יכול לשתף את פרטי הקטלוג גם כאשר ה-API אינו מספק תצלום הניתן לשימוש חוזר. מדיניות התמונות בגישה פתוחה (Open Access) של המטרופוליטן.

בדקו חיפוש ריק. בקשו את המונח המדויק zzzxxyycollectiontest. ה-API החזיר {"total":0,"objectIDs":null}. הבלש יכול לבקש רמז רחב יותר. חיפוש כושל דורש תשובה שונה. כאשר דימינו HTTP 503, הבלש ביקש מהמבקר לנסות שוב מאוחר יותר ולא הגיש בקשת אובייקט.

5. בעקבות החמניות אל מניפת משי

שמרו את הפרחים והוסיפו חיה. תנו ל-Collection Detective רמז שני ושאלו על איזה משטח עבד כל אמן. אתם יכולים להשתמש בהודעה זו כפי שהיא כתובה.

Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).

נסו את החיפוש השני. שני המזהים הראשונים שלנו היו 705155 ו-436524. המטרופוליטן מקטלג את היצירה הראשונה כרישום. ב-Wikimedia Commons, בחרו Open in Media Viewer מתחת לתצלום המוזיאון. עקבו אחר החתולים הלבנים לאורך הצלעות וחפשו את הניצוץ בין החמניות. בדקו את המניפה ב-Wikimedia Commons.

המניפה של גראר עם חתולים לבנים וחמניות ב-Wikimedia Commons לצד פרט מציורו של ואן גוך אנרי שארל גרארד, Fan Design with Cats and Sunflowers, ca. 1885–90. המטרופוליטן, Gift of Robert Tuggle and Paul Jeromack, 2015. חקרו את המניפה במטרופוליטן.

ואן גוך צייר על בד. גראר עבד על משי מעוטר. לנצנוץ שבין החמניות יש הסבר חומרי. המוזיאון מציין עלי זהב לצד הדיו והגואש. התאריך נשאר משוער, ca. 1885–90. כדי ליצור מרדף דו-שלבי משלכם, בחרו פרט מהיצירה הראשונה, הוסיפו אותו לרמז הבא ובקשו מהבלש לציין הבדל אחד שתוכלו לאמת בשני דפי האובייקטים.

שאלות נפוצות על צ’אטבוט המוזיאון

האם אני זקוק/ה למפתח API כדי לחפש באוסף המטרופוליטן?

מוזיאון המטרופוליטן לאמנות מספק נקודות קצה ציבוריות לחיפוש ולאובייקטים ללא הרשמה או מפתח API. ניתן לפתוח את שתי הבקשות בדפדפן. Quickchat AI משתמש בזיכויי חשבון לשיחת הצ’אטבוט.

איזו נקודת קצה של ה-API של המטרופוליטן מחזירה יצירת אמנות ותמונה שלה?

השתמשו ב-/public/collection/v1.1/search כדי לקבל מזהי אובייקטים אפשריים. העבירו מזהה אחד ל-/public/collection/v1/objects/{id} כדי לקבל את הכותרת, האמן, התאריך, המדיום, הקישור למוזיאון וכל כתובת URL זמינה של תמונות בגישה פתוחה (Open Access).

האם הצ’אטבוט המוזיאוני יכול לענות בספרדית או בשפה אחרת?

כן. שאלו בשפת המבקר, חפשו עם מונח קטלוגי קצר באנגלית ותרגמו את ההסבר. השאירו את הכותרת המקורית, השמות ומילות הייחוס כדי שהמבקר יוכל לבדוק את הרשומה במוזיאון.

האם אוכל לעשות שימוש חוזר בכל תמונה שמוחזרת על ידי חיפוש במטרופוליטן?

בדקו את רשומת האובייקט. המטרופוליטן מעמיד את תמונות הגישה הפתוחה (Open Access) שלו לרשות הציבור תחת רישיון CC0. צ’אטבוט זה מציע תמונה רק כאשר isPublicDomain הוא true וקיימת כתובת URL של תמונה ראשית. אחרת הוא מקשר לדף המוזיאון.

האם הצ’אטבוט יכול לומר לי אם יצירה מוצגת היום?

לצורך ביקור, פתחו את דף האובייקט הנוכחי של המוזיאון ובדקו את פרטי התצוגה שלו. חיפוש באוסף מוצא יצירות מקוטלגות, כולל יצירות באחסון.

האם הצ’אטבוט יכול להסביר את כוונת האמן?

רשומת האובייקט מספקת עובדות קטלוגיות כגון המדיום והתאריך. כדי להסביר את כוונות האמן או סמל ביצירה, השתמשו במקור נוסף, כגון מאמר של אוצר על יצירת האמנות הספציפית.

Quickchat AI Quickchat AI Ask Quickchat AI a question