The Met’te Ayçiçeği Avı için Müze Sohbet Robotu Oluşturma

Piotr Grudzień
Yayımlandı 7 dk okuma
Van Gogh’un Sunflowers eserinin Google Arts & Culture görüntüleyicisindeki Collection Detective’ın Quickchat AI’de yer alan İspanyolca etiketi

Mavi boya yatağında iki kesilmiş ayçiçeği yatıyor. Onları İspanyolca isteyin ve Vincent van Gogh’un Sunflowers eseri için, yılı, malzemesi ve orijinaline bağlantısıyla birlikte bir duvar etiketi alabilirsiniz. İpucuna kedileri ekleyin ve iz bir Fransız ipek yelpazeye çıkar.

The Met Koleksiyon API’sini arayan ve bulduğu sanat eserinden kısa bir etiket yazan çok dilli bir müze sohbet robotu olan Collection Detective’i oluşturacaksınız. Aşağıdaki tabloyla başlayın. Sonunda Quickchat AI’da dilediğiniz ipucunu takip edebilecek ve cevabı müzenin kendi kataloğuyla karşılaştırarak kontrol edebileceksiniz.

Quickchat AI'da ayçiçekleri hakkında İspanyolca bir cevap ve The Met'in Google Arts & Culture galerisindeki Van Gogh'un Sunflowers eseri Quickchat AI, Sunflowers başlığını korudu ve malzemeyi “óleo sobre lienzo” olarak çevirdi. Cevabı, Google Arts & Culture’teki müze etiketiyle karşılaştırın. The Met, Rogers Fund, 1949. Müze kaydını açın.

1. Müze sohbet robotunuza ilk ipucunu verin

Ziyaretçi bir tema ve bir dil belirtir. Dedektif iki arama yapar. Birincisi aday nesne kimliklerini bulur. İkincisi bir kimliği açar ve sanatçıyı, başlığı, tarihi, malzemeyi ve kaynak bağlantısını getirir. Dedektif etiketi ancak bundan sonra yazar.

  1. Quickchat AI hesabına giriş yapın veya bir hesap oluşturun. Boş bir Temsilci kullanın veya Add new AI Agent → Set up manually’yi seçin. Adını Collection Detective olarak belirleyin. Birkaç test konuşması için yeterli krediye ihtiyacınız olacak. Müze aramaları bir Met hesabı veya API anahtarı olmadan çalışır.
  2. Identity → AI Persona → Main Prompt yolunu açın. Aşağıdaki talimatları yapıştırın, ardından paneli kapatın. Identity, düzenlemelerinizi otomatik olarak kaydeder. Bu talimatlar, dedektife bir kaydı nasıl seçeceğini ve dil değiştirirken hangi ayrıntıları koruyacağını bildirir.
Collection Detective için Main Prompt'ı kopyalayın.
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’da İngilizce ve İspanyolca dillerini ekleyin. İkinci dil kontrolü için Japonca’yı da ekledik. Belirsiz mesajlarda ilk dil yedek olarak kullanılır. Dil ipuçları nasıl çalışır?

Quickchat AI Kimlik ayarlarında Collection Detective’ın adı ve Main Prompt Temsilcinin adı ve talimatları Kimlik bölümünde yer alır. Katalog aramaları bir sonraki adımda Actions & MCPs bölümüne gider.

  1. Her iki Eylem de etkinleştirildikten sonra AI Preview için bu ilk ziyaretçi mesajını saklayın. Ziyaretçi ayçiçeklerini bulmayı ve ilk eseri İspanyolca açıklamayı istiyor.

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

Aramanın dili önemlidir. 19 Kasım 2026’da müze, aynı filtrelerle girasoles için sıfır eşleşme, sunflowers içinse 153 eşleşme döndürdü. Ziyaretçinin İspanyolca sormasına izin verin, kısa İngilizce katalog terimini aratın ve hangi kelimeyi kullandığınızı belirtin.

2. The Met Koleksiyon API’sinde nasıl arama yaparsınız?

İlk Eyleme tek bir girdi verin: tema. Aramayı, bir ziyaretçinin izini sürebileceği kadar küçük tutun. Üç aday, ilk eseri açmanıza ve araştırmaya devam etmek için elinizde bir seçenek daha kalmasına olanak tanır.

  1. Actions & MCPs’da Add Action → API Action → Create manually’i seçin. API Action Name’yi search_met_collection ve When to run’ü AI decides olarak ayarlayın. API Eylemleri rehberi aynı düzenleyiciyi daha basit bir istekle gösterir.
  2. What to ask the user first altında, theme adında gerekli bir Text parametresi ekleyin. Açıklaması için “A short English catalogue search phrase, such as sunflowers or cats and sunflowers.” girin.
  3. API Endpoint’da GET’i seçin ve https://collectionapi.metmuseum.org/public/collection/v1.1/search’yi girin. Query Params’te bu dört satırı oluşturun. İlk değer için Add AI Data → Parameters’ü kullanın, böylece ziyaretçinin teması isteğe eklenir.
Sorgu anahtarıGirilecek değer
qtheme parametre çipini ekleyin.
hasImagestrue
limit3
offset0

The Met’in Search (v1.1) referansı ve Quickchat AI Eylem düzenleyicisindeki dört sorgu parametresi Quickchat AI’daki dört satırı The Met’in arama parametreleriyle eşleştirin. Yalnızca q ziyaretçinin temasını alır. Diğer üç değer sabit kalır. The Met’in Search (v1.1) referansını okuyun.

  1. Headers altında, Accept değerini application/json ile girin. Body boş bırakın. Aşağıdakileri API Action Description içine yapıştırın, Save changes seçeneğini belirleyin ve Eylem anahtarının açık olduğundan emin olun.
Arama Eylemi açıklamasını kopyalayın
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.

Tarayıcınızda ayçiçeği aramasını açın. İşte arama sonucumuzun tamamı. Sayı, her eşleşmeyi kapsar. Liste, yalnızca istediğimiz üç kimliği içerir ve katalog değiştikçe sıraları değişebilir.

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

3. Bir obje kimliğini İspanyolca bir müze etiketine dönüştürün

Bu yanıttaki ilk kimlik olan 436524 ile başlayın. İkinci Eylem doğrudan onu arar. Met, arama için v1.1 ve tek tek objeler için v1 kullanır. Eğer eski bir arama örneği HTTP 410 döndürürse, arama rotasını değiştirin ve obje rotasını v1’de bırakın. Met Koleksiyon API referansı

  1. Başka bir API Action oluşturun. API Action Name’i get_met_object ve When to run’ü AI decides olarak ayarlayın. What to ask the user first altında, object_id adında gerekli bir Number ekleyin. Bunu “The integer Met object ID from a search result or the visitor.” olarak tanımlayın.
  2. API Endpoint’da GET’i seçin. https://collectionapi.metmuseum.org/public/collection/v1/objects/’yi girin, son eğik çizgiyi yerinde bırakın ve object_id çipini eklemek için Add AI Data → Parameters’ü kullanın. İlk kimliğimizle adres /objects/436524 ile biter.
  3. Query Params ve Body boş bırakın. Headers içinde Accept ile application/json kullanın. Aşağıdaki açıklamayı API Action Description içine yapıştırın, Save changes seçeneğini belirleyin ve Eylem anahtarının açık olduğundan emin olun.
Obje Eylemi açıklamasını kopyalayın
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.

Met URL'sinin sonuna obje kimliği eklenmiş Quickchat AI'daki obje araması Arama Eyleminde ziyaretçinin kelimesi bir sorgu satırına gider. Burada sayı, adresin kendisinin bir parçası olur.

AI Preview’ı açın ve ilk ipucunu gönderin. Orijinal başlık olan Sunflowers, Vincent van Gogh, 1887 ve óleo sobre lienzo ifadelerini arayın. Cevaptaki müze bağlantısını takip edin. Sayfada ayrıca Nesne Numarası olarak 49.41 listelenir. Bu, müzenin envanter numarasıdır. API’de 436524’ü kullanın. Künye satırındaki 1949 yılı Rogers Fonu edinimine aittir. Resmin kendisi 1887 tarihlidir. Nesne verilerini okuyun

Sunflowers için Google Arts & Culture görüntüleyici ve sol alttaki “Vincent 87” imzasının yakın çekimi Büyüteçle tabloyu açın ve sol alt köşede “Vincent 87” yazısını bulun. Eser sayfasında, Details bölümüne gidin ve imzayı Date Created başlığı altındaki yılla karşılaştırın. The Met’in Sunflowers eserini Google Arts & Culture’te keşfedin.

Bağlı bir yapay zeka asistanından aynı iki Eylemi kurun

Quickchat AI’ı ChatGPT veya Claude aracılığıyla yönetiyorsanız, yukarıdaki iki tarifi bu kurulum isteğiyle de kullanabilirsiniz. Oluşturulan alanları inceleyin, ardından ilk ipucunu kendiniz çalıştırın. Hesap bağlantı talimatları

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. Çevrilmiş bir sanat eseri etiketini nasıl kontrol edersiniz?

Inbox’da sohbeti açın ve cevabın altındaki 2 actions called’i genişletin. İstek detayları için Actions & MCPs → Custom Actions’ye gidin ve her Eylem için View logs’ü seçin. Arama yanıtında ve bir sonraki isteğin sonunda 436524’ü bulun. Bu numaraları eşleştirmek, başka bir eserin aynı başlığa sahip olsa bile İspanyolca etiketi tek bir objeye geri izlemenizi sağlar.

Ayçiçeği arama sonucu ve obje 436524 için sonraki arama Arama sonucundan ilk kimliği obje aramasına kadar takip edin. Bu aktarım, cevabı tabloya bağlayan şeydir.

Bu ipuçlarını yeni sohbetlerde deneyin. Ana istemi düzenledikten sonra bunları tekrarlamak için Testing → Create Dataset’i açın, veri kümesini adlandırın ve soruları girin. Run Tests → Start Run’i seçin, ardından tamamlanmış bir sonucun üzerindeki View’ye tıklayarak sohbetini Inbox’ta açın.

Atfı kontrol edin. 437406 objesi için İspanyolca bir etiket isteyin. Kaydında Rembrandt isim olarak ve Follower of ön ek olarak verilmiştir. İlk yanıtımız atfı İspanyolca açıkladı ancak sanatçı satırını İngilizce bıraktı. Bir talimatı, nitelendiriciyi ve ortamı çevirmek üzere değiştirdik. Sonraki yanıt un seguidor de Rembrandt verdi ve tarihteki belirsizliği korudu, probablemente hacia 1658–62. Müzayedecinin katalog girişini okuyun.

Müzayedeci, Rembrandt'ın bir takipçisine atfedilen katalog kaydı ve buna karşılık gelen İspanyolca ifade İki kelime atıfı taşır. “Follower of” her iki dilde de sanatçının adıyla birlikte yer alır. The Met, Bequest of Benjamin Altman, 1913.

Görseli kontrol edin. İkinci ayçiçeği eşleşmesi olan 480725 numaralı nesneyi görmek isteyin. Emil Nolde’nin Large Sunflowers adlı eseri 1928 tarihlidir ve panel üzerine yapılmıştır. Kaydında isPublicDomain: false ve boş görsel URL’leri bulunmaktadır. Ziyaretçiye katalog bağlantısını ve malzemeyi verin. Bu örnek, tek başına hasImages=true filtresinin hangi görselin gösterileceğine neden karar veremediğini açıklar. Nolde kaydını okuyun.

Quickchat AI'nin Emil Nolde için sadece metin içeren yanıtı, The Met'in kaydındaki kamu malı işareti ve boş görsel alanlarının yanında API yeniden kullanılabilir bir fotoğraf sağlamasa bile müze katalog detaylarını paylaşabilir. The Met’in Open Access görsel politikası.

Boş bir aramayı kontrol edin. Tam olarak zzzxxyycollectiontest terimini isteyin. API {"total":0,"objectIDs":null} yanıtını döndürdü. Dedektif daha genel bir ipucu isteyebilir. Başarısız bir arama farklı bir yanıt gerektirir. Bir HTTP 503 hatası simüle ettiğimizde, dedektif ziyaretçiden daha sonra tekrar denemesini istedi ve herhangi bir nesne isteğinde bulunmadı.

5. Ayçiçeklerini ipek bir yelpazeye taşıyın

Çiçekleri koruyun ve bir hayvan ekleyin. Collection Detective’e ikinci bir ipucu verin ve her sanatçının hangi yüzey üzerine çalıştığını sorun. Bu mesajı olduğu gibi kullanabilirsiniz.

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

İkinci aramayı deneyin. İlk iki kimliğimiz 705155 ve 436524 idi. The Met, ilk eseri bir çizim olarak katalogluyor. Wikimedia Commons’te, müzenin fotoğrafının altındaki Open in Media Viewer seçeneğini belirleyin. Beyaz kedileri yelpaze çubukları boyunca takip edin ve ayçiçeklerinin arasındaki parıltıyı arayın. Yelpazeyi Wikimedia Commons’te inceleyin.

Guérard’ın beyaz kedili ve ayçiçekli yelpazesi Wikimedia Commons’te, Van Gogh’un tablosunun bir detayının yanında Henri Charles Guérard, Fan Design with Cats and Sunflowers, ca. 1885–90. The Met, Gift of Robert Tuggle and Paul Jeromack, 2015. Yelpazeyi The Met’te keşfedin.

Van Gogh tuval üzerine çalıştı. Guérard desenli ipek üzerine çalıştı. Ayçiçekleri arasındaki parıltının maddi bir açıklaması var. Müze, mürekkep ve guajın yanı sıra altın varak da listeliyor. Tarih yaklaşık olarak kalır, ca. 1885–90. Kendi iki duraklı avınızı yapmak için, ilk eserden bir detay seçin, onu bir sonraki ipucuna ekleyin ve dedektiften her iki obje sayfasında da doğrulayabileceğiniz bir farkı isteyin.

Müze sohbet robotu SSS

The Met koleksiyonunda arama yapmak için bir API anahtarına ihtiyacım var mı?

The Metropolitan Sanat Müzesi, kayıt veya API anahtarı gerektirmeyen herkese açık arama ve obje uç noktaları sunar. Her iki isteği de bir tarayıcıda açabilirsiniz. Quickchat AI, sohbet robotu konuşması için hesap kredilerini kullanır.

Hangi Met API uç noktası bir sanat eseri ve görselini döndürür?

Aday obje kimliklerini almak için /public/collection/v1.1/search kullanın. Başlık, sanatçı, tarih, malzeme, müze bağlantısı ve mevcut Open Access görsel URL’leri için bir kimliği /public/collection/v1/objects/{id}’e iletin.

Müze sohbet robotu İspanyolca veya başka bir dilde yanıt verebilir mi?

Evet. Ziyaretçinin dilinde sorun, kısa bir İngilizce katalog terimiyle arama yapın ve açıklamayı çevirin. Ziyaretçinin müze kaydını kontrol edebilmesi için orijinal başlığı, adları ve atıf niteleyicilerini koruyun.

Bir Met araması tarafından döndürülen her görseli yeniden kullanabilir miyim?

Bireysel obje kaydını kontrol edin. The Met, Open Access görsellerini CC0 altında kullanıma sunar. Bu sohbet robotu, yalnızca isPublicDomain doğru olduğunda ve birincil görsel URL’si mevcut olduğunda bir görsel sunar. Aksi takdirde müze sayfasına bağlantı verir.

Sohbet robotu bir eserin bugün sergilenip sergilenmediğini söyleyebilir mi?

Bir ziyaret için, güncel müze obje sayfasını açın ve sergileme bilgilerini kontrol edin. Bir koleksiyon araması, depodaki eserler de dahil olmak üzere kataloglanmış eserleri bulur.

Sohbet robotu bir sanatçının ne amaçladığını açıklayabilir mi?

Obje kaydı size malzeme ve tarih gibi katalog gerçeklerini verir. Bir sanatçının niyetlerini veya eserdeki bir sembolü açıklamak için, o belirli sanat eseri hakkında bir küratörün denemesi gibi ek bir kaynak kullanın.

Quickchat AI Quickchat AI Ask Quickchat AI a question