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.