Pular para o conteúdo
jsonW Paper GitHub

Protocolos de comércio com agentes

AP2: o mandato de compra e o estado da negociação no jsonW

O AP2 registra o que a pessoa autorizou o agente a comprar. Na Wortic, o limite, o prazo e a validade do mandato entram numa negociação guardada em jsonW. Veja o que o protocolo prevê, quais campos a casa usa e o que ainda não está no ar.

· jsonW 1.3.11

O protocolo

O AP2 é um protocolo para pagamentos feitos por agentes. O seu centro é o mandato, um documento assinado pela pessoa. O mandato diz o que o agente pode comprar, até qual valor, em qual prazo e até quando vale. O protocolo separa o consentimento do pagamento. O pagamento segue pelo meio que a loja usa.

O mandato como dado

Na prática, o mandato é um conjunto de campos. A Wortic usa um resumo dele dentro da negociação entre agentes. O resumo traz quatro informações: o preço limite, o prazo limite em dias, a quantidade e a data até a qual o mandato vale.

O código de entrada confere esses campos. O preço é lido como texto com duas casas decimais, como "1100.00". Assim, o sistema nunca interpreta um número com vírgula. Um mandato sem data futura é recusado.

Onde o estado fica

A negociação guarda o seu estado em jsonW vivo. Isso quer dizer que cada proposta, aceite ou recusa entra como uma atualização do registro. As duas partes leem a mesma proposta vigente. Quem consulta só vê o que é da sua própria parte da negociação.

// o estado da negociação: quem propôs, o que foi proposto e o que está vigente

O registro é o do acordo em andamento. Ele não substitui o pedido. Quando o comprador aceita dentro do teto do mandato dele, o acordo vira pedido pelas funções do banco de checkout.

Teto e limite

O preço máximo que o comprador aceita vem do mandato dele, e não do vendedor. Essa regra evita que um vendedor empurre um valor acima do autorizado. O teto que vale é sempre o do mandato do comprador.

O que não está no ar

O comprador autônomo ainda não está no ar. A verificação do mandato está no hub da casa, mas um agente comprador completo ainda está em preparação.

Como conferir o registro

Para auditar um acordo, leia o estado de cada parte e o mandato gravado. Compare o preço final com o teto. Se o acordo passou do teto, há um erro no fluxo, e não uma condição de negócio.

Por que vale guardar o mandato junto

Se a compra for contestada, a empresa precisa mostrar quem autorizou e até quanto. Guardar o mandato junto da negociação evita a busca em dois lugares. A resposta sai de um registro só.

O repositório oficial do protocolo está em github.com/google-agentic-commerce/AP2.

Campos que a casa confere

Um mandato no registro traz o teto, o prazo, a quantidade e a validade. Cada campo é conferido na entrada. Um valor fora do formato, como um preço com vírgula, é recusado antes de virar registro. Assim, o estado não recebe um número que o sistema não consegue comparar.

O jsonW exige que o esquema esteja declarado no cabeçalho do arquivo. Quem lê o arquivo sabe o significado de cada coluna sem adivinhar.

Repositório oficial do AP2 (Google, GitHub) →