Antes de qualquer protocolo, a pergunta é o que o cliente precisa ver. O AG-UI leva esse andamento para a tela, mas quem decide as etapas é o produtor. Este tutorial monta esse mapa.
Passo 1: liste o caminho da compra
Escreva o caminho do cliente, do primeiro pedido até o acesso ao curso. Um exemplo: consultar o curso, conferir o preço, confirmar a compra, liberar o acesso.
Passo 2: escolha as etapas visíveis
Nem toda etapa precisa aparecer. Escolha as que levam tempo ou que podem falhar. Para o cliente, a espera mais longa costuma ser a consulta do preço e a confirmação.
Passo 3: escreva o texto de cada etapa
Cada etapa precisa de uma frase curta, em linguagem simples. Por exemplo: "Conferindo o preço do curso". Evite termos técnicos.
Passo 4: defina o erro
Para cada etapa, escreva o que o cliente vê se ela falhar. Uma boa mensagem diz o que aconteceu e o que fazer em seguida. Uma mensagem vaga gera o pedido de suporte.
Passo 5: defina o fim
Escreva o que aparece quando a etapa termina e quando a compra termina. Se o cliente precisar pagar numa página, diga isso antes.
Passo 6: teste com uma pessoa
Peça a uma pessoa que nunca viu o fluxo para seguir o roteiro. Anote onde ela para ou pergunta. Ajuste o texto nesses pontos.
Como a Wortic faz
A Wortic tem o começo do fluxo para o AG-UI na negociação entre agentes, mas a rota ainda não está no ar. Por enquanto, o acompanhamento é feito pelo registro da tarefa.
A documentação oficial está em docs.ag-ui.com.
Passo 7: defina o texto de cada etapa de erro
Para cada etapa da lista, escreva o texto de erro. Diga o que aconteceu e o que a pessoa pode fazer, em uma frase. Um erro com texto vago gera uma nova mensagem ao suporte.
Passo 8: confirme o fim da compra
Defina o texto que aparece quando a compra termina e o que o aluno recebe depois. Se o acesso demora, diga quanto tempo. Um fim sem explicação deixa o aluno sem saber se o pagamento foi confirmado.
Passo 9: revise com o suporte
Leve o roteiro de etapas ao time de suporte. Eles conhecem as dúvidas que chegam e podem apontar o passo que costuma gerar confusão. Ajuste o texto antes de publicar.
Passo 10: teste com o caminho mais longo
Escolha a compra que tem mais etapas e cronometre o tempo de cada uma. Se alguma etapa passar de alguns segundos sem texto na tela, adicione uma frase de andamento. Esse teste mostra o ponto em que o cliente costuma desistir.
Guarde o roteiro com a data da revisão. Quando você mudar o produto ou a página, refaça o teste. Um texto de etapa que estava certo no mês passado pode não bater mais com a tela de hoje.