Crie um Chatbot de Museu para uma Caça aos Girassóis no The Met

Piotr Grudzień
Publicado em 8 min de leitura
Etiqueta em espanhol do Collection Detective no Quickchat AI ao lado de Sunflowers de Van Gogh no visualizador do Google Arts & Culture

Dois girassóis cortados repousam sobre uma cama de tinta azul. Peça-os em espanhol e você pode obter uma etiqueta de parede para Sunflowers de Vincent van Gogh, completa com o ano, o material e um link para o original. Adicione gatos à pista e a trilha leva a um leque de seda francês.

Você construirá o Collection Detective, um chatbot de museu multilíngue que pesquisa a API da Coleção do Met e escreve uma breve etiqueta a partir da obra de arte que encontra. Comece com a pintura abaixo. Ao final, você poderá seguir qualquer pista em Quickchat AI e verificar a resposta com o próprio catálogo do museu.

Uma resposta em espanhol sobre girassóis no Quickchat AI e a obra Sunflowers de Van Gogh na galeria do The Met no Google Arts & Culture O Quickchat AI manteve o título Sunflowers e traduziu o meio para “óleo sobre lienzo”. Compare a resposta com a etiqueta do museu no Google Arts & Culture. The Met, Rogers Fund, 1949. Abra o registro do museu.

1. Dê a primeira pista ao seu chatbot de museu

O visitante fornece um tema e um idioma. O detetive faz duas buscas. A primeira encontra IDs de objeto candidatos. A segunda abre um ID e retorna o artista, o título, a data, o suporte e o link da fonte. Só então o detetive escreve a legenda.

  1. Faça login ou crie uma conta Quickchat AI. Use um Agente vazio ou selecione Add new AI Agent → Set up manually. Nomeie-o Collection Detective. Você precisará de créditos suficientes para algumas conversas de teste. As consultas ao museu funcionam sem uma conta do Met ou chave de API.
  2. Abra Identity → AI Persona → Main Prompt. Cole as instruções abaixo e feche o painel. A identidade salva suas edições automaticamente. Elas informam ao detetive como escolher um registro e quais detalhes manter quando o idioma muda.
Copie o 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. Em Identity → Languages, adicione inglês e espanhol. Também adicionamos japonês para uma segunda verificação de idioma. O primeiro idioma é o padrão para mensagens ambíguas. Como funcionam as dicas de idioma

O nome do Collection Detective e o Main Prompt nas configurações de Identity do Quickchat AI O nome e as instruções do agente ficam em Identity. As buscas no catálogo vão em Actions & MCPs, na próxima etapa.

  1. Mantenha esta primeira mensagem do visitante para AI Preview assim que ambas as Ações estiverem ativadas. O visitante está pedindo para encontrar girassóis e explicar a primeira obra em espanhol.

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

O idioma da busca é importante. Em 19 de novembro de 2026, o museu retornou zero resultados para girasoles e 153 para sunflowers com os mesmos filtros. Permita que o visitante pergunte em espanhol, pesquise pelo termo curto do catálogo em inglês e informe qual palavra você usou.

2. Como você pesquisa a API da Coleção do Met?

Dê à primeira Ação uma entrada, o tema. Mantenha a busca pequena o suficiente para que um visitante possa seguir a trilha. Três candidatos permitem que você abra a primeira obra e ainda tenha outra para investigar.

  1. Em Actions & MCPs, escolha Add Action → API Action → Create manually. Defina API Action Name como search_met_collection e When to run como AI decides. O passo a passo das Ações da API mostra o mesmo editor com uma solicitação mais simples.
  2. Em What to ask the user first, adicione um parâmetro Text obrigatório chamado theme. Para sua descrição, insira “A short English catalogue search phrase, such as sunflowers or cats and sunflowers.”
  3. Em API Endpoint, escolha GET e insira https://collectionapi.metmuseum.org/public/collection/v1.1/search. Em Query Params, crie estas quatro linhas. Use Add AI Data → Parameters para o primeiro valor para que o tema do visitante seja inserido na solicitação.
Chave da consultaValor a ser inserido
qInsira o chip do parâmetro theme.
hasImagestrue
limit3
offset0

A referência Search (v1.1) do The Met e os quatro parâmetros de consulta no editor de Ação do Quickchat AI Combine as quatro linhas no Quickchat AI com os parâmetros de busca do The Met. Apenas q usa o tema do visitante. Os outros três valores permanecem fixos. Leia a referência Search (v1.1) do The Met.

  1. Em Headers, insira Accept com o valor application/json. Deixe Body vazio. Cole o seguinte em API Action Description, escolha Save changes e verifique se o interruptor da Ação está ligado.
Copie a descrição da Ação de busca
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.

Abra a busca por girassóis no seu navegador. Aqui está a resposta completa da nossa busca. A contagem abrange todos os resultados. A lista contém apenas os três IDs que solicitamos, e sua ordem pode mudar conforme o catálogo é atualizado.

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

3. Transforme um ID de objeto em uma etiqueta de museu em espanhol

Comece com 436524, o primeiro ID nessa resposta. A segunda Ação o consulta diretamente. O Met usa v1.1 para busca e v1 para objetos individuais. Se um exemplo de busca mais antigo retornar HTTP 410, altere a rota de busca e mantenha a rota de objeto em v1. A referência da API da Coleção do Met

  1. Crie outra API Action. Defina API Action Name como get_met_object e When to run como AI decides. Em What to ask the user first, adicione um Number obrigatório chamado object_id. Descreva-o como “The integer Met object ID from a search result or the visitor.”
  2. Em API Endpoint, escolha GET. Insira https://collectionapi.metmuseum.org/public/collection/v1/objects/, deixe a barra final no lugar e use Add AI Data → Parameters para anexar o chip object_id. Com nosso primeiro ID, o endereço termina em /objects/436524.
  3. Deixe Query Params e Body vazios. Em Headers, use Accept com application/json. Cole a descrição abaixo em API Action Description, escolha Save changes e verifique se o interruptor da Ação está ligado.
Copie a descrição da Ação de objeto
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.

A consulta de objeto em Quickchat AI com o ID do objeto inserido no final da URL do Met Na Ação de busca, a palavra do visitante vai em uma linha de consulta. Aqui, o número se torna parte do próprio endereço.

Abra o AI Preview e envie a primeira pista. Procure pelo título original Sunflowers, Vincent van Gogh, 1887 e óleo sobre lienzo. Siga o link do museu na resposta. A página também lista 49.41 como seu número de objeto. Esse é o número de aquisição do museu. Use 436524 na API. O ano de 1949 na linha de crédito pertence à aquisição do Rogers Fund. A pintura em si data de 1887. Leia os dados do objeto

O visualizador Google Arts & Culture para Sunflowers e um close-up da assinatura “Vincent 87” no canto inferior esquerdo Abra a pintura com a lupa e encontre “Vincent 87” no canto inferior esquerdo. Na página da obra, role até Details e compare a assinatura com o ano em Date Created. Explore Sunflowers do The Met no Google Arts & Culture.

Configure as mesmas duas Ações de um assistente de IA conectado

Se você gerencia Quickchat AI através do ChatGPT ou do Claude, também pode usar as duas receitas acima com esta solicitação de configuração. Revise os campos gerados e, em seguida, execute a primeira pista você mesmo. Instruções de conexão de conta

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. Como você verifica uma etiqueta de obra de arte traduzida?

Em Inbox, abra a conversa e expanda 2 actions called abaixo da resposta. Para os detalhes da solicitação, vá para Actions & MCPs → Custom Actions e selecione View logs para cada Ação. Encontre 436524 na resposta da busca e no final da próxima solicitação. A correspondência desses números permite rastrear a etiqueta em espanhol de volta a um objeto, mesmo que outra obra tenha o mesmo título.

O resultado da busca por girassóis e a subsequente consulta para o objeto 436524 Siga o primeiro ID do resultado da busca para a consulta do objeto. Essa passagem é o que conecta a resposta à pintura.

Experimente estas pistas em novas conversas. Para repeti-las após editar o prompt, abra Testing → Create Dataset, nomeie o conjunto de dados e insira as perguntas. Selecione Run Tests → Start Run, depois View em um resultado concluído para abrir sua conversa em Inbox.

Verifique a atribuição. Peça uma etiqueta em espanhol para o objeto 437406. Seu registro indica Rembrandt como o nome e Follower of como o prefixo. Nossa primeira resposta explicou a atribuição em espanhol, mas deixou a linha do artista em inglês. Mudamos uma instrução para traduzir o qualificador, bem como o meio. A próxima resposta deu un seguidor de Rembrandt e manteve a incerteza na data, probablemente hacia 1658–62. Leia a entrada do catálogo do Leiloeiro.

O Leiloeiro, com sua atribuição no catálogo a um seguidor de Rembrandt e a redação correspondente em espanhol Duas palavras carregam a atribuição. “Follower of” acompanha o nome do artista nos dois idiomas. The Met, Bequest of Benjamin Altman, 1913.

Confira a imagem. Peça para ver o objeto 480725, a segunda correspondência de girassol. Large Sunflowers, de Emil Nolde, é datado de 1928 e pintado sobre madeira. Seu registro tem isPublicDomain: false e URLs de imagem vazias. Forneça ao visitante o link do catálogo e o material. Este exemplo mostra por que hasImages=true por si só não pode decidir qual imagem mostrar. Leia o registro de Nolde.

A resposta apenas em texto do Quickchat AI para Emil Nolde, ao lado do indicador de domínio público e dos campos de imagem vazios no registro do Met O museu pode compartilhar os detalhes do catálogo mesmo quando a API não fornece nenhuma fotografia reutilizável. A política de imagens de acesso aberto (Open Access) do Met.

Verifique uma pesquisa vazia. Peça o termo exato zzzxxyycollectiontest. A API retornou {"total":0,"objectIDs":null}. O detetive pode pedir uma pista mais ampla. Uma pesquisa falha precisa de uma resposta diferente. Quando simulamos um HTTP 503, o detetive pediu ao visitante para tentar novamente mais tarde e não fez nenhuma solicitação de objeto.

5. Siga os girassóis até um leque de seda

Mantenha as flores e acrescente um animal. Dê uma segunda pista a Collection Detective e pergunte em qual superfície cada artista trabalhou. Você pode usar esta mensagem exatamente como está escrita.

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

Experimente a segunda busca. Nossos dois primeiros IDs foram 705155 e 436524. O Met cataloga a primeira obra como um desenho. No Wikimedia Commons, escolha Open in Media Viewer abaixo da fotografia do museu. Siga os gatos brancos ao longo das varetas e procure o brilho entre os girassóis. Inspecione o leque no Wikimedia Commons.

Leque de Guérard com gatos brancos e girassóis no Wikimedia Commons ao lado de um detalhe da pintura de 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. Explore o leque no The Met.

Van Gogh trabalhava em tela. Guérard trabalhava em seda estampada. O brilho entre os girassóis tem uma explicação material. O museu lista a folha de ouro ao lado da tinta e do guache. A data permanece aproximada: ca. 1885–90. Para criar sua própria caça ao tesouro com duas etapas, escolha um detalhe da primeira obra, adicione-o à próxima pista e peça ao detetive para apontar uma diferença que você possa verificar nas páginas de ambos os objetos.

Perguntas frequentes sobre o chatbot do museu

Preciso de uma chave de API para pesquisar a coleção do The Met?

O Metropolitan Museum of Art oferece endpoints públicos de pesquisa e objetos sem registro ou chave de API. Você pode abrir ambas as solicitações em um navegador. Quickchat AI usa créditos da conta para a conversa do chatbot.

Qual endpoint da API do Met retorna uma obra de arte e sua imagem?

Use /public/collection/v1.1/search para obter os IDs de objetos candidatos. Passe um ID para /public/collection/v1/objects/{id} para obter o título, o artista, a data, o suporte, o link do museu e quaisquer URLs de imagem de acesso aberto (Open Access) disponíveis.

O chatbot do museu pode responder em espanhol ou outro idioma?

Sim. Faça a pergunta no idioma do visitante, pesquise com um termo curto do catálogo em inglês e traduza a explicação. Mantenha o título original, os nomes e os qualificadores de autoria para que o visitante possa verificar o registro do museu.

Posso reutilizar todas as imagens retornadas por uma pesquisa do Met?

Verifique o registro individual do objeto. O Met disponibiliza suas imagens Open Access sob CC0. Este chatbot oferece uma imagem apenas quando isPublicDomain é verdadeiro e um URL de imagem principal está presente. Caso contrário, ele linka para a página do museu.

O chatbot pode me dizer se uma obra está em exibição hoje?

Para uma visita, abra a página atual do objeto do museu e verifique suas informações de exibição. Uma pesquisa na coleção encontra obras catalogadas, incluindo obras em armazenamento.

O chatbot pode explicar o que um artista pretendia?

O registro do objeto fornece fatos do catálogo, como o suporte e a data. Para explicar as intenções de um artista ou um símbolo na obra, use uma fonte adicional, como um ensaio de curador sobre aquela obra de arte em particular.

Quickchat AI Quickchat AI Ask Quickchat AI a question