Universal Commerce Protocol: como os agentes de IA estão a mudar as compras online

O Universal Commerce Protocol (UCP) é um padrão aberto que permite a agentes de IA descobrir produtos, montar carrinhos e concluir a finalização da compra com um comerciante diretamente a partir de uma interface de IA. O comerciante publica um perfil em /.well-known/ucp, declara as capacidades que suporta e o agente negoceia a parte comum. A Google lançou-o em janeiro de 2026 em conjunto com a Shopify, a Etsy, a Wayfair, a Target e a Walmart, e utiliza-o no AI Mode da Pesquisa e no Gemini.

#O que é o Universal Commerce Protocol

O Universal Commerce Protocol (UCP) é um padrão aberto que define como os sistemas de IA interagem com comerciantes para descobrir produtos, verificar preços e disponibilidade e concluir transações. A documentação para programadores da Google descreve-o como “um padrão aberto concebido para o futuro do comércio” (tradução própria) (documentação Google Merchant UCP). Resolve um problema prático: um assistente de IA que já encontrou o produto certo continua a precisar de uma forma fiável de o comprar sem que uma pessoa tenha de clicar numa loja online.

Ao contrário do e-commerce tradicional, em que os utilizadores navegam por sites, adicionam artigos ao carrinho e preenchem à mão os formulários de finalização da compra, o UCP torna possível aquilo a que a Google chama “comércio agêntico” (tradução própria): agentes de IA que atuam em nome dos utilizadores para encontrar produtos que correspondam aos seus critérios, comparar opções, confirmar detalhes e executar compras.

#Quem criou o UCP e quem o mantém

O UCP não é uma especificação exclusiva da Google. Sundar Pichai anunciou-o na conferência de retalho NRF a 11 de janeiro de 2026, descrevendo-o como desenvolvido em conjunto com a Shopify, a Etsy, a Wayfair, a Target e a Walmart e apoiado por mais de 20 outras empresas (Google, intervenção na NRF 2026). A Shopify publicou no mesmo dia o seu próprio relato técnico, escrito por Ilya Grigorik (Shopify Engineering).

O site do projeto, ucp.dev, lista agora os codesenvolvedores por vertical: compras (incluindo Google, Shopify, Etsy, Wayfair, Target, Walmart, Salesforce e Stripe), alojamento (incluindo Booking.com, Expedia Group, Hilton e Marriott) e restauração (incluindo DoorDash, Square, Toast e Uber Eats). A especificação está publicada no GitHub sob a Apache License 2.0, com direitos de autor de UCP Authors e um guia público de contribuição (ucp.dev). Na prática: as superfícies da Google são hoje o maior consumidor do UCP, mas o protocolo em si é de código aberto e qualquer plataforma o pode implementar.

#Como o UCP muda o SEO e a descoberta de produtos

Durante mais de duas décadas, a otimização para motores de pesquisa (SEO) foi o principal mecanismo através do qual as empresas tornavam os seus produtos e serviços encontráveis online. As empresas otimizavam páginas com palavras-chave relevantes, construíam backlinks e criavam conteúdo para subir nos resultados de pesquisa.

O UCP desloca parte desse trabalho da camada de apresentação (páginas web) para a camada de dados (feeds, perfis e APIs). As perguntas frequentes da Google sobre o UCP são explícitas em dois pontos. A descoberta de produtos nas suas superfícies continua a assentar no Shopping Graph e nos feeds do Merchant Center, e uma integração nativa com o UCP não altera a classificação: acrescenta uma opção de compra direta às ofertas elegíveis (perguntas frequentes Google UCP). Por isso, as perguntas que decidem a visibilidade são sobre dados:

• Qualidade dos dados: o seu feed de produtos está completo, correto e atualizado?
• Conformidade com o esquema: as páginas de produto têm os tipos Schema.org certos (Product, Offer, PriceSpecification)?
• Sinais de disponibilidade: um agente consegue confirmar stock e prazos de entrega em tempo real?
• Prontidão para a transação: o agente consegue concluir a compra sem enviar o comprador para um formulário?

#Como um comerciante publica um perfil UCP

A descoberta começa num único ficheiro. O guia de implementação da Google indica que o perfil UCP deve ser publicado em /.well-known/ucp no domínio do comerciante (publicar o perfil). Os engenheiros da Google descrevem-no como um manifesto JSON padrão que lista os serviços e as capacidades que uma empresa suporta, para que os agentes encontrem funcionalidades, endpoints e configuração de pagamentos sem uma integração programada à medida (Google Developers Blog, Under the Hood).

Um perfil abreviado que segue a estrutura do exemplo da Google tem este aspeto (URLs de endpoints e de esquemas omitidos):

{
  "ucp": {
    "version": "2026-04-08",
    "services": {
      "dev.ucp.shopping": [{ "transport": "rest", "endpoint": "..." }]
    },
    "capabilities": {
      "dev.ucp.shopping.checkout": [{ "version": "2026-04-08" }],
      "dev.ucp.shopping.discount": [{ "extends": "dev.ucp.shopping.checkout" }]
    },
    "payment_handlers": { "com.google.pay": [{ "config": { } }] }
  },
  "signing_keys": [{ "kid": "...", "kty": "EC", "crv": "P-256" }]
}

O objeto ucp contém a versão do protocolo, os serviços e as capacidades. signing_keys guarda as chaves públicas em formato JWK. O texto da Google chama à configuração de pagamentos um irmão de ucp, mas o exemplo coloca payment_handlers dentro dele, por isso confirme na especificação da versão que pretende suportar antes de copiar qualquer uma das formas.

#Serviços, capacidades e extensões

Grigorik descreve o UCP em três camadas. O serviço de compras contém as primitivas base. Por cima ficam capacidades como Checkout, Orders e Catalog, com versões independentes. As extensões acrescentam esquemas específicos de cada domínio por composição, por exemplo descontos ou fulfillment a estender o checkout. Os nomes usam notação de domínio invertido (dev.ucp.shopping.checkout), pelo que uma empresa pode publicar a sua própria extensão sob o seu próprio domínio sem um registo central.

Ambas as partes publicam perfis. O agente obtém o perfil do comerciante e “a negociação calcula a sua interseção” (tradução própria) (Shopify Engineering): a transação usa apenas as capacidades que as duas partes suportam. Uma loja que implementa checkout mas não carrinho continua a funcionar com um agente que suporta ambos; a sessão decorre então sem as funções de carrinho.

Os nomes de capacidades no perfil de exemplo da Google são dev.ucp.shopping.checkout, dev.ucp.shopping.cart, dev.ucp.shopping.order, dev.ucp.shopping.fulfillment, dev.ucp.shopping.discount e dev.ucp.common.identity_linking. A 19 de março de 2026, a Google acrescentou três capacidades opcionais nas suas superfícies: Cart (vários artigos da mesma loja de uma só vez), Catalog (detalhes do produto em tempo real, como variantes, inventário e preço) e Identity Linking (os compradores com sessão iniciada mantêm benefícios de fidelização ou de membro) (Google, atualizações do UCP).

#Opções de integração da finalização da compra

O UCP suporta dois modelos de finalização da compra:

1. Native checkout: o modelo predefinido nas superfícies da Google. A lógica de finalização da compra integra-se diretamente com o AI Mode e o Gemini, e o agente trabalha sobre a API de finalização da compra do comerciante.

2. Embedded checkout: um caminho opcional baseado em iframe que a Google reserva a comerciantes específicos e aprovados, com uma identidade de marca muito personalizada ou fluxos de finalização da compra complexos.

O relato da Shopify explica como o caminho incorporado passa o controlo a uma pessoa. O Embedded Checkout Protocol, derivado do Checkout Kit da Shopify, abre um canal JSON-RPC 2.0 entre a interface do agente e a finalização da compra do comerciante. Uma finalização da compra passa pelos estados incomplete, requires_escalation e ready_for_complete; o estado de escalamento é aquele em que se pede ao comprador que intervenha, por exemplo para confirmar um meio de pagamento ou aceitar os termos.

#UCP vs MCP vs A2A vs AP2 no comércio agêntico

O UCP não existe isoladamente. Define a semântica do comércio e deixa o transporte a outros padrões: os engenheiros da Google indicam REST APIs, MCP e A2A como transportes suportados, pelo que uma mesma capacidade de checkout pode ter, ao mesmo tempo, uma ligação REST e uma ligação MCP.

#Model Context Protocol (MCP)

O MCP (Model Context Protocol) permite que agentes de IA chamem sistemas externos como ferramentas tipadas. Desenvolvido originalmente pela Anthropic para o Claude, o MCP permite que os sistemas de IA:

• Executem pesquisas e consultas de forma programática
• Leiam conteúdo sem renderizar HTML
• Submetam ações estruturadas em vez de preencher formulários
• Acedam a APIs e endpoints de dados

Pense no MCP como a camada de ferramentas e no UCP como o vocabulário de comércio que pode circular por ela. Numa loja WooCommerce, mantenha as duas coisas separadas: perguntas e respostas sobre o catálogo via REST pertencem a um MCP apenas de leitura, como o woocommerce-mcp no GitHub, enquanto a finalização da compra por agentes e os feeds de comerciante pertencem a este guia de UCP. O âmbito de um MCP feito à medida está descrito em desenvolvimento de servidores MCP.

#Agent-to-Agent Protocol (A2A)

Desenvolvido pela Google, o A2A (Agent2Agent) trata da comunicação entre diferentes agentes de IA. Permite fluxos de trabalho em que agentes especializados colaboram: um trata da descoberta de produtos enquanto outro gere a compra. O UCP indica o A2A como um dos seus transportes.

#Agent Payments Protocol (AP2)

O AP2 é o protocolo da Google para pagamentos iniciados por agentes. As perguntas frequentes da Google descrevem a divisão: o UCP orquestra o ciclo de vida da compra e o AP2 pode servir de camada de pagamento especializada. Os instrumentos de pagamento (com o que o comprador paga) ficam separados dos processadores de pagamento (quem processa o pagamento), e os engenheiros da Google afirmam que cada autorização é sustentada por uma prova criptográfica do consentimento do utilizador.

#O que é o WebMCP e como complementa o UCP

O WebMCP é uma especificação em rascunho do W3C Web Machine Learning Community Group, editada por engenheiros da Microsoft e da Google. Permite que uma página web exponha funções JavaScript como ferramentas que um agente pode chamar, através de document.modelContext.registerTool() (rascunho WebMCP). É um rascunho de grupo comunitário, não um padrão W3C. Onde o UCP comunica com o backend do comerciante, o WebMCP cobre a página que o utilizador já tem aberta no navegador.

Atualização, 2 de novembro de 2026. A Cloudflare descreveu como a Commerce.com ativou WebMCP na edge em quase 100 000 lojas sem os comerciantes editarem temas. A Cloudflare injeta um pequeno script de ponte na edge; ferramentas como search_products e add_to_cart correm na sessão do browser do comprador no domínio da loja, pelo que preços e carrinho coincidem com o que um humano vê e o checkout fica no comerciante. Cada loja pode desativar via metadados de hostname e uma Configuration Rule (cf.hostname.metadata.webmcp_opt_out), e o URL MCP pode apontar para um caminho próprio, por exemplo /api/mcp em vez de /mcp. Para uma loja WooCommerce já atrás da Cloudflare, a divisão útil é: o UCP continua a cobrir o checkout de backend nas superfícies Google, e o WebMCP na edge cobre agentes que já estão no browser do comprador - sem reescrever o tema.

Captura: Cloudflare Blog, How Commerce.com and Cloudflare are getting storefronts ready for AI agents, 21 de outubro de 2026.

#Em que difere o UCP do Agentic Commerce Protocol

O UCP tem um padrão paralelo. O Agentic Commerce Protocol (ACP) foi desenvolvido pela Stripe e pela OpenAI, é também de código aberto sob Apache 2.0 e indica o ChatGPT como a primeira plataforma de IA a implementá-lo, com o Shared Payment Token da Stripe como primeiro meio de pagamento compatível (agenticcommerce.dev). Os dois protocolos resolvem o mesmo problema para ecossistemas diferentes, por isso um comerciante que queira finalização da compra tanto nas superfícies da Google como no ChatGPT tem de planear os dois. A WPPoland publica ficheiros de descoberta para cada um: /.well-known/ucp e /.well-known/acp.json.

Atualização, 3 de novembro de 2026. A Shopify Fall ‘26 Edition coloca ferramentas WebMCP em todas as lojas Liquid e Hydrogen e no checkout: agentes de navegação podem pesquisar produtos, alterar o carrinho e concluir a compra depois de o comprador aprovar, com a mesma validação da página de checkout, e recebem dados estruturados em vez de lerem capturas de ecrã (Shopify, Fall ‘26 Edition para programadores). A mesma versão traz o Shop.dev, uma ligação única para qualquer agente ou app ao Shopify Catalog, carrinho, checkout e Shop Pay, e uma verificação de segurança de apps na Shopify CLI. Para um comerciante na Shopify esta camada fica ativa por omissão; uma loja WooCommerce tem de construir o equivalente, e é para isso que servem o perfil UCP e os passos abaixo.

Atualização, 28 de outubro de 2026. A 24 de março de 2026, a OpenAI mudou a forma como o ChatGPT usa o ACP. O Instant Checkout no ChatGPT está agora disponível apenas para parceiros aprovados, os restantes comerciantes mantêm a sua própria finalização de compra e a OpenAI afirma que se concentra em ajudar os compradores a encontrar produtos (OpenAI). Através do ACP, os comerciantes partilham agora sobretudo dados de produtos e promoções, e a integração de catálogos também está, por agora, limitada a parceiros aprovados (documentação da OpenAI para programadores). Se planeia a sua loja para os dois ecossistemas, para o ChatGPT precisa de um catálogo de produtos e de uma finalização de compra no seu próprio site que o comprador vindo do chat consiga concluir. Os endpoints de pagamento descritos neste guia continuam a ser uma tarefa do UCP, e para essa integração a Google admite comerciantes através de uma lista de espera (Google for Developers).

Em conjunto, estes protocolos formam a pilha atual do comércio agêntico:

• UCP: camada de comércio e transações (superfícies da Google e qualquer adotante)
• ACP: camada de comércio e finalização da compra no ecossistema OpenAI e Stripe
• MCP: interação com ferramentas e acesso a APIs
• A2A: comunicação entre agentes
• AP2: pagamentos por agentes e prova de consentimento
• WebMCP: ferramentas expostas por uma página no navegador

#O que a Google exige de um comerciante UCP

As perguntas frequentes da Google sobre o UCP listam requisitos operacionais que é fácil esquecer quando o ficheiro de perfil parece pronto:

• O Merchant Center continua no centro. Os feeds de produtos, os recursos da marca, as políticas de devolução e os contactos da empresa têm de estar completos e atualizados; o UCP assenta no feed de compras existente.
• O comerciante continua a ser o vendedor oficial (merchant of record). É dono da relação com o cliente e dos dados da transação, e são os seus próprios termos e condições que regem a compra e têm de ser aceites durante a finalização da compra.
• Stock em tempo real. O comerciante verifica o inventário na finalização da compra e devolve o código de erro out_of_stock quando um artigo esgotou.
• Validação de moradas. Os utilizadores podem alterar a morada de envio, o comerciante recalcula portes e impostos e devolve address_undeliverable quando não consegue enviar.
• Erros recuperáveis. Uma mensagem que o comprador consiga resolver tem de levar a severidade recoverable no array messages; caso contrário, o utilizador depara-se com um erro bloqueante.
• Pagamentos. O comerciante não precisa da Google Pay API no seu próprio site, mas o seu prestador de serviços de pagamento tem de processar os tokens da Google. Em allowed_auth_methods só se usa PAN_ONLY.
• Versões. Uma nova versão da especificação fica num endpoint separado, para que a Google possa reencaminhar o tráfego de volta se a nova falhar.
• Um perfil, vários países. Não são necessários perfis separados por país.

#Que empresas precisam do UCP

#Lojas de e-commerce

Para lojas que vendem produtos, a questão é direta. Se as ofertas concorrentes no AI Mode tiverem opção de compra direta e as suas não, o agente conclui a compra noutro lado.

Ações principais:

• Publicar um perfil UCP em /.well-known/ucp
• Manter completos os feeds do Merchant Center e o markup Schema.org (Product, Offer, PriceSpecification)
• Garantir que as APIs de disponibilidade e preços respondem em tempo real
• Testar a descoberta de produtos através de assistentes de IA

Atualização, 30 de outubro de 2026. A 29 de outubro de 2026, o Microsoft Clarity publicou uma análise de mais de 5,2 milhões de sessões com agentes de IA em 230 511 projetos Clarity, recolhidas entre 13 de agosto e 9 de setembro de 2026 (Microsoft Clarity). Uma sessão contou como agêntica quando o Clarity detetou um navegador agêntico dos ecossistemas OpenAI, Google ou Anthropic. O evento de finalização da compra surgiu em 25,21% dessas sessões, contra 14,65% nas sessões humanas, o envio de formulário em 19,85% contra 18,56% e a adição ao carrinho em 2,33% contra 3,31%. Os agentes clicaram menos em links externos (14,28% contra 26,99%). O Clarity ressalva que numa sessão de agente uma pessoa pode ter assumido o controlo e que os números não provam que o agente concluiu sozinho uma compra. O estudo também não mede conversões.

Para uma loja WooCommerce, a conclusão é que os agentes vão diretos ao checkout, por isso o checkout e os dados de produto têm de funcionar sem adivinhação:

• Manter o feed do Merchant Center igual ao que a loja mostra (preço, stock, variantes, GTIN), porque o UCP e o checkout nas superfícies da Google assentam nele.
• Gerar o markup Product e Offer da página de produto a partir dos mesmos campos do feed, para que o agente nunca veja dois preços.
• Percorrer o checkout como convidado: todos os campos com etiqueta, mensagens de erro em texto e nenhuma conta obrigatória só para ver o custo de envio.
• Medir as sessões de agentes: o Clarity disponibiliza para isso o Agent Activity Dashboard, e o tráfego UCP identifica-se nos registos do servidor pelo cabeçalho UCP-Agent.

A revisão do feed, dos dados de produto e do checkout de lojas WooCommerce faz parte do meu serviço de desenvolvimento WooCommerce, se o seu negócio precisar dela.

#Empresas de serviços

Para agências, consultores e serviços profissionais, a conta é outra. Os serviços raramente se compram num só passo: precisam de uma consulta, de um orçamento e de um âmbito acordado. A especificação UCP não tem nenhuma capacidade de pedido de informação ou de orçamento, por isso uma empresa de serviços usa o padrão para a descoberta e acrescenta-lhe os seus próprios dados:

• Usar os esquemas ProfessionalService e Offer em vez de esquemas Product
• Descrever os serviços e a forma como o preço é definido
• Declarar os fluxos de pedido de informação e de orçamento num bloco claramente personalizado (a WPPoland usa supportsInquiry e supportsQuote, que são campos próprios, não capacidades do UCP)
• Disponibilizar informação estruturada de FAQ e do processo

#Editores de conteúdo

Empresas de media e editores de conteúdo devem concentrar-se em:

• Implementar os esquemas Schema.org Article e FAQ
• Estruturar o conteúdo para citação por IA (veja o nosso guia de otimização LLMO)
• Criar dados estruturados para entidades, temas e relações

#Como implementar o UCP em cinco passos

#Passo 1: auditar os dados atuais

Antes de implementar o UCP, perceba que dados já tem:

• As páginas de produto ou de serviço têm markup Schema.org?
• O feed do Merchant Center está completo e atualizado?
• Os preços, a disponibilidade e os prazos de entrega estão estruturados ou em texto livre?

#Passo 2: publicar o perfil UCP

Siga o guia de implementação da versão que pretende suportar e publique /.well-known/ucp com os seus serviços, capacidades, processadores de pagamento e chaves de assinatura. Os comerciantes que querem finalização da compra nas superfícies da Google inscrevem-se através do formulário de interesse para comerciantes UCP indicado na documentação, e a Google anunciou um processo de adesão simplificado no Merchant Center, a disponibilizar ao longo dos próximos meses.

#Passo 3: implementar markup Schema.org

Enriqueça o seu site com dados Schema.org:

• Para produtos: esquemas Product, Offer, Brand, Review
• Para serviços: esquemas ProfessionalService, Offer, PriceSpecification
• Para ambos: esquemas Organization, ContactPoint, FAQPage

#Passo 4: criar os endpoints de finalização da compra

Implemente os serviços que declarou, começando pelo checkout. O guia passo a passo da Google usa um servidor de exemplo em Python e um SDK do UCP com dados de produtos de exemplo (uma florista de demonstração) para mostrar, do início ao fim, a descoberta, a criação da finalização da compra e um código de desconto; os SDK oficiais estão na organização Universal-Commerce-Protocol no GitHub. Para além do UCP, uma empresa de serviços pode acrescentar endpoints próprios, como /agent.json.

#Passo 5: testar e monitorizar

Depois da implementação:

• Confirme que /.well-known/ucp devolve JSON válido
• Procure nos registos do servidor o cabeçalho UCP-Agent e cadeias User-Agent que comecem por Google/UCP
• Teste os caminhos de erro (out_of_stock, address_undeliverable) antes de entrar em produção
• Pergunte aos assistentes de IA sobre os seus produtos e serviços

#Como uma empresa de serviços implementa o UCP

Sendo uma empresa de serviços e não um retalhista de produtos, a WPPoland tinha uma pergunta concreta: como publicar dados legíveis por agentes sem ter uma finalização da compra para oferecer.

O ficheiro em produção em /.well-known/ucp (também servido como /.well-known/ucp.json) responde em duas partes. O objeto ucp declara a versão 2026-04-08 com serviços e capacidades vazios, porque não é oferecida nenhuma finalização da compra UCP. Ao lado fica um bloco personalizado que descreve a empresa:

• Um perfil de comerciante com denominação social, número de IVA, morada e países servidos
• Capacidades: supportsInquiry e supportsQuote definidos como true, supportsPayment e supportsBooking definidos como false
• 8 ofertas de serviços principais
• Seis idiomas: polaco, inglês, alemão, norueguês, português e espanhol
• EUR como moeda dos orçamentos e uma política declarada de que não é publicada nenhuma tabela de preços e de que o orçamento vinculativo surge depois de um briefing escrito
• Um endpoint adicional, /agent.json, com dados dos serviços em JSON-LD

Assim, a parte normalizada fica honesta (não se declara nada que a empresa não possa fazer) e os agentes continuam a receber factos estruturados sobre a empresa.

#Como o UCP evoluiu ao longo de 2026

• 11 de janeiro de 2026: lançamento na NRF, desenvolvido em conjunto com a Shopify, a Etsy, a Wayfair, a Target e a Walmart; anúncio do native checkout no AI Mode da Pesquisa e no Gemini.
• 19 de março de 2026: capacidades opcionais Cart, Catalog e Identity Linking; adesão simplificada no Merchant Center; Commerce Inc, Salesforce e Stripe indicadas como plataformas que vão implementar o UCP.
• Abril de 2026: o guia de implementação da Google passa para a versão 2026-04-08 da especificação.
• 20 de maio de 2026 (Google Marketing Live): um Universal Cart que funciona entre retalhistas e serviços da Google, opções Affirm e Klarna dentro do Google Pay, compras a partir de promoções Direct Offers e finalização da compra com UCP a chegar ao Canadá e à Austrália e, mais tarde, ao Reino Unido. Reservas de hotel e encomendas de comida local foram anunciadas como novas categorias (Google Marketing Live 2026).

O roteiro público em ucp.dev inclui fidelização e benefícios de membro, venda cruzada e upsell nativos, percursos locais e omnicanal, mercados globais e as verticais de restauração e alojamento. O próprio roteiro afirma que “não constitui um compromisso de entregar funcionalidades específicas” (tradução própria) (roteiro do UCP).

#Como proteger uma integração UCP e cumprir o RGPD

#Identificar e verificar o tráfego de agentes

• Os pedidos UCP trazem um cabeçalho UCP-Agent com o perfil do agente e um User-Agent que começa por Google/UCP.
• A Google pode sondar os endpoints para verificar o seu estado com o User-Agent Google-UCP-Prober/1.0.
• Confirme que o tráfego é mesmo da Google com consultas de DNS inverso e os intervalos de IP publicados pela Google.
• A restrição geográfica não é suportada; em vez disso, a Google recomenda tokens OAuth 2.0 Bearer ou outras assinaturas.
• Publique as chaves de assinatura em formato JWK no perfil e faça a sua rotação como com qualquer outra chave.

#Cumprir os requisitos do RGPD

• Propriedade dos dados: o comerciante continua a ser o vendedor oficial e é dono dos dados da transação.
• Conservação: a Google guarda os dados padrão das encomendas até o utilizador pedir a eliminação; as obrigações de conservação do próprio comerciante continuam a aplicar-se aos seus sistemas.
• Remarketing: aplicam-se as regras habituais de privacidade e consentimento; a Google indica uma funcionalidade de opt-in como planeada.
• Minimização de dados: passe aos agentes apenas os dados de que a transação precisa.

#Erros comuns no UCP e como corrigi-los

#Porque é que os agentes de IA não encontram as capacidades da loja

Causas possíveis:

1. Perfil inacessível em /.well-known/ucp (404)
2. Erros de sintaxe JSON
3. Capacidades declaradas sem o endpoint de serviço correspondente

Soluções:

• Pedir o URL diretamente e verificar o código de estado
• Passar o ficheiro por um validador de JSON
• Comparar as capacidades declaradas com os endpoints que respondem de facto

#Porque é que os agentes de IA mostram preços errados

Causas possíveis:

1. Formatação errada da moeda
2. Feed e finalização da compra a devolver preços diferentes
3. Problemas de fuso horário ou de formato

Soluções:

• Usar códigos de moeda ISO 4217
• Recalcular preço, portes e impostos na finalização da compra e manter o feed atualizado
• Guardar as datas e horas em UTC

#Porque é que a finalização da compra UCP falha

Causas possíveis:

1. Artigos esgotados sem o código out_of_stock
2. Problemas resolúveis enviados sem a severidade recoverable
3. Problemas de autenticação ou um PSP que não consegue processar os tokens da Google

Soluções:

• Devolver os códigos de erro documentados
• Marcar como recuperáveis as mensagens que o comprador pode resolver
• Validar os tokens e confirmar com o prestador de pagamentos que suporta tokens

#Como preparar a loja para o comércio agêntico

A finalização da compra por agentes já funciona nas superfícies da Google, a Shopify codesenvolveu o protocolo e as plataformas de pagamento anunciaram suporte. Parte da camada de descoberta passou das páginas web para os protocolos. Quer venda produtos quer serviços, dados estruturados, completos e acessíveis aos agentes contam hoje tanto como as próprias páginas.

Para as empresas, os passos são claros:

1. Auditar as estruturas de dados e os feeds atuais
2. Publicar um perfil UCP que declare apenas o que suporta
3. Testar a descoberta pelos agentes e os caminhos de erro da finalização da compra
4. Acompanhar as versões da especificação e o roteiro público

Artigos relacionados:

• LLMO: guia técnico definitivo de otimização para bots de IA
• SEO semântico para WordPress em 2026
• Core Web Vitals: alcançar a pontuação 100/100
• Headless WordPress vs WordPress tradicional

Páginas de serviço:

• Preparação para comércio com IA: implementação do UCP
• Desenvolvimento WordPress
• Desenvolvimento WooCommerce
• Otimização de velocidade
• GEO e otimização LLMO

Recursos técnicos:

• Perfil UCP da WPPoland
• Endpoint de dados do agente
• Documentação Google UCP
• Especificação UCP