Crea un chatbot de museo y sigue la pista de los girasoles en el Met

Piotr Grudzień
Publicado 9 min de lectura
La cartela en español de Collection Detective en Quickchat AI junto a Sunflowers de Van Gogh en el visor de Google Arts & Culture

Dos girasoles cortados reposan sobre un fondo azul. Si preguntas por ellos en español, puedes obtener una cartela de Sunflowers, de Vincent van Gogh, con el año, la técnica y un enlace a la ficha original. Añade un gato a la pista y llegarás a un abanico francés de seda.

Vas a crear Collection Detective, un chatbot de museo multilingüe que consulta la API de la colección del Met y redacta una breve cartela a partir de la ficha que encuentra. Empieza con el cuadro que ves aquí. Al terminar, podrás seguir cualquiera de las dos pistas en Quickchat AI y contrastar la respuesta con el catálogo del museo.

Una respuesta en español sobre los girasoles en Quickchat AI y la obra Sunflowers de Van Gogh en la galería de Google Arts & Culture del Met Quickchat AI mantuvo el título Sunflowers y tradujo la técnica a “óleo sobre lienzo”. Compara la respuesta con la cartela del museo en Google Arts & Culture. El Met, Rogers Fund, 1949. Abre la ficha del museo.

1. Dale la primera pista a tu chatbot de museo

El visitante elige un tema y un idioma. El detective hace dos consultas. La primera devuelve los identificadores de las obras que coinciden. Con uno de esos números, la segunda obtiene el autor, el título, la fecha, la técnica y el enlace a la fuente. Con esos datos, el detective redacta la cartela.

  1. Inicia sesión o crea una cuenta de Quickchat AI. Empieza con un agente vacío o selecciona Add new AI Agent → Set up manually. Llámalo Collection Detective. Necesitarás créditos para unas cuantas conversaciones de prueba. Para consultar el catálogo no necesitas una cuenta del Met ni una clave de API.
  2. Abre Identity → AI Persona → Main Prompt, pega las instrucciones que encontrarás a continuación y cierra el panel. Identity guarda los cambios automáticamente. Así el detective sabrá qué ficha elegir y qué datos conservar al traducirla.
Copia el Main Prompt para 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. En Identity → Languages, añade inglés y español. También añadimos japonés para probar la respuesta en otro idioma. Si el mensaje es ambiguo, se usa el primer idioma de la lista. Cómo se elige el idioma de respuesta

Nombre de Collection Detective y campo Main Prompt en la sección Identity de Quickchat AI El nombre y las instrucciones del agente se configuran en Identity. En el siguiente paso, añadirás las consultas al catálogo en Actions & MCPs.

  1. Guarda este mensaje para probarlo en AI Preview cuando las dos acciones estén activadas. El visitante pide que se busquen girasoles y se le presente la primera obra en español.

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

El idioma cambia los resultados. El 19 de noviembre de 2026, el museo devolvió cero coincidencias para girasoles y 153 para sunflowers con los mismos filtros. El visitante puede preguntar en español. Usa un término breve en inglés para buscar en el catálogo y dile cuál has usado.

2. ¿Cómo se busca en la API de la colección del Met?

La primera acción solo necesita un dato, el tema. Limita la búsqueda a tres resultados para que sea fácil seguir la pista. Podrás abrir la primera obra y tendrás otras dos por explorar.

  1. En Actions & MCPs, elige Add Action → API Action → Create manually. Escribe search_met_collection en API Action Name y selecciona AI decides en When to run. La guía de acciones de API muestra el mismo editor con una solicitud más sencilla.
  2. En What to ask the user first, añade un parámetro obligatorio de tipo Text y llámalo theme. Escribe «A short English catalogue search phrase, such as sunflowers or cats and sunflowers.» en la descripción.
  3. En API Endpoint, elige GET e introduce https://collectionapi.metmuseum.org/public/collection/v1.1/search. Añade las cuatro filas siguientes en Query Params. Para el valor de la primera, usa Add AI Data → Parameters. Así se incorporará a la solicitud el tema que pida el visitante.
Parámetro de consultaValor
qInserta el parámetro theme desde el menú.
hasImagestrue
limit3
offset0

La referencia Search (v1.1) del Met y los cuatro parámetros de consulta en el editor de acciones de Quickchat AI Haz coincidir las cuatro filas en Quickchat AI con los parámetros de búsqueda del Met. Solo q toma el tema del visitante. Los otros tres valores permanecen fijos. Lee la referencia Search (v1.1) del Met.

  1. En Headers, añade Accept con el valor application/json. Deja vacío el campo Body. Pega el texto siguiente en API Action Description, selecciona Save changes y comprueba que el interruptor de la acción esté activado.
Copia la descripción de la acción de búsqueda
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.

Abre la búsqueda de girasoles en tu navegador. Esta es la respuesta completa de nuestra consulta. El total incluye todas las coincidencias. La lista solo contiene los tres identificadores que pedimos, y su orden puede cambiar al actualizarse el catálogo.

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

3. Redacta una cartela en español a partir del identificador de una obra

Empieza por 436524, el primer identificador de la respuesta. La segunda acción lo consulta directamente. El Met usa v1.1 para las búsquedas y v1 para las fichas individuales. Si un ejemplo antiguo devuelve HTTP 410 al buscar, actualiza la ruta de búsqueda y conserva v1 en la ruta de las obras. Documentación de la API de la colección del Met

  1. Crea otra API Action. Escribe get_met_object en API Action Name y selecciona AI decides en When to run. En What to ask the user first, añade un parámetro obligatorio de tipo Number llamado object_id. Usa «The integer Met object ID from a search result or the visitor.» como descripción.
  2. En API Endpoint, elige GET. Introduce https://collectionapi.metmuseum.org/public/collection/v1/objects/ y conserva la barra final. Con Add AI Data → Parameters, añade a continuación el parámetro object_id. Al consultar el primer resultado, la dirección termina en /objects/436524.
  3. Deja vacíos Query Params y Body. En Headers, añade Accept con el valor application/json. Pega la descripción siguiente en API Action Description, selecciona Save changes y comprueba que el interruptor de la acción esté activado.
Copia la descripción de la acción que consulta la obra
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.

Consulta de la obra en Quickchat AI con su identificador al final de la URL del Met En la acción de búsqueda, la palabra del visitante es un parámetro de consulta. En esta segunda acción, el número forma parte de la dirección.

Abre AI Preview y envía la primera pista. Comprueba que la respuesta incluye el título original Sunflowers, Vincent van Gogh, 1887 y óleo sobre lienzo. Abre el enlace al museo. Verás 49.41 en el campo Object Number, el número de inventario de la obra. Para la API, usa 436524. El año 1949 que figura en los créditos corresponde a la adquisición con fondos del Rogers Fund. El cuadro se pintó en 1887. Consulta los datos de la obra

El visor de Google Arts & Culture para Sunflowers y un primer plano de la firma “Vincent 87” en la parte inferior izquierda Abre el cuadro con la lupa y encuentra “Vincent 87” en la esquina inferior izquierda. En la página de la obra, desplázate hasta la sección Details y compara la firma con el año que figura bajo Date Created. Explora Sunflowers del Met en Google Arts & Culture.

Configura las dos acciones desde un asistente de IA conectado

Si gestionas Quickchat AI desde ChatGPT o Claude, puedes pasarle las dos configuraciones anteriores junto con estas instrucciones. Revisa los campos generados y prueba la primera pista. Cómo conectar tu cuenta

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. ¿Cómo se comprueba una cartela traducida?

En Inbox, abre la conversación y despliega 2 actions called debajo de la respuesta. Para ver los detalles, ve a Actions & MCPs → Custom Actions y selecciona View logs en cada acción. Busca 436524 en los resultados de la primera consulta y al final de la dirección de la segunda. Si los números coinciden, sabrás a qué obra corresponde la cartela en español, aunque haya otras con el mismo título.

Los resultados de la búsqueda de girasoles y la consulta posterior de la obra 436524 Sigue el primer identificador desde el resultado de búsqueda hasta la consulta de la obra. Ese número vincula la respuesta con el cuadro.

Prueba estas pistas en conversaciones nuevas. Para repetirlas después de editar las instrucciones, abre Testing → Create Dataset, da un nombre al conjunto de datos y añade las preguntas. Selecciona Run Tests → Start Run. Cuando termine la prueba, elige View en un resultado para abrir la conversación en Inbox.

Comprueba la atribución. Pide una cartela en español para la obra 437406. En la ficha aparece Rembrandt en el campo del nombre y Follower of como prefijo. En la primera respuesta, el detective explicó la atribución en español, pero dejó en inglés la línea con el autor. Ajustamos una instrucción para que tradujera tanto el matiz de atribución como la técnica. La siguiente respuesta decía un seguidor de Rembrandt y conservaba la incertidumbre de la fecha, probablemente hacia 1658–62. Consulta la ficha del retrato.

El retrato de un subastador, atribuido en el catálogo a un seguidor de Rembrandt, y la misma atribución en español Dos palabras precisan la autoría. «Follower of» acompaña al nombre del artista y su matiz debe conservarse en español. El Met, Bequest of Benjamin Altman, 1913.

Comprueba la imagen. Pide ver la obra 480725, el segundo resultado de la búsqueda de girasoles. El cuadro Large Sunflowers, de Emil Nolde, data de 1928 y está pintado sobre tabla. En su ficha aparece isPublicDomain: false y las URL de las imágenes están vacías. Ofrece al visitante el enlace a la ficha e indica el material. Aquí puedes ver por qué hasImages=true por sí solo no basta para decidir qué imagen mostrar. Consulta la ficha de Nolde.

Respuesta de Quickchat AI sobre Emil Nolde, solo con texto, junto al indicador de dominio público y los campos de imagen vacíos de la ficha del Met El museo puede compartir los datos de la obra aunque la API no facilite una fotografía reutilizable. Política de imágenes Open Access del Met.

Prueba una búsqueda sin resultados. Pide que se busque el término exacto zzzxxyycollectiontest. La API devolvió {"total":0,"objectIDs":null}. En ese caso, el detective puede proponer un tema más amplio. Un fallo del servicio requiere otra respuesta. Cuando simulamos un error HTTP 503, el detective pidió al visitante que lo intentara más tarde y no llegó a consultar ninguna obra.

5. Sigue los girasoles hasta un abanico de seda

Conserva las flores y añade un animal. Dale a Collection Detective una segunda pista y pregúntale sobre qué soporte trabajó cada artista. Puedes copiar este mensaje tal cual.

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

Prueba la segunda búsqueda. Nuestros dos primeros ID fueron 705155 y 436524. El Met cataloga la primera obra como un dibujo. En Wikimedia Commons, elige Open in Media Viewer debajo de la fotografía del museo. Sigue a los gatos blancos a lo largo de las varillas y busca el brillo entre los girasoles. Inspecciona el abanico en Wikimedia Commons.

El abanico de Guérard con gatos blancos y girasoles en Wikimedia Commons junto a un detalle de la pintura de Van Gogh Henri Charles Guérard, Fan Design with Cats and Sunflowers, ca. 1885–90. El Met, Gift of Robert Tuggle and Paul Jeromack, 2015. Explora el abanico en el Met.

Van Gogh pintó sobre lienzo. Guérard dibujó sobre seda con motivos. La ficha da una pista sobre el brillo entre los girasoles. Entre los materiales figuran el pan de oro, la tinta y el gouache. La datación es aproximada, ca. 1885–90. Para crear tu propio recorrido de dos obras, elige un detalle de la primera e incorpóralo a la siguiente pista. Pide al detective una diferencia que puedas comprobar en ambas fichas.

Preguntas frecuentes sobre el chatbot de museo

¿Necesito una clave API para buscar en la colección del Met?

El Metropolitan Museum of Art ofrece dos rutas públicas, una para buscar y otra para consultar las obras. Puedes abrir ambas en el navegador sin registrarte ni pedir una clave de API. La conversación con el chatbot consume créditos de tu cuenta de Quickchat AI.

¿Qué ruta de la API del Met devuelve la ficha de una obra y su imagen?

Usa /public/collection/v1.1/search para obtener los identificadores de las obras que coinciden con la búsqueda. Pasa uno de ellos a /public/collection/v1/objects/{id} para obtener el título, el autor, la fecha, la técnica, el enlace al museo y, cuando las haya, las URL de las imágenes Open Access.

¿Puede el chatbot del museo responder en español o en otro idioma?

Sí. El visitante pregunta en su idioma, el chatbot busca en el catálogo con un término breve en inglés y traduce la explicación. Conserva el título original, los nombres y cualquier matiz de atribución para que el visitante pueda contrastarlos con la ficha del museo.

¿Puedo reutilizar todas las imágenes devueltas por una búsqueda del Met?

Comprueba la ficha de cada obra. El Met distribuye sus imágenes Open Access bajo la licencia CC0. El chatbot ofrece una imagen si isPublicDomain es verdadero y la ficha incluye la URL de la imagen principal. En los demás casos, facilita el enlace a la página del museo.

¿Puede decirme el chatbot si una obra está expuesta hoy?

Si planeas una visita, consulta la página de la obra en el sitio del museo para ver si está expuesta. En los resultados de la colección también aparecen obras que se conservan en los almacenes.

¿Puede el chatbot explicar la intención de un artista?

La ficha recoge datos como la técnica y la fecha. Para explicar la intención del artista o interpretar un símbolo, hace falta otra fuente, como un texto del equipo de conservación dedicado a esa obra.

Quickchat AI Quickchat AI Ask Quickchat AI a question