두 개의 잘린 해바라기가 푸른색 물감 위에 놓여 있습니다. 스페인어로 요청하면 빈센트 반 고흐의 Sunflowers에 대한 벽면 설명을 얻을 수 있으며, 제작 연도, 재료, 원본 링크가 포함됩니다. 단서에 고양이를 추가하면 프랑스 비단 부채로 이어집니다.
메트로폴리탄 미술관 소장품 API를 검색하고 찾은 작품에 대한 짧은 설명을 작성하는 다국어 뮤지엄 챗봇인 Collection Detective를 만들 것입니다. 아래 그림부터 시작하세요. 마지막에는 Quickchat AI에서 어떤 단서든 따라가서 미술관 자체 도록과 답을 비교할 수 있을 것입니다.
Quickchat AI는 작품 제목 〈Sunflowers〉를 그대로 쓰고 재료는 “óleo sobre lienzo”로 옮겼습니다. 답변을 Google Arts & Culture의 미술관 라벨과 비교해 보세요. 메트로폴리탄 미술관, Rogers Fund, 1949. 미술관 소장품 정보 열기.
1. 뮤지엄 챗봇에게 첫 번째 단서를 주세요
방문객이 테마와 언어를 제공합니다. 탐정은 두 번 조회합니다. 첫 번째는 후보 작품 ID를 찾습니다. 두 번째는 하나의 ID를 열고 작가, 제목, 날짜, 매체 및 출처 링크를 가져옵니다. 그제야 탐정은 설명을 작성합니다.
- Quickchat AI 계정에 로그인하거나 생성하세요. 빈 에이전트를 사용하거나 Add new AI Agent → Set up manually를 선택하세요. 이름을 Collection Detective로 지정하세요. 몇 번의 테스트 대화를 위한 충분한 크레딧이 필요합니다. 미술관 조회는 메트로폴리탄 미술관 계정이나 API 키 없이 작동합니다.
- Identity → AI Persona → Main Prompt를 엽니다. 아래 지침을 붙여넣은 다음 패널을 닫습니다. Identity는 편집 내용을 자동으로 저장합니다. 이 지침은 탐정에게 기록을 선택하는 방법과 언어가 변경될 때 유지할 세부 정보를 알려줍니다.
Collection Detective의 Main Prompt를 복사합니다.
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.
- Identity → Languages에 영어와 스페인어를 추가합니다. 두 번째 언어 확인을 위해 일본어도 추가했습니다. 첫 번째 언어는 모호한 메시지에 대한 대체 언어입니다. 언어 힌트 작동 방식
에이전트의 이름과 지침은 신원에 있습니다. 카탈로그 조회는 다음 단계의 Actions & MCPs에 있습니다.
- 두 가지 작업이 모두 활성화되면 AI Preview에 대한 첫 방문객 메시지를 보관하세요. 방문객은 해바라기를 찾아달라고 요청하며 첫 번째 작품을 스페인어로 설명해 달라고 합니다.
Busca girasoles en la colección del Met y explícame la primera obra en español.
검색 언어가 중요합니다. 2026년 11월 19일 기준으로, 미술관은 동일한 필터로 girasoles를 검색했을 때 0건, sunflowers를 검색했을 때 153건의 결과를 반환했습니다. 방문객이 스페인어로 질문하게 한 다음, 짧은 영어 도록 용어로 검색하고 어떤 단어를 사용했는지 알려주세요.
2. 메트로폴리탄 미술관 컬렉션 API는 어떻게 검색하나요?
첫 번째 액션에 테마라는 하나의 입력을 제공합니다. 방문자가 경로를 따라갈 수 있을 만큼 검색 범위를 작게 유지합니다. 세 개의 후보를 통해 첫 번째 작품을 열고 다른 작품을 조사할 수 있습니다.
- Actions & MCPs에서 Add Action → API Action → Create manually을 선택합니다. API Action Name를
search_met_collection으로, When to run를 AI decides로 설정합니다. API 액션 둘러보기는 더 간단한 요청으로 동일한 편집기를 보여줍니다. - What to ask the user first 아래에
theme라는 필수 Text 매개변수를 추가합니다. 설명에는 “A short English catalogue search phrase, such as sunflowers or cats and sunflowers.”을 입력합니다. - API Endpoint에서 GET을 선택하고
https://collectionapi.metmuseum.org/public/collection/v1.1/search를 입력합니다. Query Params에서 이 네 줄을 만듭니다. 첫 번째 값에 Add AI Data → Parameters를 사용하여 방문자의 테마가 요청에 삽입되도록 합니다.
| 쿼리 키 | 입력할 값 |
|---|---|
q | theme 매개변수 칩을 삽입합니다. |
hasImages | true |
limit | 3 |
offset | 0 |

q에만 들어갑니다. 나머지 세 값은 고정합니다. 메트로폴리탄 미술관의 Search (v1.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.
브라우저에서 해바라기 검색을 엽니다. 다음은 검색 결과의 전체 응답입니다. 개수는 모든 일치 항목을 포함합니다. 목록에는 요청한 세 개의 ID만 포함되어 있으며, 카탈로그가 변경됨에 따라 순서가 변경될 수 있습니다.
{"total":153,"objectIDs":[436524,480725,484935]}
3. 작품 ID를 스페인어 뮤지엄 레이블로 바꾸기
해당 응답의 첫 번째 ID인 436524로 시작합니다. 두 번째 액션은 이를 직접 조회합니다. 메트는 검색에 v1.1을, 개별 작품에 v1을 사용합니다. 이전 검색 예제가 HTTP 410을 반환하면 검색 경로는 변경하고 작품 경로는 v1으로 유지합니다. 메트로폴리탄 미술관 컬렉션 API 참조
- 다른 API Action을 만듭니다. API Action Name을
get_met_object로, When to run을 AI decides로 설정합니다. What to ask the user first 아래에object_id라는 필수 Number를 추가합니다. 설명은 “The integer Met object ID from a search result or the visitor.”로 입력합니다. - API Endpoint에서 GET을 선택합니다.
https://collectionapi.metmuseum.org/public/collection/v1/objects/를 입력하고 마지막 슬래시를 그대로 둔 다음 Add AI Data → Parameters을 사용하여object_id칩을 추가합니다. 첫 번째 ID를 사용하면 주소는/objects/436524로 끝납니다. - 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.
검색 액션에서는 방문자의 단어가 쿼리 줄에 들어갑니다. 여기서는 숫자가 주소 자체의 일부가 됩니다.
AI Preview를 열고 첫 번째 단서를 보냅니다. 원제 Sunflowers, Vincent van Gogh, 1887, 그리고 óleo sobre lienzo를 찾습니다. 답변에 있는 미술관 링크를 따라갑니다. 페이지에는 작품 번호(Object Number)로 49.41도 나열되어 있습니다. 이는 미술관의 소장품 등록 번호입니다. API에서는 436524를 사용합니다. 크레디트 라인의 1949년은 로저스 기금(Rogers Fund)의 취득 연도입니다. 그림 자체는 1887년 작품입니다. 작품 데이터 읽기
돋보기 아이콘으로 그림을 열고 왼쪽 아래에서 “Vincent 87” 서명을 찾아보세요. 작품 페이지의 Details 항목까지 내려가 서명과 Date Created에 적힌 제작 연도를 비교하세요. Google Arts & Culture에서 메트로폴리탄 미술관의 〈Sunflowers〉 살펴보기.
연결된 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를 찾고 다음 요청의 끝에서 찾습니다. 이 숫자들을 일치시키면 다른 작품이 동일한 제목을 가지고 있더라도 스페인어 레이블을 하나의 개체로 추적할 수 있습니다.
검색 결과에서 첫 번째 ID를 따라 개체 조회로 이동합니다. 이 핸드오프가 답변을 그림과 연결하는 것입니다.
새로운 대화에서 이 단서들을 활용해 보세요. 프롬프트를 편집한 후 이를 다시 사용하려면 Testing → Create Dataset을 열고, 데이터셋 이름을 지정한 뒤 질문을 입력하세요. Run Tests → Start Run을 선택한 다음, 완성된 결과에서 View 을 클릭하면 Inbox 에서 해당 대화를 열 수 있습니다.
저작자 표시를 확인하세요. 작품 437406에 대한 스페인어 레이블을 요청하세요. 해당 기록에는 이름으로 Rembrandt가, 접두사로 Follower of가 나와 있습니다. 저희의 첫 번째 답변은 스페인어로 저작자 표시를 설명했지만, 작가란은 영어로 남겨두었습니다. 저희는 수식어와 재료를 모두 번역하도록 지침 하나를 변경했습니다. 다음 답변은 un seguidor de Rembrandt라고 답했고, 날짜의 불확실성을 나타내는 probablemente hacia 1658–62를 유지했습니다. 경매인(The Auctioneer)의 도록 항목 읽기.
두 단어가 귀속을 나타냅니다. “Follower of”은 두 언어 모두에서 작가의 이름과 함께 사용됩니다. 메트로폴리탄 미술관, Bequest of Benjamin Altman, 1913.
이미지를 확인하세요. 두 번째 해바라기 검색 결과인 작품 480725를 보여달라고 요청하세요. 에밀 놀데의 Large Sunflowers는 1928년 작으로 패널에 그려졌습니다. 해당 기록에는 isPublicDomain: false와 빈 이미지 URL이 있습니다. 방문객에게 도록 링크와 재료를 제공하세요. 이 예시는 hasImages=true만으로는 어떤 이미지를 보여줄지 결정할 수 없는 이유를 보여줍니다. 놀데 기록 읽기.
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).
두 번째 검색을 해 보세요. 처음 두 결과의 ID는 705155와 436524였습니다. 메트로폴리탄 미술관은 첫 번째 작품을 드로잉으로 분류합니다. Wikimedia Commons에서 미술관 사진 아래의 Open in Media Viewer를 선택하세요. 부챗살을 따라 늘어선 흰 고양이들을 눈으로 좇으며 해바라기 사이에서 반짝이는 부분을 찾아보세요. Wikimedia Commons에서 부채 자세히 보기.
앙리 샤를 게라르, Fan Design with Cats and Sunflowers, ca. 1885–90. 메트로폴리탄 미술관, Gift of Robert Tuggle and Paul Jeromack, 2015. 메트로폴리탄 미술관에서 부채 탐색하기.
반 고흐는 캔버스에 작업했습니다. 게라르는 무늬 있는 비단에 작업했습니다. 해바라기 사이의 반짝임에는 재료에 대한 설명이 있습니다. 미술관은 잉크와 과슈와 함께 금박을 기재합니다. 날짜는 대략적인 ca. 1885–90으로 유지됩니다. 자신만의 두 단계 탐색을 만들려면 첫 번째 작품에서 세부 사항을 선택하고 다음 단서에 추가한 다음, 두 작품 페이지 모두에서 확인할 수 있는 한 가지 차이점을 탐정에게 물어보세요.
뮤지엄 챗봇 FAQ
메트로폴리탄 미술관 소장품을 검색하려면 API 키가 필요한가요?
메트로폴리탄 미술관은 등록이나 API 키 없이도 공개 검색 및 작품 엔드포인트를 제공합니다. 두 요청 모두 브라우저에서 열 수 있습니다. Quickchat AI는 챗봇 대화를 위해 계정 크레딧을 사용합니다.
어떤 메트로폴리탄 미술관 API 엔드포인트가 작품과 이미지를 반환하나요?
후보 작품 ID를 얻으려면 /public/collection/v1.1/search를 사용하세요. 제목, 작가, 날짜, 재료, 미술관 링크 및 사용 가능한 Open Access 이미지 URL을 얻으려면 ID 하나를 /public/collection/v1/objects/{id}에 전달하세요.
뮤지엄 챗봇이 스페인어나 다른 언어로 답변할 수 있나요?
네. 방문객의 언어로 질문하고, 짧은 영어 도록 용어로 검색한 다음 설명을 번역하세요. 방문객이 미술관 기록을 확인할 수 있도록 원제, 이름, 저작자 표시 수식어는 그대로 유지하세요.
메트로폴리탄 미술관 검색에서 반환된 모든 이미지를 재사용할 수 있나요?
개별 작품 기록을 확인하세요. 메트로폴리탄 미술관은 Open Access 이미지를 CC0에 따라 제공합니다. 이 챗봇은 isPublicDomain가 true이고 기본 이미지 URL이 있을 때만 이미지를 제공합니다. 그렇지 않으면 미술관 페이지로 연결됩니다.
챗봇이 오늘 전시 중인 작품인지 알려줄 수 있나요?
방문을 위해서는 현재 미술관 작품 페이지를 열고 전시 정보를 확인하세요. 소장품 검색은 수장고에 있는 작품을 포함하여 도록에 등재된 작품을 찾습니다.
챗봇이 작가의 의도를 설명할 수 있나요?
작품 기록은 재료 및 날짜와 같은 도록 정보를 제공합니다. 작가의 의도나 작품 속 상징을 설명하려면 해당 특정 작품에 대한 큐레이터의 에세이와 같은 추가 자료를 사용하세요.