Analista de IA

Perguntas sobre os dados da loja em linguagem natural — o analista responde lendo a base de dados local, com a chave de IA da própria loja.

O que o analista faz

É um chat dentro da app: escreve-se uma pergunta em linguagem corrente e o analista responde consultando a base de dados da loja em tempo real. Para perguntas de dados, o modelo gera SQL de leitura e corre-o contra a base local — a resposta vem dos números reais, não de um resumo desatualizado.

Exemplos do que pergunta:

  • «Quantas reparações fechámos esta semana e qual o valor médio?»
  • «Que peças estão abaixo do stock mínimo?»
  • «Mostra os orçamentos pendentes há mais de 5 dias»
  • «Qual o técnico com mais entregas este mês?»

O que sai da loja — e para onde

O analista não é um módulo Pro — é funcionalidade do núcleo, grátis, e a OficinaOS Cloud não vê nada. As perguntas e os dados necessários para responder vão diretamente da app para o fornecedor de IA que a loja configurar (OpenAI, Google Gemini, Mistral ou um endpoint próprio). A chave de API é da loja, fica encriptada na app e nunca volta a aparecer escrita no ecrã.

Como as respostas podem incluir dados de clientes (nomes, telefones, histórico de reparações), o acesso ao analista fica restrito ao perfil de dono — os outros perfis não veem o módulo. Para o registo RGPD, o fornecedor escolhido é o subcontratante: com dados europeus, um endpoint europeu ou com cláusulas adequadas é a escolha mais simples de justificar.

Configurar (uma vez)

1. Consiga uma chave de API do fornecedor escolhido (OpenAI, Gemini, Mistral — ou um endpoint compatível com a API da OpenAI, como uma instância local).

2. Na app: Definições → Analista de IA. Escolha o fornecedor ou «Personalizado» e indique o endpoint se for o caso.

3. Cole a chave de API e escolha o modelo — os modelos pequenos (ex.: gpt-4o-mini) chegam para a maioria das perguntas e custam cêntimos por mês numa loja normal.

4. Ative o módulo. Só o perfil de dono consegue ver e configurar o analista — se outro perfil precisar dele, essa decisão é sua e revê-se nas permissões.

Dia a dia — chat, memórias e instruções

Cada conversa fica guardada no histórico e pode ser retomada ou apagada (individualmente ou em massa). Duas ferramentas afinam o comportamento sem código:

  • Memórias (até 20 ativas): factos que o analista deve lembrar sempre — «o IVA é 23%», «trabalhamos com estas três marcas»
  • Instruções (até 10 ativas): regras da casa — «responde sempre em pt-PT», «valores monetários em euros com duas casas»

Privacidade e segurança por dentro

O SQL que o modelo gera não corre com as credenciais da app: a app provisiona um role Postgres dedicado só de leitura (analyst_ro_…) — uma tentativa de escrita falha na base de dados, não só na validação. Se o role não estiver provisionado, a ferramenta de dados recusa-se em vez de cair para uma ligação privilegiada.

Na prática: o analista lê, não escreve — não consegue alterar reparações, preços ou clientes. Ainda assim, trate as respostas como ponto de partida: para valores que movem decisões (fecho de caixa, margens), confirme nos Relatórios.

Limites honestos

  • Só leitura — não executa ações, não altera dados
  • A qualidade da resposta é a qualidade dos dados: fichas incompletas dão respostas incompletas
  • Modelos pequenos enganam-se em SQL complexo — perguntas muito elaboradas podem precisar de reformular
  • O custo é da chave da loja — o fornecedor cobra por utilização (consulte os preços dele)
  • Sem acesso à internet não funciona — o endpoint do fornecedor tem de estar alcançável

Se o analista não responder

Por ordem de probabilidade:

  • Módulo desligado — Definições → Analista de IA, confirme «Ativo»
  • Chave de API inválida ou sem saldo — o erro do fornecedor aparece no chat; valide a chave na consola do fornecedor
  • Nome do modelo errado — em «Personalizado» o nome tem de ser o exato do fornecedor
  • Endpoint inacessível — em instalações sem internet ou com firewall restritiva, o fornecedor não é alcançável
  • Role de leitura por provisionar — nos logs da app aparece um aviso de provisionamento; um restart da app resolve a maioria dos casos