.. image:: https://static.wixstatic.com/media/bb27e0_2688501ec3c84180977a93955137bd03~mv2.png/v1/fill/w_55,h_55,al_c,q_85,usm_0.66_1.00_0.01,enc_auto/iconx.png
   :align: right
   :width: 80

Menthor: Inteligência de Dados
==============================

O **Menthor** é o assistente inteligente da Maximiza IA projetado para a exploração e análise de dados. Ele combina o poder dos modelos de linguagem (LLMs) com acesso direto a bases de dados e documentos, transformando perguntas em linguagem natural em insights técnicos, consultas SQL e visualizações.

.. note::
   Esta documentação cobre a versão **|last_update|** da API Menthor+MIA.

Capacidades do Assistente
-------------------------

O sistema está estruturado em três pilares principais:

* **Análise de Dados Estruturados (Menthor DB)**:
  Capacidade de interpretar esquemas de banco de dados, gerar consultas SQL dinâmicas e extrair estatísticas diretamente de tabelas.
  
* **Busca Semântica e Documental (Menthor Files)**:
  Exploração de arquivos e documentos através de *Vector Stores*, permitindo encontrar conteúdos e contextos específicos que não estão em bancos de dados tradicionais.
  
* **Inteligência Analítica**:
  Geração de gráficos, visualizações de dados e sugestões proativas baseadas no comportamento do usuário e nos dados analisados.

Exemplos de Fluxos Suportados
-----------------------------

Para guiar o desenvolvimento e testes, o assistente responde a comandos como:

1. **Consultas diretas**: *"Liste os registros da tabela de vendas."*
2. **Visualização**: *"Crie um gráfico com os dados da coluna de faturamento."*
3. **Busca de Contexto**: *"O que os documentos dizem sobre a política de privacidade?"*

---

.. toctree::
   :maxdepth: 2
   :caption: Guia de Desenvolvimento:

   configuracao
   autenticacao
   fluxos
   openai_files
   data_quality_db
   deploy

Referência da API: Menthor
===============================

Abaixo estão detalhados os endpoints gerados a partir da especificação OpenAPI. Eles estão organizados por tags conforme as responsabilidades do sistema.

.. openapi:: ../../openapi.json
   :group:
   :examples:
   :format: group