Pular para o conteúdo

Catálogo para agentes: o que uma consulta deve devolver

Dados suficientes para comparar uma oferta precisam incluir condições e desconhecidos.

Um catálogo preparado para consultas de agentes precisa identificar o item, diferenciar variantes e fornecer atributos e condições confirmados. A resposta deve indicar limites e permitir nova consulta quando preço ou disponibilidade mudam. Ser legível por uma aplicação não equivale a autorizar compra, nem garante recomendação em um assistente.

Em um exemplo hipotético, o comprador pede uma peça compatível com determinado equipamento. O catálogo encontra um nome parecido, mas não informa a compatibilidade. Se o assistente transformar semelhança textual em confirmação, a loja pode vender o item errado mesmo tendo uma integração tecnicamente funcionando.

A tarefa define quais campos importam. Para comparar camisetas, tamanho e material podem decidir; para uma peça de reposição, modelo e aplicação podem ser indispensáveis. Comece pelas perguntas que precisam de resposta para evitar uma compra inadequada.

Neste guia
  1. Quais dados devem acompanhar o item?
  2. Como permitir uma comparação correta?
  3. Como tratar informação ausente ou ambígua?
  4. Como separar consulta, reserva e compra?
  5. Qual teste mínimo demonstra utilidade?

Quais dados devem acompanhar o item?

Identificador estável, nome, variante, descrição, unidade de venda e atributos relevantes formam a base da consulta. Acrescente links para detalhes e condições que o consumidor precisa conferir. Preço e disponibilidade devem corresponder ao contexto informado, como quantidade, destino ou perfil autorizado quando houver.

Uma API de catálogo pode estruturar a resposta, mas o mesmo cuidado vale para página e feed. O Google documenta o uso de Product e de variantes; isso não estabelece um formato universal para toda aplicação de IA. O contrato UCP de catálogo, por exemplo, possui recursos próprios que só devem ser anunciados quando implementados.

Como permitir uma comparação correta?

PerguntaDado necessário
É o mesmo item?Identificador e variante correspondentes.
Serve para minha necessidade?Atributos técnicos ou compatibilidade confirmada.
Quanto vou comprar?Unidade, embalagem e quantidade explícitas.
Quanto custa receber?Condições de preço e consulta de entrega aplicáveis.

Normalize unidades quando a regra for conhecida e preserve o valor de origem para conferência. Não compare pacote com unidade como se fossem ofertas equivalentes. Também não preencha atributos ausentes com o valor mais comum da categoria: frequência não comprova a característica daquele produto.

Como tratar informação ausente ou ambígua?

Diferencie desconhecido, não aplicável e indisponível. Cada estado conduz a uma decisão diferente. Compatibilidade desconhecida pede confirmação; atributo não aplicável pode ser ignorado; oferta indisponível impede uma promessa de venda. Um campo vazio que serve para tudo transfere a ambiguidade ao assistente.

Na peça do exemplo, devolva os modelos confirmados e informe quando não há informação suficiente. Oferecer encaminhamento ao atendimento pode ser melhor que uma resposta provável. O guia de cadastro e governança de produto ajuda a definir quem corrige a ausência.

Como separar consulta, reserva e compra?

Ler uma oferta não reserva estoque. Adicionar ao carrinho também pode não reservar, conforme o desenho da loja. A API deve deixar claro qual ação muda a operação e por quanto tempo seus efeitos valem. Um assistente não pode inferir reserva a partir de uma frase genérica como disponível.

No fechamento, o sistema comercial precisa conferir novamente as condições relevantes. O guia de disponibilidade vendável mostra por que saldo físico, reserva e promessa de entrega são conceitos distintos. Uma consulta antiga não autoriza manter preço ou prazo sem validação.

Qual teste mínimo demonstra utilidade?

Monte consultas reais de comparação e inclua termos ambíguos, variantes semelhantes, unidade diferente e atributo ausente. A equipe deve verificar se a resposta identifica corretamente o item e se admite quando não sabe. Depois altere uma condição na origem e confira o que a próxima consulta devolve.

Meça acertos e falhas por tipo de pergunta, preservando a amostra usada. Uma boa nota num conjunto pequeno não comprova desempenho em todo o catálogo. O curso SEO Técnico para E-commerce aprofunda a organização das páginas e dos dados. Escolha uma categoria, liste suas perguntas decisivas e bloqueie respostas de compatibilidade que ainda não tenham origem confirmada.

Perguntas frequentes

Preciso expor todos os dados internos?

Não. Publique ou disponibilize apenas o necessário à tarefa, com controles para informações restritas. Um catálogo público não deve revelar dados de clientes ou condições privadas.

Um catálogo legível garante venda por agente?

Não. Consulta é uma capacidade; compra exige outras etapas, participantes e autorizações, além da disponibilidade efetiva da integração.

Por Alexandre Caramaschi, Brasil GEO. Publicado em . Revisado em .

Fontes