Este manual do usu\u00e1rio abrange todas as abas e configura\u00e7\u00f5es para que voc\u00ea possa configurar o m\u00f3dulo, conectar seu provedor de IA e come\u00e7ar a consultar os dados da sua loja desde o primeiro dia. Compat\u00edvel com PrestaShop 1.7.x at\u00e9 9.x.<\/span><\/p>\n O Assistente Administrativo Inteligente do PrestaShop foi desenvolvido para:<\/span><\/p>\n Passo 1: <\/strong> Fa\u00e7a login no painel administrativo do PrestaShop, acesse M\u00f3dulos e abra o Gerenciador de M\u00f3dulos.<\/span><\/p>\n Passo 2: <\/strong>Localize o bot\u00e3o “Carregar um m\u00f3dulo” no canto superior direito, selecione o arquivo ZIP que voc\u00ea baixou da Knowband e confirme. O PrestaShop cuidar\u00e1 do resto.<\/span><\/p>\n Passo 3: <\/strong>Ap\u00f3s a conclus\u00e3o do upload, um bot\u00e3o Instalar aparecer\u00e1. Clique nele. A tela de configura\u00e7\u00e3o do m\u00f3dulo ser\u00e1 aberta automaticamente assim que a instala\u00e7\u00e3o for conclu\u00edda.<\/span><\/p>\n Passo 4: <\/strong>Se nada aparecer ap\u00f3s a instala\u00e7\u00e3o, digite Smart Admin Assistant na barra de pesquisa do Gerenciador de M\u00f3dulos e clique em Configurar.<\/span><\/p>\n O upload falhou: <\/b>O limite de tamanho de upload do servidor \u00e9 muito baixo. Pe\u00e7a ao seu provedor de hospedagem para aumentar os par\u00e2metros `upload_max_filesize` e `post_max_size` nas configura\u00e7\u00f5es do PHP para pelo menos 32 MB.<\/span><\/p>\n M\u00f3dulo n\u00e3o vis\u00edvel ap\u00f3s a instala\u00e7\u00e3o: <\/b>Limpe o cache do PrestaShop em Par\u00e2metros Avan\u00e7ados, depois em Desempenho e, em seguida, procure o complemento novamente.<\/span><\/p>\n A p\u00e1gina de configura\u00e7\u00e3o parece estar com problemas: <\/b>Limpe o cache do seu navegador e o cache do tema do PrestaShop em Design, depois em Tema e Logotipo e, por fim, em Configura\u00e7\u00f5es Avan\u00e7adas.<\/span><\/p>\n O Assistente Administrativo Inteligente com IA do PrestaShop possui oito abas na parte superior da p\u00e1gina de configura\u00e7\u00e3o:<\/span><\/p>\n Em conjunto, essas abas abrangem tudo, desde an\u00e1lises e relat\u00f3rios da PrestaShop Smart Store at\u00e9 controle de acesso a dados e hist\u00f3rico de sess\u00f5es.<\/span><\/p>\n Ativar chatbot: <\/b>Ative ou desative o Assistente Administrativo Inteligente com IA do PrestaShop. Todas as configura\u00e7\u00f5es s\u00e3o preservadas quando desativado; reativ\u00e1-lo restaura tudo instantaneamente.<\/span><\/p>\n Ativar chips predefinidos: <\/b>Ative ou desative os bot\u00f5es de perguntas de acesso r\u00e1pido dentro do widget de bate-papo.<\/span><\/p>\n Estado padr\u00e3o dos chips: <\/b>Recolhido significa que o painel de chips ficar\u00e1 oculto quando o widget for aberto pela primeira vez. Expandido significa que todos os chips ficar\u00e3o vis\u00edveis assim que o assistente for carregado.<\/span><\/p>\n N\u00famero m\u00e1ximo de linhas de resultado: <\/b>O n\u00famero m\u00e1ximo de linhas que a IA pode retornar para uma \u00fanica consulta.<\/span><\/p>\n O intervalo varia de 1 a 1000, sendo 100 o valor padr\u00e3o. Aumente o valor para obter dados detalhados e diminua-o quando precisar apenas de um n\u00famero r\u00e1pido.<\/span><\/p>\n Exibir\/Alternar consulta SQL: <\/b>Quando ativada a op\u00e7\u00e3o “Sim”, o assistente exibe o c\u00f3digo SQL exato que gerou abaixo de cada resposta. Essa \u00e9 a principal funcionalidade de transpar\u00eancia anal\u00edtica do painel administrativo do PrestaShop; os administradores podem ver precisamente como cada resposta foi produzida.<\/span><\/p>\n Permitir edi\u00e7\u00e3o e nova execu\u00e7\u00e3o de SQL: <\/b>Quando definida como “Sim”, os administradores podem editar o SQL gerado diretamente no chat e execut\u00e1-lo novamente. Isso \u00e9 \u00fatil para ajustar um intervalo de datas, um limite ou um filtro sem precisar digitar uma nova pergunta do zero.<\/span><\/p>\n Entrada de voz: <\/b>Habilita o \u00edcone do microfone no campo de bate-papo. Os administradores podem falar perguntas em vez de digitar, usando a API Web Speech do navegador. Este recurso de entrada de voz para administradores do PrestaShop funciona melhor no Chrome em um computador.<\/span><\/p>\n Utilizar linguagem de back-office: <\/b>O assistente corresponde ao idioma em que o painel de administra\u00e7\u00e3o do PrestaShop est\u00e1 sendo executado.<\/span><\/p>\n Usar idioma personalizado: <\/b>Escolha um idioma de resposta fixo que n\u00e3o mudar\u00e1 com base no idioma configurado no sistema administrativo. Isso \u00e9 \u00fatil quando os funcion\u00e1rios trabalham em um idioma diferente daquele configurado no sistema administrativo.<\/span><\/p>\n Tempo de reten\u00e7\u00e3o de logs (dias): <\/b>Define por quantos dias o hist\u00f3rico de consultas o m\u00f3dulo mant\u00e9m antes de excluir entradas antigas. O padr\u00e3o \u00e9 90 dias. A limpeza \u00e9 executada automaticamente, sem qualquer interven\u00e7\u00e3o manual no banco de dados.<\/span><\/p>\n Essas configura\u00e7\u00f5es ajudam o m\u00f3dulo Smart Insights do PrestaShop a manter registros de consultas precisos e atualizados em todos os momentos.<\/span><\/p>\n Tempo de vida (TTL) do cache de esquema (minutos): <\/b>O esquema \u00e9 o mapa da estrutura do seu banco de dados que a IA l\u00ea para construir consultas precisas. Essa configura\u00e7\u00e3o controla por quanto tempo o mapa \u00e9 armazenado em cache antes que o complemento busque uma nova c\u00f3pia.<\/span><\/p>\n Atualizar esquema agora: <\/b>Aciona uma atualiza\u00e7\u00e3o imediata do esquema sob demanda. Execute este comando ap\u00f3s adicionar um novo m\u00f3dulo, atualizar o PrestaShop ou qualquer altera\u00e7\u00e3o que modifique a estrutura do banco de dados.<\/span><\/p>\n Clique <\/span>Salvar configura\u00e7\u00f5es<\/b> Para aplicar todas as altera\u00e7\u00f5es nesta aba.<\/span><\/p>\n Na aba “Provedor de IA”, voc\u00ea vincula o m\u00f3dulo ao seu servi\u00e7o de IA preferido. OpenAI (ChatGPT), Anthropic Claude e Google Gemini s\u00e3o todos compat\u00edveis. Essa compatibilidade com m\u00faltiplos provedores de IA significa que voc\u00ea n\u00e3o fica restrito a um \u00fanico fornecedor. Voc\u00ea fornece sua pr\u00f3pria chave de API e o complemento se conecta diretamente ao provedor escolhido.<\/span><\/p>\n Clique no bot\u00e3o do provedor, OpenAI (ChatGPT), Anthropic Claude ou Google Gemini, para selecion\u00e1-lo. As configura\u00e7\u00f5es abaixo ser\u00e3o atualizadas para exibir os campos correspondentes a esse provedor.<\/span><\/p>\n OpenAI<\/b><\/p>\n Claude Antr\u00f3pico<\/b><\/p>\n Google G\u00eameos<\/b><\/p>\n Modelos OpenAI:<\/b><\/p>\n Modelos antropog\u00eanicos de Claude:<\/b><\/p>\n Modelos do Google Gemini:<\/b><\/p>\n Isso controla o qu\u00e3o rigorosamente a IA se at\u00e9m \u00e0 sa\u00edda factual. Em 0, as respostas s\u00e3o as mais precisas poss\u00edveis. Em 1, h\u00e1 mais varia\u00e7\u00e3o na forma como as respostas s\u00e3o formuladas. Para consultas de dados armazenados, 0.3 funciona bem como ponto de partida. Reduza para 0.0 se precisar dos resultados mais literais e consistentes.<\/span><\/p>\n Clique <\/span>Salvar configura\u00e7\u00f5es do provedor<\/b> aplicar.<\/span><\/p>\n A aba Layout do Widget controla a apar\u00eancia da janela de chat no painel administrativo. Um painel de pr\u00e9-visualiza\u00e7\u00e3o ao vivo \u00e0 direita \u00e9 atualizado em tempo real conforme voc\u00ea ajusta cada configura\u00e7\u00e3o.<\/span><\/p>\n Posi\u00e7\u00e3o: <\/b>O local onde o bal\u00e3o de bate-papo fica na tela. Por padr\u00e3o, \u00e9 no canto inferior direito.<\/span><\/p>\n Nome do chatbot: <\/b>O r\u00f3tulo exibido no cabe\u00e7alho do widget. O padr\u00e3o \u00e9 Assistente Administrativo Inteligente.<\/span><\/p>\n Mensagem de sauda\u00e7\u00e3o: <\/b>A frase de abertura que o assistente exibe quando o widget \u00e9 aberto. Por padr\u00e3o, \u00e9 “Ol\u00e1! Pergunte-me qualquer coisa sobre sua loja.”<\/span><\/p>\n \u00cdcone de bal\u00e3o: <\/b>Imagem personalizada para o bot\u00e3o de bate-papo flutuante. PNG quadrado, 64×64 px, tamanho m\u00e1ximo de 2 MB.<\/span><\/p>\n Avatar do chatbot: <\/b>Imagem que aparece ao lado das mensagens do bot dentro da janela de bate-papo. PNG quadrado, 48×48 px, tamanho m\u00e1ximo de 2 MB.<\/span><\/p>\n Largura e altura do widget (px): <\/b>Controla o tamanho do painel de bate-papo. O padr\u00e3o \u00e9 400 de largura por 560 de altura.<\/span><\/p>\n Configura\u00e7\u00f5es de cor: <\/b>Seis controles individuais para cabe\u00e7alho, bal\u00e3o de bate-papo, mensagem do usu\u00e1rio, mensagem do bot, fundo e cores do texto. N\u00e3o \u00e9 necess\u00e1rio editar CSS.<\/span><\/p>\n Clique <\/span>Salvar layout<\/b> aplicar.<\/span><\/p>\n1.1 Para quem \u00e9 este m\u00f3dulo?<\/b><\/h3>\n
\n
2.0 Guia de Instala\u00e7\u00e3o<\/b><\/h2>\n
Requerimentos do sistema<\/b><\/h3>\n
\n
Carregar e instalar o m\u00f3dulo<\/b><\/h3>\n
![\"Instala\u00e7\u00e3o](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/1.png\")
<\/a><\/p>\nProblemas comuns de instala\u00e7\u00e3o<\/b><\/h3>\n
3.0 Assistente de administra\u00e7\u00e3o inteligente com IA para PrestaShop<\/a>Vis\u00e3o geral do painel de administra\u00e7\u00e3o<\/b><\/h2>\n
![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/333.png\")
<\/a><\/p>\n\n
4.0 Guia Configura\u00e7\u00f5es<\/b><\/h2>\n
4.1 Configura\u00e7\u00f5es gerais do m\u00f3dulo de painel de controle de IA do PrestaShop<\/b><\/h3>\n
![\"Configura\u00e7\u00f5es](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/22.png\")
<\/a><\/p>\n4.2 Configura\u00e7\u00f5es de idioma<\/b><\/h3>\n
![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/language-settings.png\")
<\/a><\/p>\n4.3 Configura\u00e7\u00f5es de registro e cache<\/b><\/h3>\n
![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/log-settigns.png\")
<\/a><\/p>\n5.0 Aba do Provedor de IA<\/b><\/h2>\n
![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/ai-provider-tab.png\")
<\/a><\/p>\n5.1 Como escolher seu fornecedor<\/b><\/h3>\n
5.2 Como obter sua chave de API<\/b><\/h3>\n
\n
\n![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/api-key.png\")
<\/a><\/span><\/li>\n
\n![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/api-key-2.png\")
<\/a>
\n![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/api-key3.png\")
<\/a>
\n<\/span><\/li>\n\n
\n![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/claude-api.png\")
<\/a>
\n<\/span><\/li>\n
\n![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/Screenshot-2026-06-02-182307.png\")
<\/a>
\n<\/span><\/li>\n\n
\n![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/gemini-api.png\")
<\/a>
\n<\/span><\/li>\n
\n![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/gemini-api1.png\")
<\/a>
\n<\/span><\/li>\n5.3 Selecionando um Modelo<\/b><\/h3>\n
![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/image-4.png\")
<\/a><\/p>\n\n
![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/image-5.png\")
<\/a><\/p>\n\n
![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/image-6.png\")
<\/a><\/p>\n\n
5.4 Configura\u00e7\u00e3o de temperatura<\/b><\/h3>\n
6.0 Aba de Layout do Widget<\/b><\/h2>\n
![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/widget-layout.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/widget-layout-1.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2026\/06\/PrestaShop-Smart-AI-Admin-Chatbot-View.png\")
<\/a><\/p>\n7.0 Guia Visualiza\u00e7\u00f5es do Banco de Dados<\/b><\/h2>\n