adicionar_item
ChatGPTUse quando o usuário pedir para anotar, guardar ou adicionar algo à lista de compras, ao mercado ou à despensa ("anota aí leite", "põe café na lista", "preciso lembrar de comprar sabonete"). Canonicaliza o produto, adiciona à lista e devolve a marca que a pessoa costuma comprar. texto é o o quê (sabonete, café), não a marca. Confirme em linguagem natural. Não mostre o codigo LIS-….
ajustar_preferencia
ChatGPTUse quando o usuário disser qual marca, tipo ou quantidade prefere ("agora eu prefiro café Três Corações", "meu leite é sempre o integral"). Grava a preferência como evidência de peso máximo: o que o usuário diz vale mais que o histórico de compras.
apagar_meus_dados
ChatGPTUse só quando o usuário pedir explicitamente para apagar todos os seus dados no Dispensa. Nunca para remover um item (use remover_item). Apaga todas as linhas deste usuário; produtos globais ficam. Confirme com o usuário antes de enviar confirmar=true.
corrigir_compra
ChatGPTUse quando o usuário disser que uma compra registrada está errada ("não era Pilão, era Melitta", "o total foi outro", "a data está errada"). Conserta a transcrição e realimenta o motor; a correção é evidência de peso máximo. Pegue o codigo CMP-… em ver_historico; nunca o mostre ao usuário.
exportar_meus_dados
ChatGPTUse quando o usuário pedir uma cópia de todos os seus dados no Dispensa ("exporta meus dados", "quero um backup das minhas compras"). Exporta lista, compras, preferências e ajustes deste usuário.
o_que_esta_faltando
ChatGPTUse quando o usuário perguntar o que falta comprar ou o que está acabando em casa ("o que preciso comprar?", "o que falta no mercado?", "vou ao mercado, o que levo?"). Cruza frequência, última compra e quantidade típica. Devolve probabilidade e evidência, não uma lista seca.
ping_despensa
ChatGPTUse só para diagnóstico técnico do Dispensa, quando o usuário pedir para testar a conexão ou ver o estado da conta. Não use para pedidos de compra. Devolve contadores, versão do motor de preferência e estado do perfil.
registrar_compra
ChatGPTUse quando o usuário mandar a foto do cupom fiscal / nota do mercado, ou contar o que comprou ("comprei hoje no mercado…", "registra essa nota"). Registra a compra em lote; é com ela que o Dispensa aprende as marcas e prevê o que vai faltar. Confirme itens e valores com o usuário ANTES de gravar. O servidor não vê a imagem e não consulta a SEFAZ: você transcreve, o servidor guarda evidência. A chave_nfe (44 dígitos do QR) dá idempotência e o CNPJ canônico da loja. Origem é obrigatória: transcricao, manual ou correcao. Item pode vir sem preço e sem quantidade. Em cada item, texto é o o quê (sabonete, não "sabonete nivea"). Marca e variante vão nos campos. O servidor ainda tira a marca do slug.
remover_item
ChatGPTUse quando o usuário pedir para tirar, riscar ou remover um item da lista de compras ("tira o arroz da lista", "já peguei o leite"). Chame ver_lista antes para obter o codigo; nunca o mostre ao usuário.
ver_historico
ChatGPTUse quando o usuário perguntar o que comprou, quando ou por quanto ("quando comprei café?", "quanto paguei no leite?", "compras do mês"). Devolve o histórico de compras, com data, loja e preço.
ver_lista
ChatGPTUse quando o usuário quiser ver a lista de compras ("o que tem na minha lista?", "o que anotei para o mercado?", "me mostra a lista"). Devolve a lista aberta, com a marca preferida de cada item. Mostre ao usuário nome, marca e quantidade — nunca o codigo LIS-…. O codigo fica no JSON só para remover_item. Se apoio não for null, cite a mensagem ao usuário uma vez, sem insistir.
ver_preferencia
ChatGPTUse quando o usuário perguntar qual marca ou tipo costuma comprar ("qual café eu compro?", "que sabão em pó eu uso?", "qual leite eu prefiro?"). Devolve o cartão de evidência: marca, confiança, origem e alternativa. Abaixo do piso (3 compras e proporção ≥ 0,6) a resposta é incerteza declarada — pergunte em vez de afirmar.