Como integrar o Protocolo de Comércio Common (UCP) com Agentes de IA?

A navegação agente está rapidamente se tornando well-liked.

As pessoas não querem apenas que os agentes de IA pesquisar mais produtos. Eles querem que os agentes realmente comprem coisas para eles: comparem opções, façam pedidos, administrem pagamentos e concluam toda a transação.

Foi aí que as coisas começaram a quebrar.

A pilha de comércio de hoje está fragmentada. Cada comerciante, plataforma e provedor de pagamento usa integrações proprietárias. Assim, mesmo que um agente seja suficientemente inteligente para tomar decisões, terá dificuldade em agir em grande escala porque não tem uma forma comum de comunicar com estes sistemas.

Essa é exatamente a lacuna que o Protocolo de Comércio Common (UCP) do Google foi projetado para corrigir.

UCP cria uma maneira padronizada e segura para Agentes de IA, comerciantes, plataformas e provedores de pagamento se comuniquem. Em vez de criar integrações personalizadas para cada loja ou serviço, os agentes podem interagir com sistemas de comércio por meio de um protocolo compartilhado, tornando as compras orientadas pelos agentes finalmente práticas, interoperáveis ​​e escaláveis.

O que é o Protocolo de Comércio Common (UCP)?

O Protocolo de Comércio Common é um padrão de comércio aberto que conecta agentes digitais a sistemas de comércio. Ele fornece uma estrutura comum para descobrir produtos, gerenciar carrinhos, executar pagamentos e lidar com tarefas pós-compra. A UCP não substitui plataformas de comércio eletrônico ou sistemas de pagamento existentes. Em vez disso, atua como uma linguagem compartilhada que permite que agentes, aplicativos, comerciantes e provedores de pagamento de IA interajam sem problemas.

A ideia central por trás do UCP

O UCP é uma solução principalmente para um desafio de integração. No passado, cada assistente ou plataforma de IA dependia de integrações exclusivas com cada comerciante ou sistema de comércio. Este método não period escalonável.

• Um conjunto uniforme de ações comerciais
• Definições de funções inequívocas para agentes, comerciantes e processadores de pagamento
• Esquemas flexíveis aplicáveis ​​em todos os setores
• Este método de trabalho reduz drasticamente a necessidade de engenharia e, ao mesmo tempo, permite inovações mais rápidas

Por que a UCP é importante?

O ecossistema de comércio eletrônico atual é altamente fragmentado. Cada canal de compras, como websites, aplicativos móveis e plataformas de terceiros, requer integrações personalizadas com cada comerciante. Como resultado, um retalhista que vende através de múltiplos canais deve gerir muitas integrações complexas. Esse desafio cresce à medida que os agentes de compras com IA se tornam uma forma comum de as pessoas fazerem compras.

A UCP resolve isso introduzindo um protocolo padrão único que cobre toda a jornada de compra, desde a descoberta do produto até a finalização da compra e gerenciamento de pedidos. Isso simplifica as integrações e permite que o ecossistema obtenha vários benefícios importantes.

• Integração unificada: Reduz integrações comerciais N×N complexas a um único ponto de integração para agentes e interfaces de IA.
• Idioma compartilhado: Outline esquemas e APIs comuns para que todos os sistemas de comércio possam se comunicar de forma consistente de ponta a ponta.
• Design extensível e modular: Usa componentes modulares que podem evoluir sem quebrar as integrações existentes.
• Abordagem que prioriza a segurança: Garante pagamentos seguros e tokenizados com consentimento verificado do usuário para cada transação.

Para os clientes, isso significa interações mais tranquilas e menos carrinhos abandonados. Os compradores podem passar rapidamente da navegação ou do bate-papo até a conclusão de uma compra, muitas vezes sem inserir novamente os detalhes. Como explica o Google, o UCP foi projetado para que os consumidores possam pagar com segurança usando o Google Pay, com as informações de pagamento e envio já salvas na Google Pockets.

Leia também: As 10 principais extensões Agentic AI do Chrome

Por que o Google introduziu o UCP?

O comércio migrou lenta mas seguramente para o domínio do chat e dos robôs. Hoje os utilizadores exigem que os sistemas de IA atuem em vez de apenas informar. O Google lançou o UCP para liderar essa mudança, mantendo as portas abertas e o ecossistema estável. Comércio agente é o termo usado para sistemas de IA que são capazes de realizar trabalhos comerciais de forma independente. Esses agentes são capazes de:

• Procure e avalie produtos
• Ajuste a seleção de acordo com o gosto do usuário
• Execute compras com segurança
• Lidar com devoluções, reembolsar e oferecer suporte

Como funciona o Protocolo de Comércio Common (UCP)?

O UCP funciona dividindo a jornada comercial em uma sequência clara de ações que os agentes de IA podem seguir. Cada etapa representa uma interação específica, desde a descoberta de um produto até a conclusão da transação e o tratamento do que vem a seguir. Juntas, essas etapas definem como um agente realiza uma compra de maneira controlada e previsível. Vamos analisar isso e examinar cada etapa individualmente:

Etapa 1: configurar o servidor comercial e adicionar produtos de amostra à sua loja

Para facilitar a instalação e o funcionamento das empresas, o Google criou um repositório de exemplos. O repositório contém um servidor Python que está pronto para ser usado para hospedar APIs de negócios, juntamente com um SDK UCP que fornece dados de produtos de amostra e implementações de referência. Esses componentes trabalham juntos para ajudar o usuário a visualizar e compreender como um servidor de negócios compatível com UCP pode ser configurado e testado.

Configurando o servidor de negócios:

mkdir sdk
git clone https://github.com/Common-Commerce-Protocol/python-sdk.git sdk/python
pushd sdk/python
uv sync
popd
git clone https://github.com/Common-Commerce-Protocol/samples.git 
cd samples/relaxation/python/server
uv sync

Usando uma floricultura como exemplo, o Google desempenha o papel de empresa para fins de demonstração. Além disso, fornecemos um banco de dados de produto simples baseado em SQLite que contém os dados do catálogo para o ambiente de demonstração que são iguais aos dados de amostra. Essa configuração permite que os desenvolvedores usem informações realistas do produto para testar fluxos de trabalho UCP sem a necessidade de um banco de dados de produção completo.

Passo 2: Put together seu servidor comercial para aceitar solicitações de agentes

Em seguida, inicie o servidor de negócios que hospeda as APIs de negócios na porta 8182 e conecte-se ao banco de dados do produto de demonstração. O servidor é executado em segundo plano para que aplicativos clientes e agentes de IA possam se conectar sem interrupção. Execute o comando abaixo para iniciar o servidor de negócios:

uv run server.py  
--products_db_path=/tmp/ucp_test/merchandise.db  
--transactions_db_path=/tmp/ucp_test/transactions.db  
--port=8182 & 
SERVER_PID=$! 

Etapa 3: Descubra recursos de negócios com seu agente

As empresas expõem um manifesto JSON em /.well-known/ucp que lista seus serviços e capacidades disponíveis. Isso permite que os agentes de IA descubram recursos, endpoints e configurações de pagamento de forma dinâmica, sem depender de integrações codificadas.

Agora execute o seguinte comando para permitir que seu agente descubra os serviços e recursos de negócios:

export SERVER_URL=http://localhost:8182 
export RESPONSE=$(curl -s -X GET $SERVER_URL/.well-known/ucp) 
echo $RESPONSE 
Response:  
{ 
"ucp": { 
"model": "2026-01-11", 
"companies": { "dev.ucp.procuring": { "model": "2026-01-11", "spec": "https://ucp.dev/specs/procuring", "relaxation": { "schema": "https://ucp.dev/companies/procuring/openapi.json", "endpoint": "http://localhost:8182/" } } }, 
"capabilities": ( 
{ "title": "dev.ucp.procuring.checkout", "model": "2026-01-11", "spec": "https://ucp.dev/specs/procuring/checkout", "schema": "https://ucp.dev/schemas/procuring/checkout.json" }, 
{ "title": "dev.ucp.procuring.low cost", "model": "2026-01-11", "spec": "https://ucp.dev/specs/procuring/low cost", "schema": "https://ucp.dev/schemas/procuring/low cost.json", "extends": "dev.ucp.procuring.checkout" }, 
{ "title": "dev.ucp.procuring.success", "model": "2026-01-11", "spec": "https://ucp.dev/specs/procuring/success", "schema": "https://ucp.dev/schemas/procuring/success.json", "extends": "dev.ucp.procuring.checkout" } 
) 
}, 
"fee": { 
"handlers": ( 
{ "id": "shop_pay", "title": "com.shopify.shop_pay", "model": "2026-01-11", "spec": "https://shopify.dev/ucp/handlers/shop_pay", "config_schema": "https://shopify.dev/ucp/handlers/shop_pay/config.json", "instrument_schemas": ( "https://shopify.dev/ucp/handlers/shop_pay/instrument.json" ), "config": { "shop_id": "d124d01c-3386-4c58-bc58-671b705e19ff" } }, 
{ "id": "google_pay", "title": "google.pay", "model": "2026-01-11", "spec": "https://instance.com/spec", "config_schema": "https://instance.com/schema", "instrument_schemas": ( "https://ucp.dev/schemas/procuring/sorts/gpay_card_payment_instrument.json" 
), "config": { "api_version": 2, "api_version_minor": 0, "merchant_info": { "merchant_name": "Flower Store", "merchant_id": "TEST", "merchant_origin": "localhost" }, "allowed_payment_methods": ( { "sort": "CARD", "parameters": { "allowedAuthMethods": ( "PAN_ONLY", "CRYPTOGRAM_3DS" ), "allowedCardNetworks": ( "VISA", "MASTERCARD" ) }, "tokenization_specification": ( { "sort": "PAYMENT_GATEWAY", "parameters": ( { "gateway": "instance", "gatewayMerchantId": "exampleGatewayMerchantId" } ) } ) } ) } }, 
{ "id": "mock_payment_handler", "title": "dev.ucp.mock_payment", "model": "2026-01-11", "spec": "https://ucp.dev/specs/mock", "config_schema": "https://ucp.dev/schemas/mock.json", "instrument_schemas": ( "https://ucp.dev/schemas/procuring/sorts/card_payment_instrument.json" ), "config": { "supported_tokens": ( "success_token", "fail_token" ) } } 
) 
} 
} 

Etapa 4: Invoque um recurso de checkout com seu agente

Execute este comando para que seu agente crie uma sessão de checkout com os produtos de amostra:

export RESPONSE=$(curl -s -X POST "$SERVER_URL/checkout-sessions" -H 'Content material-Sort: utility/json' -H 'UCP-Agent: profile="https://agent.instance/profile"' -H 'request-signature: take a look at' -H 'idempotency-key: 0b50cc6b-19b2-42cd-afee-6a98e71eea87' -H 'request-id: 6d08ae4b-e7ea-44f4-846f-d7381919d4f2' -d '{"line_items":({"merchandise":{"id":"bouquet_roses","title":"Purple Rose"},"amount":1}),"purchaser":{"full_name":"John Doe","e mail":"(e mail protected)"},"foreign money":"USD","fee":{"devices":(),"handlers":({"id":"shop_pay","title":"com.shopify.shop_pay","model":"2026-01-11","spec":"https://shopify.dev/ucp/handlers/shop_pay","config_schema":"https://shopify.dev/ucp/handlers/shop_pay/config.json","instrument_schemas":("https://shopify.dev/ucp/handlers/shop_pay/instrument.json"),"config":{"shop_id":"d124d01c-3386-4c58-bc58-671b705e19ff"}},{"id":"google_pay","title":"google.pay","model":"2026-01-11","spec":"https://instance.com/spec","config_schema":"https://instance.com/schema","instrument_schemas":("https://ucp.dev/schemas/procuring/sorts/gpay_card_payment_instrument.json"),"config":{"api_version":2,"api_version_minor":0,"merchant_info":{"merchant_name":"Flower Store","merchant_id":"TEST","merchant_origin":"localhost"},"allowed_payment_methods":({"sort":"CARD","parameters":{"allowedAuthMethods":("PAN_ONLY","CRYPTOGRAM_3DS"),"allowedCardNetworks":("VISA","MASTERCARD")},"tokenization_specification":({"sort":"PAYMENT_GATEWAY","parameters":({"gateway":"instance","gatewayMerchantId":"exampleGatewayMerchantId"})})})}},{"id":"mock_payment_handler","title":"dev.ucp.mock_payment","model":"2026-01-11","spec":"https://ucp.dev/specs/mock","config_schema":"https://ucp.dev/schemas/mock.json","instrument_schemas":("https://ucp.dev/schemas/procuring/sorts/card_payment_instrument.json"),"config":{"supported_tokens":("success_token","fail_token")}})}}') && echo $RESPONSE 

Assim que a sessão de checkout for criada, seu agente terá acesso a um ID de checkout emitido pelo servidor que pode ser usado posteriormente para fazer atualizações na sessão de checkout:

RESPONSE: 
{ 
"ucp": { "model": "2026-01-11", "capabilities": ( { "title": "dev.ucp.procuring.checkout", "model": "2026-01-11" } ) }, 
"id": "cb9c0fc5-3e81-427c-ae54-83578294daf3", 
"line_items": ( { 
"id": "2e86d63a-a6b8-4b4d-8f41-559f4c6991ea", 
"merchandise": { "id": "bouquet_roses", "title": "Bouquet of Purple Roses", "value": 3500 }, 
"amount": 1, 
"totals": ( { "sort": "subtotal", "quantity": 3500 }, { "sort": "whole", "quantity": 3500 } ) 
} ), 
"purchaser": { "full_name": "John Doe", "e mail": "(e mail protected)" }, 
"standing": "ready_for_complete", 
"foreign money": "USD", 
"totals": ( { "sort": "subtotal", "quantity": 3500 }, { "sort": "whole", "quantity": 3500 } ), 
"hyperlinks": (), 
"fee": { "handlers": (), "devices": () }, 
"reductions": {} 
} 

Etapa 5: aplique descontos à solicitação de checkout com seu agente

Execute este comando para permitir que seu agente aplique descontos à sessão de checkout, usando o ID de checkout da etapa anterior:

export CHECKOUT_ID=$(echo $RESPONSE | jq -r '.id') && export LINE_ITEM_1_ID=$(echo $RESPONSE | jq -r '.line_items(0).id') && export RESPONSE=$(curl -s -X PUT "$SERVER_URL/checkout-sessions/$CHECKOUT_ID" -H 'Content material-Sort: utility/json' -H 'UCP-Agent: profile="https://agent.instance/profile"' -H 'request-signature: take a look at' -H 'idempotency-key: b9ecd4b3-0d23-4842-8535-0d55e76e2bad' -H 'request-id: 28e70993-e328-4071-91de-91644dc75221' -d "{"id":"$CHECKOUT_ID","line_items":({"id":"$LINE_ITEM_1_ID","merchandise":{"id":"bouquet_roses","title":"Purple Rose"},"amount":1}),"foreign money":"USD","fee":{"devices":(),"handlers":()},"reductions":{"codes":("10OFF")}}") && echo $RESPONSE | jq 

Seu agente receberá a seguinte resposta com o desconto aplicado:

RESPONSE:  
{ 
"ucp": { "model": "2026-01-11", "capabilities": ( { "title": "dev.ucp.procuring.checkout", "model": "2026-01-11" } ) }, 
"id": "cb9c0fc5-3e81-427c-ae54-83578294daf3", 
"line_items": ( { 
"id": "2e86d63a-a6b8-4b4d-8f41-559f4c6991ea", 
"merchandise": { "id": "bouquet_roses", "title": "Bouquet of Purple Roses", "value": 3500 }, 
"amount": 1, 
"totals": ( { "sort": "subtotal", "quantity": 3500 }, { "sort": "whole", "quantity": 3500 } ) } ), 
"purchaser": { "full_name": "John Doe", "e mail": "(e mail protected)" }, 
"standing": "ready_for_complete", 
"foreign money": "USD", 
"totals": ( { "sort": "subtotal", "quantity": 3500 }, { "sort": "low cost", "quantity": 350 }, { "sort": "whole", "quantity": 3150 } ), 
"hyperlinks": (), 
"fee": { "handlers": (), "devices": () }, 
"reductions": { 
"codes": ( "10OFF" ), 
"utilized": ( { "code": "10OFF", "title": "10% Off", "quantity": 350, "computerized": false, "allocations": ( { "path": "subtotal", "quantity": 350 } ) } ) 
} 
} 

Componentes principais do protocolo de comércio common

Um servidor UCP, que geralmente é o backend do comerciante, revela um ou mais serviços. Cada serviço corresponde a capacidades específicas que podem ser distinguidas entre áreas funcionais como descoberta de produto ou checkout. Exemplos comuns incluem ucp.procuring.catalog, ucp.procuring.checkout e ucp.procuring.orders. Os comerciantes optam pelos recursos de que necessitam, enquanto os agentes de IA se comunicarão com os comerciantes de acordo com os recursos habilitados.

Capacidades de um serviço principal

Extensões: Os recursos também permitem o uso de extensões para fornecer funções especializadas. As extensões oferecem aos comerciantes a opção de adicionar recursos como descontos em cupons ou métodos sofisticados de atendimento sem a necessidade de alterar os esquemas primários.

Descoberta

Cada empresa habilitada para UCP fornece um manifesto em https:///.conhecido/ucp. Isso fornece uma lista dos serviços disponíveis, recursos suportados, terminais de API, versões possíveis, extensões e detalhes sobre os manipuladores de pagamento.

Transportes

A UCP não está restrita a um transporte específico. As mesmas cargas de capacidade podem ser movidas por REST, JSON RPC ou protocolos nativos de agente, como Mannequin Context Protocol (MCP) e Agent2Agent (A2A), ou até mesmo protocolos não nativos.

Pagamentos

O UCP está integrado a vários provedores de pagamento por meio de seus manipuladores de pagamento conectáveis, que incluem Stripe, Google Pay e Store Pay. Os tokens de pagamento são criptografados e roteados durante a finalização da compra.

Juntos, esses fatores capacitam a UCP a converter diálogos de compras de IA em transações reais. A transação regular é a seguinte:

1. O agente obtém o manifesto UCP do comerciante
2. Determina os recursos relevantes (por exemplo, checkout)
3. Ele chama essas APIs junto com os detalhes do pedido do comprador e escolhe um gerenciador de pagamento
4. A UCP cuida de todo o resto (contando quaisquer descontos ou opções de atendimento que foram discutidas)

Benefícios para o ecossistema comercial

• Varejistas e Comerciantes: O UCP permite que os comerciantes vendam em superfícies de compras baseadas em IA sem perder o controle sobre a marca, os dados ou o checkout. Eles permanecem como comerciantes registrados enquanto alcançam os usuários por meio do modo IA da Pesquisa Google, chatbots e assistentes de voz usando uma única integração.
• Plataformas e agentes de IA: Plataformas de IA como Google AI Mode, Gemini e Microsoft Copilot podem oferecer recursos de comércio sem criar integrações personalizadas para cada varejista. Uma API unificada acelera a integração do comerciante e permite o comércio escalonável conduzido pelo agente.
• Desenvolvedores: O UCP é de código aberto e amigável ao desenvolvedor, com documentação clara, SDKs e implementações de referência. Os desenvolvedores podem criar usando ferramentas familiares como REST e JSON e adotar apenas os recursos necessários.
• Provedores de pagamento: Os provedores de pagamento podem integrar-se uma vez e trabalhar com muitos comerciantes usando o fluxo de pagamento modular e tokenizado da UCP. Isso elimina a necessidade de integrações específicas da plataforma.
• Consumidores: O UCP permite que os usuários naveguem e comprem diretamente por meio de assistentes de IA, sem alternar entre aplicativos ou websites, criando uma experiência de compra mais rápida e integrada.

Conclusão

O Protocolo de Comércio Common poderia remodelar o comércio digital na period da IA. Ele reúne agentes, comerciantes e pagamentos de IA em um único padrão, preservando o controle do comerciante e permitindo compras perfeitas por chat, pesquisa e voz. À medida que os assistentes de IA influenciam mais decisões de compra, a UCP pretende manter o comércio aberto, seguro e escalável.

Qual a sua opinião sobre compras orientadas por agentes? Compartilhe suas idéias nos comentários abaixo.

Olá! Sou Vipin, um entusiasta apaixonado por ciência de dados e aprendizado de máquina, com uma sólida base em análise de dados, algoritmos de aprendizado de máquina e programação. Tenho experiência prática na construção de modelos, gerenciamento de dados confusos e solução de problemas do mundo actual. Meu objetivo é aplicar insights baseados em dados para criar soluções práticas que gerem resultados. Estou ansioso para contribuir com minhas habilidades em um ambiente colaborativo enquanto continuo aprendendo e crescendo nas áreas de Ciência de Dados, Aprendizado de Máquina e PNL.