Router Prompt

# Router Prompt — Arquitetura Absoluta e Tuning de Atendimento Cognitivo

> 🤖 **Disclaimer**: Documentação gerada por IA e rigorosamente auditada. [📋 Reportar erro no Módulo Router Prompt](https://github.com/TouchRefletz/maia.api/issues/new?title=Erro+na+doc:+router-prompt&labels=docs)

## 1. Visão Geral e Contexto Histórico

O arquivo `router-prompt.js` (`js/chat/prompts/router-prompt.js`) atua como a Interface Cérebro-Computador (BCI) entre a aplicação Maia EDU e a inferência rápida do LLM encarregado de classificar complexidades.
Na versão legada (V1), quando precisávamos saber se a pergunta do aluno era difícil, criávamos RegEx manuais (Expressões Regulares) analisando strings: `message.includes("matemática")`. Evidentemente, essa tese fracassou quando usuários mandavam a imagem de uma equação de Newton sem digitar nenhuma palavra-chave, burlando as restrições arquiteturais da plataforma.

A V2 erradicou Hardcoding léxico, introduzindo o método *LLM As a Judge* (LLM como Juiz). Este módulo não renderiza elementos, nem lida diretamente com Rede; ele é uma **Biblioteca Estática de Engenharia Lógica (Prompt Engineering)**. Ele constrói a Coleção de Contexto Zero-Shot e Few-Shot para compelir instâncias enxutas da Google Vertex (ex: `gemini-1.5-flash-8b`) de modo a agirem como Guardiões do Sistema de Roteamento, impedindo sobrecargas de faturamento na Google Cloud e garantindo adequação metodológica sem falhas.

---

## 2. Arquitetura de Variáveis e State Management (Schemas)

Este script exporta variáveis puras altamente mutáveis baseadas em interpolação. Ele atrela Regras Formais à base JSON.

| Variável Exportada | Injetado Em | Natureza | Função Explícita Pelo Negócio |
|--------------------|-------------|----------|-------------------------------|
| `ROUTER_RESPONSE_SCHEMA` | Payload HTTP (`router.js`) | Objeto (JSON Schema Root) | O pilar da coerção de Máquina. Força o Gemini a não retornar *"Parece que o aluno quer física..."*, mas um Strict Map contendo os Enums Absolutos: `["BAIXA", "ALTA"]` e propriedades numéricas (`confianca`). |
| `scaffolding_detected` | `ROUTER_RESPONSE_SCHEMA` | Node Booleano | Engatilha o subsistema de Pedagogia Socrática. Vantajoso pois permite a UI saber previamente (sem ter gerado a resposta final) se deve carregar os componentes VUE/React atrelados a modais interativos de Resposta Unida. |
| `busca_questao` | `ROUTER_RESPONSE_SCHEMA` | Node Object (Search Parameters) | Abstração que destrincha a requisição humana. Se aluno diz *"Manda Fuvest de gravidade 2021"*, o Schema obriga a IA a montar: `{ institution: "FUVEST", year: "2021", subject: "Física" }`. |
| `ROUTER_SYSTEM_PROMPT` | `router.js` (O Dispatcher) | String Literal Constante | O Livro de Regras. Treina a persona do LLM instanciado definindo o que caracteriza complexidade, mostrando casos empíricos de "Zero Esforço" vs "Alto Esforço". |

---

## 3. Diagrama: O Fluxo de Compreensão Meta-Analítica (LLM-As-A-Judge)

Como as Strings geradas atuam na indução lógica, a Maia Edu desenhou um pipeline Anti-Spam (Anti-Repetição de Queries) fortemente engatado neste documento: