Xây dựng chatbot bảo tàng: Săn tìm hoa hướng dương tại The Met

Piotr Grudzień
Ngày đăng Thời gian đọc: 10 phút
Nhãn tiếng Tây Ban Nha của Collection Detective trong Quickchat AI bên cạnh bức Sunflowers của Van Gogh trong trình xem Google Arts & Culture

Hai bông hoa hướng dương đã cắt nằm trên một nền sơn màu xanh. Yêu cầu chúng bằng tiếng Tây Ban Nha và bạn có thể nhận được một nhãn tường cho bức Sunflowers của Vincent van Gogh, hoàn chỉnh với năm, chất liệu và liên kết đến bản gốc. Thêm mèo vào manh mối và dấu vết dẫn đến một chiếc quạt lụa Pháp.

Bạn sẽ xây dựng Collection Detective, một chatbot bảo tàng đa ngôn ngữ tìm kiếm API Bộ sưu tập của The Met và viết một nhãn ngắn từ tác phẩm nghệ thuật mà nó tìm thấy. Bắt đầu với bức tranh dưới đây. Đến cuối cùng, bạn sẽ có thể theo dõi bất kỳ manh mối nào trong Quickchat AI và kiểm tra câu trả lời với danh mục của chính bảo tàng.

Một câu trả lời bằng tiếng Tây Ban Nha về hoa hướng dương trong Quickchat AI và bức Sunflowers của Van Gogh trong phòng trưng bày Google Arts & Culture của The Met. Quickchat AI đã giữ nguyên tiêu đề Sunflowers và dịch chất liệu thành “óleo sobre lienzo”. So sánh câu trả lời với nhãn bảo tàng trong Google Arts & Culture. The Met, Rogers Fund, 1949. Mở hồ sơ bảo tàng.

1. Đưa ra manh mối đầu tiên cho chatbot bảo tàng của bạn

Khách truy cập cung cấp một chủ đề và một ngôn ngữ. Thám tử thực hiện hai lần tra cứu. Lần đầu tiên tìm thấy các ID đối tượng ứng viên. Lần thứ hai mở một ID và trả về nghệ sĩ, tiêu đề, ngày tháng, chất liệu và liên kết nguồn. Chỉ sau đó thám tử mới viết nhãn.

  1. Đăng nhập hoặc tạo tài khoản Quickchat AI. Sử dụng một Agent trống hoặc chọn Add new AI Agent → Set up manually. Đặt tên là Collection Detective. Bạn sẽ cần đủ tín dụng cho một vài cuộc trò chuyện thử nghiệm. Các tra cứu bảo tàng hoạt động mà không cần tài khoản Met hoặc khóa API.
  2. Mở Identity → AI Persona → Main Prompt. Dán các hướng dẫn bên dưới, sau đó đóng bảng điều khiển. Identity tự động lưu các chỉnh sửa của bạn. Chúng cho thám tử biết cách chọn một bản ghi và những chi tiết nào cần giữ lại khi nó thay đổi ngôn ngữ.
Sao chép Main Prompt cho 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. Trong Identity → Languages, thêm tiếng Anh và tiếng Tây Ban Nha. Chúng tôi cũng đã thêm tiếng Nhật để kiểm tra ngôn ngữ thứ hai. Ngôn ngữ đầu tiên là ngôn ngữ dự phòng cho các tin nhắn không rõ ràng. Cách gợi ý ngôn ngữ hoạt động

Tên của Collection Detective và Main Prompt trong phần cài đặt Nhận dạng Quickchat AI Tên và hướng dẫn của Tác nhân nằm trong phần Nhận dạng. Các tra cứu danh mục sẽ được đưa vào Actions & MCPs ở bước tiếp theo.

  1. Giữ tin nhắn đầu tiên này của khách truy cập cho AI Preview sau khi cả hai Tác vụ đã được bật. Khách truy cập đang yêu cầu tìm hoa hướng dương và giải thích tác phẩm đầu tiên bằng tiếng Tây Ban Nha.

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

Ngôn ngữ tìm kiếm rất quan trọng. Vào ngày 19 tháng 11 năm 2026, bảo tàng đã trả về không kết quả cho girasoles và 153 cho sunflowers với cùng các bộ lọc. Hãy để khách truy cập hỏi bằng tiếng Tây Ban Nha, tìm kiếm thuật ngữ danh mục tiếng Anh ngắn và cho họ biết từ bạn đã sử dụng.

2. Bạn tìm kiếm API Bộ sưu tập của The Met như thế nào?

Cung cấp cho Hành động đầu tiên một đầu vào, chủ đề. Giữ cho tìm kiếm đủ nhỏ để khách truy cập có thể theo dõi. Ba ứng cử viên cho phép bạn mở tác phẩm đầu tiên và vẫn còn một tác phẩm khác để điều tra.

  1. Trong Actions & MCPs, chọn Add Action → API Action → Create manually. Đặt API Action Name thành search_met_collection và When to run thành AI decides. Hướng dẫn về Hành động API hiển thị cùng một trình chỉnh sửa với một yêu cầu đơn giản hơn.
  2. Trong What to ask the user first, thêm một tham số Text bắt buộc có tên theme. Đối với mô tả của nó, nhập “A short English catalogue search phrase, such as sunflowers or cats and sunflowers.”
  3. Trong API Endpoint, chọn GET và nhập https://collectionapi.metmuseum.org/public/collection/v1.1/search. Trong Query Params, tạo bốn hàng này. Sử dụng Add AI Data → Parameters cho giá trị đầu tiên để chủ đề của khách truy cập được chèn vào yêu cầu.
Khóa truy vấnGiá trị cần nhập
qChèn chip tham số theme.
hasImagestrue
limit3
offset0

Tham chiếu Search (v1.1) của The Met và bốn tham số truy vấn trong trình chỉnh sửa Hành động của Quickchat AI. Đối chiếu bốn hàng trong Quickchat AI với các tham số tìm kiếm của The Met. Chỉ q lấy chủ đề của khách truy cập. Ba giá trị còn lại giữ nguyên. Đọc tham chiếu Search (v1.1) của The Met.

  1. Trong Headers, nhập Accept với giá trị application/json. Để Body trống. Dán nội dung sau vào API Action Description, chọn Save changes và kiểm tra xem công tắc của Action đã bật chưa.
Sao chép mô tả Hành động tìm kiếm
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.

Mở tìm kiếm hoa hướng dương trong trình duyệt của bạn. Đây là toàn bộ phản hồi từ tìm kiếm của chúng tôi. Số lượng bao gồm mọi kết quả khớp. Danh sách chỉ chứa ba ID mà chúng tôi đã yêu cầu và thứ tự của chúng có thể thay đổi khi danh mục thay đổi.

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

3. Biến ID đối tượng thành nhãn bảo tàng tiếng Tây Ban Nha

Bắt đầu với 436524, ID đầu tiên trong phản hồi đó. Hành động thứ hai tra cứu trực tiếp. The Met sử dụng v1.1 cho tìm kiếm và v1 cho các đối tượng riêng lẻ. Nếu một ví dụ tìm kiếm cũ trả về HTTP 410, hãy thay đổi tuyến tìm kiếm và giữ tuyến đối tượng ở v1. Tham chiếu API Bộ sưu tập của The Met

  1. Tạo một API Action khác. Đặt API Action Name thành get_met_object và When to run thành AI decides. Trong What to ask the user first, thêm một Number bắt buộc có tên object_id. Mô tả nó là “The integer Met object ID from a search result or the visitor.”
  2. Trong API Endpoint, chọn GET. Nhập https://collectionapi.metmuseum.org/public/collection/v1/objects/, để lại dấu gạch chéo cuối cùng và sử dụng Add AI Data → Parameters để nối chip object_id. Với ID đầu tiên của chúng tôi, địa chỉ kết thúc bằng /objects/436524.
  3. Để Query Params và Body trống. Trong Headers, sử dụng Accept với application/json. Dán mô tả bên dưới vào API Action Description, chọn Save changes và kiểm tra xem công tắc của Action đã bật chưa.
Sao chép mô tả Hành động đối tượng
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.

Tra cứu đối tượng trong Quickchat AI với ID đối tượng được chèn vào cuối URL của Met Trong Hành động tìm kiếm, từ của khách truy cập nằm trong một hàng truy vấn. Ở đây, số trở thành một phần của chính địa chỉ.

Mở AI Preview và gửi manh mối đầu tiên. Tìm tiêu đề gốc Sunflowers, Vincent van Gogh, 1887 và óleo sobre lienzo. Theo liên kết bảo tàng trong câu trả lời. Trang này cũng liệt kê 49.41 là Số hiệu đối tượng (Object Number). Đó là số kiểm kê của bảo tàng. Sử dụng 436524 trong API. Năm 1949 trong dòng ghi công thuộc về thương vụ mua lại của Quỹ Rogers. Bản thân bức tranh có niên đại từ năm 1887. Đọc dữ liệu đối tượng

Trình xem Google Arts & Culture cho Sunflowers và cận cảnh chữ ký “Vincent 87” ở phía dưới bên trái Mở bức tranh bằng kính lúp và tìm “Vincent 87” ở góc dưới bên trái. Trên trang tác phẩm, cuộn đến mục Details và so sánh chữ ký với năm trong mục Date Created. Khám phá bức Sunflowers của The Met trên Google Arts & Culture.

Thiết lập hai Hành động tương tự từ một trợ lý AI được kết nối

Nếu bạn quản lý Quickchat AI thông qua ChatGPT hoặc Claude, bạn cũng có thể sử dụng hai công thức trên với yêu cầu thiết lập này. Xem lại các trường được tạo, sau đó tự chạy manh mối đầu tiên. Hướng dẫn kết nối tài khoản

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. Làm thế nào để kiểm tra nhãn tác phẩm nghệ thuật đã được dịch?

Trong Inbox, mở cuộc trò chuyện và mở rộng 2 actions called bên dưới câu trả lời. Để biết chi tiết yêu cầu, hãy truy cập Actions & MCPs → Custom Actions và chọn View logs cho mỗi Hành động. Tìm 436524 trong phản hồi tìm kiếm và ở cuối yêu cầu tiếp theo. Việc khớp các số đó cho phép bạn truy tìm nhãn tiếng Tây Ban Nha về một đối tượng ngay cả khi một tác phẩm khác có cùng tiêu đề.

Kết quả tìm kiếm hoa hướng dương và tra cứu tiếp theo cho đối tượng 436524 Theo dõi ID đầu tiên từ kết quả tìm kiếm vào tra cứu đối tượng. Sự chuyển giao đó là điều liên kết câu trả lời với bức tranh.

Hãy thử những gợi ý này trong các cuộc trò chuyện mới. Để lặp lại chúng sau khi chỉnh sửa lời nhắc, hãy mở Testing → Create Dataset, đặt tên cho tập dữ liệu và nhập câu hỏi. Chọn Run Tests → Start Run, sau đó View trên một kết quả đã hoàn thành để mở cuộc trò chuyện của nó trong Inbox.

Kiểm tra thông tin tác giả. Yêu cầu nhãn tiếng Tây Ban Nha cho đối tượng 437406. Hồ sơ của nó ghi Rembrandt là tên và Follower of là tiền tố. Phản hồi đầu tiên của chúng tôi đã giải thích thông tin tác giả bằng tiếng Tây Ban Nha nhưng giữ nguyên dòng nghệ sĩ bằng tiếng Anh. Chúng tôi đã thay đổi một hướng dẫn để dịch cả định tính cũng như chất liệu. Phản hồi tiếp theo đã đưa ra un seguidor de Rembrandt và giữ nguyên sự không chắc chắn về ngày tháng, probablemente hacia 1658–62. Đọc mục danh mục của The Auctioneer.

Tác phẩm "Người điều hành phiên đấu giá" với thông tin trong catalogue ghi là của một học trò của Rembrandt và phần chú thích bằng tiếng Tây Ban Nha tương ứng Hai từ mang thông tin tác giả. “Follower of” đi kèm với tên nghệ sĩ trong cả hai ngôn ngữ. The Met, Bequest of Benjamin Altman, 1913.

Kiểm tra hình ảnh. Yêu cầu xem đối tượng 480725, kết quả khớp thứ hai về hoa hướng dương. Tác phẩm Large Sunflowers của Emil Nolde được sáng tác năm 1928 và vẽ trên tấm gỗ (panel). Hồ sơ của nó có isPublicDomain: false và các URL hình ảnh trống. Cung cấp cho khách truy cập liên kết danh mục và chất liệu. Ví dụ này cho thấy tại sao chỉ hasImages=true không thể quyết định hình ảnh nào sẽ hiển thị. Đọc hồ sơ của Nolde.

Phản hồi chỉ có văn bản của Quickchat AI cho Emil Nolde bên cạnh cờ phạm vi công cộng và các trường hình ảnh trống trong hồ sơ của The Met Bảo tàng có thể chia sẻ chi tiết mục lục ngay cả khi API không cung cấp ảnh có thể tái sử dụng. Chính sách hình ảnh Open Access của The Met.

Kiểm tra một tìm kiếm trống. Yêu cầu thuật ngữ chính xác zzzxxyycollectiontest. API đã trả về {"total":0,"objectIDs":null}. Thám tử có thể yêu cầu một manh mối rộng hơn. Một tra cứu thất bại cần một câu trả lời khác. Khi chúng tôi mô phỏng HTTP 503, thám tử đã yêu cầu khách truy cập thử lại sau và không đưa ra yêu cầu đối tượng nào.

5. Theo dấu hoa hướng dương trên một chiếc quạt lụa

Giữ lại những bông hoa và thêm một con vật. Đưa cho Collection Detective một manh mối thứ hai và hỏi mỗi nghệ sĩ đã làm việc trên bề mặt nào. Bạn có thể sử dụng tin nhắn này như đã viết.

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

Thử tìm kiếm thứ hai. Hai ID đầu tiên của chúng ta là 705155 và 436524. The Met phân loại tác phẩm đầu tiên là một bản vẽ. Trên Wikimedia Commons, chọn Open in Media Viewer bên dưới bức ảnh của bảo tàng. Theo dõi những chú mèo trắng dọc theo các nan quạt và tìm ánh lấp lánh giữa những bông hoa hướng dương. Xem kỹ chiếc quạt trên Wikimedia Commons.

Chiếc quạt của Guérard với mèo trắng và hoa hướng dương trong Wikimedia Commons bên cạnh chi tiết bức tranh của Van Gogh Henri Charles Guérard, Fan Design with Cats and Sunflowers, ca. 1885–90. The Met, Gift of Robert Tuggle and Paul Jeromack, 2015. Khám phá chiếc quạt tại The Met.

Van Gogh làm việc trên canvas. Guérard làm việc trên lụa hoa văn. Ánh lấp lánh giữa những bông hoa hướng dương có một lời giải thích về chất liệu. Bảo tàng liệt kê lá vàng cùng với mực và màu gouache. Niên đại vẫn là ước tính, ca. 1885–90. Để tự tạo cuộc săn tìm hai điểm dừng của riêng bạn, hãy chọn một chi tiết từ tác phẩm đầu tiên, thêm nó vào manh mối tiếp theo và hỏi thám tử về một điểm khác biệt bạn có thể xác minh trên cả hai trang đối tượng.

Câu hỏi thường gặp về chatbot bảo tàng

Tôi có cần khóa API để tìm kiếm bộ sưu tập của The Met không?

Bảo tàng Nghệ thuật Metropolitan cung cấp các điểm cuối tìm kiếm và đối tượng công khai mà không cần đăng ký hoặc khóa API. Bạn có thể mở cả hai yêu cầu trong trình duyệt. Quickchat AI sử dụng tín dụng tài khoản cho cuộc trò chuyện chatbot.

Điểm cuối API nào của Met trả về một tác phẩm nghệ thuật và hình ảnh của nó?

Sử dụng /public/collection/v1.1/search để lấy các ID đối tượng ứng viên. Chuyển một ID đến /public/collection/v1/objects/{id} để lấy tiêu đề, nghệ sĩ, ngày tháng, chất liệu, liên kết bảo tàng và bất kỳ URL hình ảnh Open Access nào có sẵn.

Chatbot bảo tàng có thể trả lời bằng tiếng Tây Ban Nha hoặc ngôn ngữ khác không?

Có. Hỏi bằng ngôn ngữ của khách truy cập, tìm kiếm bằng một thuật ngữ danh mục tiếng Anh ngắn và dịch phần giải thích. Giữ nguyên tiêu đề, tên và các tiêu chí thuộc tính gốc để khách truy cập có thể kiểm tra hồ sơ bảo tàng.

Tôi có thể sử dụng lại mọi hình ảnh được trả về bởi một tìm kiếm của Met không?

Kiểm tra hồ sơ đối tượng riêng lẻ. The Met cung cấp các hình ảnh Open Access của mình theo CC0. Chatbot này chỉ cung cấp hình ảnh khi isPublicDomain là đúng và có URL hình ảnh chính. Nếu không, nó sẽ liên kết đến trang bảo tàng.

Chatbot có thể cho tôi biết liệu một tác phẩm có đang được trưng bày hôm nay không?

Để tham quan, hãy mở trang đối tượng bảo tàng hiện tại và kiểm tra thông tin hiển thị của nó. Một tìm kiếm bộ sưu tập sẽ tìm thấy các tác phẩm được lập danh mục, bao gồm cả các tác phẩm đang được lưu trữ.

Chatbot có thể giải thích ý định của một nghệ sĩ không?

Hồ sơ đối tượng cung cấp cho bạn các thông tin danh mục như chất liệu và ngày tháng. Để giải thích ý định của một nghệ sĩ hoặc một biểu tượng trong tác phẩm, hãy sử dụng một nguồn bổ sung, chẳng hạn như một bài tiểu luận của người phụ trách về tác phẩm nghệ thuật cụ thể đó.

Quickchat AI Quickchat AI Ask Quickchat AI a question