Um assistente que compra com ACP lê o seu catálogo e cria uma sessão. Se o catálogo estiver errado, o assistente repete o erro com confiança. Este tutorial prepara o feed e testa a sessão antes de liberar.
Passo 1: revise o catálogo
Abra o catálogo e confira cada produto. Nome, descrição, preço, moeda e disponibilidade devem estar iguais à página de vendas. Produto sem preço claro deve sair do feed.
Passo 2: confira a descrição
A descrição é o que o assistente vai ler para explicar o produto ao aluno. Escreva o que o aluno aprende, para quem é e o que não está incluso. Evite texto de marketing sem informação.
Passo 3: confira o prazo do carrinho
Toda sessão tem um vencimento. Defina quanto tempo o carrinho fica aberto antes de expirar. Para produto digital, um prazo curto basta.
Passo 4: teste uma sessão completa
Crie uma sessão de teste com um produto de baixo valor. Confira o estado devolvido. Se o estado pedir a ação da pessoa, siga o endereço de continuação até a página do carrinho, e confira que ela abre.
Passo 5: cancele a sessão de teste
Depois do teste, cancele a sessão. Confira se o cancelamento devolve o estado de cancelado. Uma sessão aberta esquecida pode confundir o registro.
Passo 6: confira a versão
O ACP tem versão de referência, e a documentação ainda é beta. Anote a versão que você testou. Se a especificação mudar, o teste precisa ser refeito.
Erros comuns
O primeiro erro é o preço diferente entre o feed e a página. O segundo é o endereço de continuação que não abre. O terceiro é a sessão de teste esquecida aberta.
O que o aluno deve ouvir
Se o aluno disser "comecei a compra e não terminou", a resposta é mostrar o endereço para concluir. Deixe essa resposta escrita para o atendimento.
O site oficial está em agenticcommerce.dev, e o repositório, no GitHub.
Passo 7: escreva a frase de atendimento
Prepare uma frase para quem pergunta "comecei a compra e não terminou". A resposta é que a compra só termina na página do carrinho, e o endereço deve estar na frase. Deixe a frase no painel de atendimento, para qualquer pessoa da equipe usar.
Passo 8: monitore o feed
Quando o catálogo mudar, refaça o teste de sessão. Um preço que muda sem o feed acompanhar gera uma compra errada. Crie o hábito de revisar o feed sempre que mudar o preço de um produto.
Passo 9: teste com cancelamento e com expiração
Crie outra sessão de teste e deixe que ela expire, sem concluir. Confira que o estado devolvido é o de encerrada. Uma sessão expirada que continua aceitando pagamento é um erro que precisa ser corrigido antes da venda.
