Aprendizados do assistente

A loja pode ter um assistente de IA que atende clientes em conversas (por exemplo, no WhatsApp e no chat da mini-loja). Esse assistente erra de vez em quando: promete um prazo que não existe, oferece um botão que já foi enviado, lista só parte de uma linha de produtos. O ciclo de aprendizado observa esses erros nas conversas da própria loja, agrupa os que se repetem e escreve uma lição: uma regra curta em linguagem natural ("nunca prometa prazo que não esteja no pedido").

Antes de valer, a lição é testada contra casos reais. Se passou, ela espera a sua aprovação (a menos que a loja tenha a aprovação automática ligada). Lição ativa passa a orientar o assistente. Esta seção da API é a fila de aprovação e o painel de métricas desse ciclo.

Como funciona

Cada ação só vale em certos estados: aprovar só a partir de pending_approval; rejeitar a partir de candidate, testing ou pending_approval; desativar só a partir de active. Fora disso a resposta é 409.

Conceitos-chave

Aprovação automática

O campo auto_promote (na lista e nas métricas) diz se a loja está configurada para ativar sozinha as lições que passam no teste. É uma configuração da plataforma, somente leitura aqui. Com ela ligada, quase nada chega a pending_approval.

Quem vê e quem age

Uma conta de administrador da loja vê as lições da loja e as globais. Só a equipe da plataforma (conta root_admin) aprova, rejeita ou desativa lições globais; para as demais, a resposta é 403.

Endpoints

Erros comuns

• Tratar o id da lição como UUID. É um inteiro; texto dá 400 invalid id.
• Tentar aprovar uma lição que já está ativa. Dá 409 action not allowed in this status.
• Tentar administrar uma lição global com conta de loja. Dá 403 only a platform admin manages global lessons. Confira can_manage antes de mostrar um botão.
• Esperar que run termine na chamada. Ele só dispara o ciclo em segundo plano (202); acompanhe em metrics.
• Chamar run duas vezes seguidas. A segunda dá 409 enquanto a primeira roda.

Próximos passos