Assistente de IA

O Assistente de IA é uma interface de chat conversacional integrada ao Mozzer. Use-o para tirar dúvidas sobre os dados da loja, consultar e operar a plataforma em linguagem natural e executar fluxos de cadastro com confirmação (ex: criar um cliente a partir de uma frase). Também funciona por voz, para uso de mãos livres no balcão ou no estoque.

Visão Geral#

Recursos disponíveis:

O que o Assistente consegue fazer#

O Assistente acessa os módulos da plataforma para consultar e operar dados em seu nome. Entre as ações possíveis estão:

• Clientes: criar, atualizar, buscar, gerenciar endereços, tags e atividades
• Produtos e catálogo: produtos, marcas, categorias, imagens de produto
• Fornecedores: cadastro, endereços e vínculo de produtos
• Estoque: consultar saldo, ajustar, transferir, lotes e relatórios
• Financeiro: contas a pagar e a receber, pagamentos e categorias
• Vendas: consultar e montar vendas
• Preços: listas de preço, cupons e regras de desconto
• Planejamento: tarefas, lembretes, anotações e suas categorizações
• Localização: clima, busca de endereço e geocodificação reversa
• Dúvidas de uso: responder "como fazer X" com base nos guias da Central de Ajuda, citando as fontes (veja Dúvidas de Uso)

Ações que criam ou alteram registros passam por uma confirmação (veja Cadastros Guiados).

Habilitar o Assistente#

O Assistente de IA é desabilitado por padrão e precisa ser ativado pelo administrador da loja em Configurações da IA. Enquanto estiver desativado, a tela do chat exibe "Assistente de IA desativado" com a ação Ativar nas configurações.

Configurações da IA (Admin)#

A tela de configurações tem duas seções:

Recursos

Limites de upload

Permissão necessária para visualizar as configurações: ai_assistant:config:read. Para alterá-las: ai_assistant:config:update.

Iniciar uma Conversa#

1. Acesse Assistente de IA no menu
2. Uma conversa é iniciada automaticamente — o indicador "Iniciando conversa" aparece por alguns instantes
3. Digite uma mensagem ou pressione e segure o botão de microfone
4. Aguarde a resposta — o indicador "Assistente digitando..." aparece enquanto a IA processa

Encerrar a conversa#

A tela do chat tem dois botões no topo:

• Fechar (X): encerra a conversa atual. Se ela ainda não tiver mensagens, é descartada; se já tiver mensagens, é marcada como Encerrada e fica disponível no histórico.
• Histórico (relógio): abre a lista de conversas.

Comandos por Voz#

1. Pressione e segure o botão de microfone ("Pressione e segure para falar")
2. Fale sua mensagem
3. Solte para enviar e transcrever
4. Para cancelar durante a gravação, arraste para cancelar
5. Para travar a gravação (mãos livres), deslize para cima

A primeira gravação pede permissão de microfone do sistema operacional. Se negada, aparece "Permissão de microfone negada" com a opção Abrir configurações.

Limites#

• O tamanho máximo do áudio por gravação é definido em Configurações da IA (padrão 5 MB)
• Gravações muito longas são interrompidas ("Gravação muito longa")
• Se a transcrição falhar, o assistente pede para repetir ou digitar a mensagem

Anexos#

1. Toque no ícone de anexar (clipe) ao lado do campo de mensagem
2. Escolha a origem:
   • Tirar foto — usa a câmera do dispositivo
   • Escolher da galeria — seleciona uma foto existente
   • Escolher arquivo — qualquer arquivo (imagens, PDF, documentos, planilhas etc.)
   • Localização — escolha um ponto no mapa para anexar
3. O anexo é enviado junto com a sua mensagem

Análise de imagens: apenas imagens são analisadas visualmente pela IA. Outros anexos (PDF, documentos, áudio, vídeo, localização) são guardados na conversa, mas não são interpretados pelo conteúdo.

Anexar Localização#

Ao escolher Localização, abre-se um mapa ("Escolher localização"):

1. Toque no mapa ou use Buscar endereço para encontrar o local
2. Use Minha localização para centralizar no seu ponto atual (requer permissão de localização)
3. Toque em Usar esta localização para anexar
4. O assistente pode usar a localização, por exemplo, para informar o clima do ponto escolhido

Se a permissão de localização for negada, ainda é possível arrastar o mapa para escolher um ponto manualmente.

Limites de anexo#

• O tamanho máximo aceito por anexo é definido em Configurações da IA; arquivos acima do limite são recusados com a mensagem "Arquivo excede o limite de 25 MB"
• Permissões de câmera e galeria são solicitadas no primeiro uso

Compartilhar para o Mozzer#

No celular (Android, iPhone e iPad), você pode enviar conteúdo ao assistente direto de outro app, sem abrir o Mozzer primeiro:

1. Em qualquer app (Galeria, Câmera, Arquivos, navegador, gravador de áudio etc.), toque em Compartilhar
2. Escolha Mozzer na lista de apps
3. O Mozzer abre direto no chat do assistente, em uma nova conversa, com o conteúdo já anexado no compositor
4. Adicione uma pergunta ou legenda (opcional) e toque em enviar — o envio é sempre confirmado por você, nunca automático

Detalhes do compartilhamento:

• Funciona com imagem, vídeo, áudio, documento e texto/URL. Texto e links compartilhados entram como um anexo (não preenchem o campo de mensagem)
• É possível compartilhar vários itens de uma vez (ex.: várias fotos de um produto)
• Itens não suportados ou acima do limite de tamanho são descartados com um aviso; os demais permanecem anexados. Se nada puder ser anexado, o chat abre vazio explicando o motivo
• Se você não estiver autenticado, o app leva ao login preservando o conteúdo; após entrar, o chat abre com os itens já anexados. Abandonar o login não envia nada
• O conteúdo entra sempre na conta (tenant) da sessão ativa

Cadastros Guiados#

Quando o Assistente reúne dados para criar um registro (ex: "cadastre o cliente João, CPF 123..."), ele exibe um Resumo do cadastro com os campos detectados.

Confirmar e Criar#

1. Revise os campos no resumo
2. Toque em Editar campo para ajustar valores — o ajuste é feito conversando com o assistente (você descreve a correção em texto)
3. Toque em Confirmar e criar para concluir

Se algum campo obrigatório estiver faltando ou inválido, o Assistente pede para complementar antes de finalizar.

Escolha por Botões#

Quando você pede uma ação que envolve uma entidade (cliente, produto, fornecedor) e a busca encontra mais de um candidato, o Assistente apresenta as opções como botões em vez de pedir que você digite "1", "2" ou "3".

1. O Assistente exibe uma pergunta curta seguida de uma lista de botões
2. Cada botão mostra o nome e, quando disponível, um detalhe para diferenciar (ex: cidade ou documento)
3. Toque no botão correto
4. O Assistente continua o fluxo com a opção exata escolhida — sem risco de erro de digitação

Depois de escolher, os botões ficam desabilitados e a opção selecionada aparece destacada com um marcador. Se preferir, você ainda pode responder por texto livre em vez de tocar num botão.

As opções continuam disponíveis ao reabrir uma conversa pelo histórico: se a escolha ainda estava pendente, os botões reaparecem; se já foi feita, aparecem no estado resolvido.

Dúvidas de Uso#

Além de operar dados, o Assistente responde dúvidas de uso — perguntas do tipo "como faço para...", "onde fica..." ou "para que serve...". Nesses casos ele consulta os guias da Central de Ajuda e responde com base no conteúdo publicado, sem inventar passos.

1. Faça a pergunta normalmente no chat (ex: "como dou entrada de estoque?")
2. O Assistente busca nos guias e responde com base nos trechos encontrados
3. Abaixo da resposta aparecem chips de fontes com os guias usados
4. Toque num chip para abrir o guia — dentro do app quando ele existe na Central de Ajuda, ou no site da documentação caso contrário, já na seção certa quando disponível

Quando nenhum guia responde à pergunta, o Assistente informa com transparência que não encontrou a resposta na documentação e sugere a Central de Ajuda ou o suporte — ele não tenta adivinhar.

As fontes continuam disponíveis ao reabrir a conversa pelo histórico: os chips reaparecem sob a mensagem.

Esse recurso é governado pela permissão ai_assistant:docs:use e, como as demais capacidades opcionais do Assistente, é atribuído por papel.

Histórico e Retomada#

As conversas ficam armazenadas e podem ser consultadas pelo botão de Histórico (relógio) na tela do chat. Cada conversa exibe seu status: Em andamento, Concluída, Cancelada, Encerrada ou Com erro.

Na lista e no detalhe de uma conversa você pode:

• Abrir uma conversa para ler as mensagens
• Restaurar sessão — reabre uma conversa encerrada para continuar de onde parou
• Excluir — descarta a conversa (registros já criados não são afetados)

Permissões#

Boas Práticas#

• Reveja o resumo de cadastro: o Assistente extrai dados de linguagem natural — sempre confirme antes de criar
• Use voz para mãos ocupadas: caixa, balcão e estoque são contextos ideais para comandos por voz
• Anexe fotos para identificação: uma foto de produto, código de barras ou nota fiscal ajuda a IA a entender o contexto (apenas imagens são analisadas visualmente)
• Use a Localização para clima e endereços: anexe um ponto no mapa quando precisar de informação ligada ao local