Antes de aceitar uma compra feita por agente, você precisa de uma regra por escrito: o que o agente pode comprar, até qual valor, por quanto tempo e com quem a responsabilidade fica. Este tutorial monta essa regra. O formato técnico vem do AP2, e a parte jurídica deve ser revisada por um advogado.
Passo 1: defina o que pode ser comprado
Liste os produtos que o agente pode comprar. Para um curso, cada item é um produto com nome, versão e preço. Deixe de fora qualquer produto que exija conversa com a equipe, como turmas com vagas limitadas.
Passo 2: defina o limite de preço
Escolha um teto por compra. O teto é o valor máximo que o aluno aceita pagar. Ele não deve ser maior que o preço do produto mais caro da lista. Um teto alto demais é uma porta aberta para disputa.
Passo 3: defina o prazo
Todo mandato precisa de uma data limite. Depois dela, o mandato não vale. Um prazo curto, como alguns dias, reduz o risco. Um prazo longo exige que o aluno tenha uma forma de revogar.
Passo 4: escolha o modo
O AP2 separa o aluno presente do aluno ausente. Se a compra acontece na conversa, com a pessoa confirmando, o modo é o de presença. Se o agente compra depois, sem a pessoa ali, o mandato precisa cobrir a compra antes. Comece pelo modo de presença, que tem menos risco.
Passo 5: guarde a autorização
Guarde o mandato com data, hora, produto, teto e prazo. Guarde também a versão do protocolo usada. Quando um aluno contestar, esse registro é a sua prova.
Passo 6: teste a recusa
Antes de liberar, teste dois casos. Um pedido acima do teto deve ser recusado. Um pedido depois do prazo também deve ser recusado. Se algum dos dois passar, a regra está errada.
Passo 7: alinhe com o reembolso
O mandato prova a autorização. Ele não substitui a sua política de reembolso. Escreva a regra de reembolso na página de compra e na resposta do agente.
O que não fazer
Não aceite compra sem mandato só porque o assistente disse que o aluno aprovou. Não use o mandato como garantia de que o produto será entregue. Ele é uma prova de consentimento.
O repositório oficial está em github.com/google-agentic-commerce/AP2.
Passo 8: escreva o texto de atendimento
Crie um texto curto para o atendimento explicar o mandato. Ele deve dizer o que o aluno autorizou, até qual valor, até quando, e onde ele pode cancelar. Uma resposta igual para todo mundo evita que cada atendente invente uma regra.
Passo 9: revise com o contador
Leve o modelo de mandato ao contador e ao jurídico antes de liberar qualquer compra por agente. Eles conferem se a guarda da autorização e o prazo de retenção atendem à sua operação. Essa etapa é de negócio, e não é coberta pelo protocolo.
