Conhecimento do assistente

O assistente automático do WhatsApp responde bem sobre produtos porque lê o catálogo. Para o resto (prazo de troca, formas de pagamento, horário, garantia) ele precisa de texto escrito pela loja. Esta seção documenta as duas fontes que o seller alimenta pela API:

• Base de conhecimento (knowledge base, KB): textos curtos com título e conteúdo, como um FAQ. O assistente busca o trecho mais parecido com a pergunta do cliente e responde com base nele.
• Dicionário de marcas (brand corrections): pares "como o cliente escreve" para "como o produto se chama". Faz o assistente entender adidaz como adidas, antes de buscar no catálogo.

Como funciona

Como a base de conhecimento é usada

Ao criar ou alterar uma entrada com a IA configurada, a plataforma calcula um vetor (embedding): uma lista de números que representa o significado do texto. Na busca, a pergunta do cliente também vira vetor e a plataforma devolve as entradas mais próximas. has_embedding na resposta diz se a entrada já tem vetor. Entradas sem vetor ainda aparecem na busca por texto simples (source: "ilike").

Estados de uma entrada

Ids

Ids de entrada e de par do dicionário são UUID em string.

Endpoints

Auth: Seller é um usuário do painel do seller (Authorization: Bearer $TOKEN).

Erros comuns

• Escrever a entrada como um texto enorme. Prefira várias entradas curtas, uma por assunto. O trecho devolvido é a entrada inteira.
• Esperar busca por significado sem a chave de IA. Sem ela, search só acha palavras que aparecem no texto, e regenerate responde 503.
• Mandar tags na alteração sem querer. Em PATCH/PUT, enviar tags troca a lista inteira; para manter, não envie o campo.
• Achar que POST /brand-corrections sempre cria. Se a grafia errada (em minúsculas) já existe para o seller, o par é atualizado e a resposta continua 201.
• Confiar em ids no regenerate. O campo é aceito mas hoje não limita a reconstrução.
• Usar o vendor_id do corpo. Para sellers ele é ignorado: vale sempre o do token.

Próximos passos