# Entyrax — Motor Semantico de Decisao para Catalogos Complexos

> Infraestrutura de inteligencia semantica para produtos complexos — grafo tipado, entity resolution, confidence scores e reasoning estruturado. Verticais ativas: GPUs, CPUs e Monitores no mercado brasileiro. Idioma: pt-BR.

## O que este sistema faz

Entyrax nao e um catalogo. E um motor de decisao. Para qualquer produto com compatibilidade, tradeoffs e decisoes de compra complexas, o Entyrax resolve perguntas como "qual GPU vale mais neste preco?", "qual monitor combina com minha RTX 4070?", "posso usar esta GPU com fonte de 650W?" com dados estruturados, raciocinio explicavel e fontes rastreaveis.

Verticais publicadas: GPUs, CPUs, Monitores. Em setup: perifericos (headsets, webcams, nobreaks, coolers), eletrodomesticos/casa inteligente.

## Ponto de entrada para agentes

- [AI Manifest](/ai-manifest.json): versao, capabilities, endpoints, schema do graph e freshness de dados
- [Graph Index](/api/graph/index.json): stats do graph, schemas de queries, use cases, GPUs, CPUs e exemplos
- [GPU Index leve](/api/gpus/index.json): 109 GPUs com slug, nome, marca, preco, fps, vram
- [GPU Index completo](/api/gpus/index.full.json): todos os campos de todas as GPUs
- [CPU Index leve](/api/cpus/index.json): 106 CPUs com slug, nome, marca, socket, nucleos, threads, preco e scores
- [CPU Index completo](/api/cpus/index.full.json): todos os campos de todas as CPUs
- [Mobo Index](/api/mobos/index.json): 85 placas-mãe com socket, chipset e memory_type
- [RAM Index](/api/rams/index.json): 92 kits DDR4/DDR5 com speed, latência, profile e value_score
- [Peripherals Index](/api/peripherals/index.json): adapter em setup para monitores, headsets, webcams, nobreaks, coolers e roteadores
- [PSU Index](/api/psus/index.json): 107 fontes com status de recomendacao, tiers, eficiencia e risco
- [PSU Recommendation Index](/api/recommend/psu-for-gpu/index.json): recomendacao cautelosa de classe de fonte por GPU
- [Appliances Index](/api/appliances/index.json): adapter em setup para ar-condicionado, aspirador robo, air fryer e smart home
- [CPU Graph Index](/api/graph/cpu/index.json): queries internas da vertical CPU, sem cruzamento CPU-GPU
- [CPU-GPU Graph Index](/api/graph/cpu-gpu/index.json): pareamentos cruzados CPU-GPU
- [Monitor-GPU Graph Index](/api/graph/monitor-gpu/index.json): setup do grafo monitor-GPU
- [Smart Compatibility Graph Index](/api/graph/smart-compatibility/index.json): setup do grafo de compatibilidade smart home

## Cobertura

- **109 GPUs** no mercado brasileiro (NVIDIA, AMD, Intel)
- **106 CPUs** no mercado brasileiro (Intel, AMD)
- **85 placas-mãe** com compatibilidade CPU por socket, BIOS e VRM
- **92 kits de RAM** DDR4/DDR5 com sweet spots por plataforma
- **57.581 arestas** no knowledge graph (total de todos os sub-grafos publicados)
  - Breakdown: grafo relacional core (GPU↔GPU, CPU↔GPU) 13.104 · monitor↔GPU 19.122 · PSU↔GPU 880 · placa-mãe↔CPU 3.890 · RAM↔placa-mãe 4.726 · RAM↔plataforma de CPU 7.644 · NVMe↔placa-mãe 3.655 · storage interno 849 · cooler↔CPU 3.711
  - Fonte canônica: [/api/graph/stats.json](/api/graph/stats.json) — total, breakdown por sub-grafo e ontologia do core num só lugar
- **18 casos de uso** mapeados
- **107 PSUs** em ciclo de data quality, com `recommendation_status` para separar catalogo de recomendacao
- **Adapters em setup/pilot**: peripherals (274 monitores piloto) e appliances_smart_home, seguindo ontology, source registry, entity contract, scoring, relationship, publishing e validation
- Precos em BRL coletados do Kabum
- Benchmarks e specs com fontes rastreaveis

## Verticais em setup

As verticais abaixo estao publicadas apenas como discovery/contrato inicial. Dados completos, historico, bulk e confidence breakdown continuam protegidos ou ainda nao publicados.

- [GET /api/peripherals/index.json](/api/peripherals/index.json): categorias e graph entrypoints de perifericos
- [GET /api/peripherals/monitors/index.json](/api/peripherals/monitors/index.json): monitores em setup
- [GET /api/peripherals/nobreaks/index.json](/api/peripherals/nobreaks/index.json): nobreaks em setup
- [GET /api/peripherals/coolers/index.json](/api/peripherals/coolers/index.json): coolers em setup
- [GET /api/psus/index.json](/api/psus/index.json): fontes com potencia, eficiencia, quality_tier, market_tier e recommendation_status
- [GET /api/recommend/psu-for-gpu/index.json](/api/recommend/psu-for-gpu/index.json): indice de recomendacoes PSU por GPU
- [GET /html/psu](/html/psu): ferramenta para decidir fonte por GPU e GPUs por wattage
- [GET /api/appliances/index.json](/api/appliances/index.json): categorias e graph entrypoints de eletrodomesticos/casa inteligente
- [GET /api/appliances/air-conditioners/index.json](/api/appliances/air-conditioners/index.json): ar-condicionado em setup
- [GET /api/appliances/robot-vacuums/index.json](/api/appliances/robot-vacuums/index.json): aspirador robo em setup
- [GET /api/smart-home/devices/index.json](/api/smart-home/devices/index.json): smart devices em setup

## Graphs em setup

- [GET /api/graph/monitor-gpu/index.json](/api/graph/monitor-gpu/index.json): monitor pairs_well_with GPU e requires_gpu_tier
- [GET /api/graph/nobreak-build/index.json](/api/graph/nobreak-build/index.json): nobreak supports_build
- [GET /api/graph/cooler-cpu/index.json](/api/graph/cooler-cpu/index.json): cooler compatible_with_socket CPU
- [GET /api/graph/smart-compatibility/index.json](/api/graph/smart-compatibility/index.json): compatible_with e works_with para smart home
- [GET /api/graph/appliances-best-for/index.json](/api/graph/appliances-best-for/index.json): best_for e competes_with para appliances

## Endpoints de GPU

- [GET /api/gpus/{slug}.json](/api/gpus/geforce-rtx-4070.json): dados completos de uma GPU
- [GET /html/gpus/{slug}](/html/gpus/geforce-rtx-4070): pagina HTML com JSON-LD e bloco machine-readable

## Endpoints de PSU

- [GET /api/psus/index.json](/api/psus/index.json): indice de PSUs com `recommendation_status`, `quality_tier`, `market_tier`, potencia e eficiencia
- [GET /api/psus/{slug}.json](/api/psus/corsair-rm750e.json): detalhe de uma PSU; estar no catalogo nao significa ser recomendavel
- [GET /api/recommend/psu-for-gpu/{gpu_slug}.json](/api/recommend/psu-for-gpu/geforce-rtx-4070-super.json): classe de fonte recomendada para uma GPU, com minimo tecnico, minimo recomendado, ideal, faixa segura e cautela
- [GET /api/graph/psu/gpus-for-psu/{watts}.json](/api/graph/psu/gpus-for-psu/650.json): GPUs que uma fonte por wattage pode suportar, classificadas por risco
- [GET /html/psu](/html/psu): ferramenta HTML para as perguntas "qual fonte preciso para minha GPU?" e "quais GPUs minha fonte aguenta?"

Regra D10: watts nao significam qualidade. Para PSU, considere potencia, folga, conectores, eficiencia, quality_tier, risco e contexto da build.

## Endpoints de CPU

- [GET /api/cpus/index.json](/api/cpus/index.json): indice leve de CPUs
- [GET /api/cpus/{slug}.json](/api/cpus/core-i5-12400f.json): dados completos de uma CPU
- [GET /api/graph/cpu/index.json](/api/graph/cpu/index.json): ponto de entrada do graph CPU
- [GET /api/graph/cpu/competitors/{slug}.json](/api/graph/cpu/competitors/core-i5-12400f.json): CPUs concorrentes
- [GET /api/graph/cpu/better-than/{slug}.json](/api/graph/cpu/better-than/core-i5-12400f.json): CPUs superadas por esta CPU

## Endpoints CPU-GPU

- [GET /api/graph/cpu-gpu/index.json](/api/graph/cpu-gpu/index.json): ponto de entrada com stats de todas as relações CPU-GPU
- [GET /api/graph/cpu-gpu/recommendations/{cpu_slug}.json](/api/graph/cpu-gpu/recommendations/core-i5-12600k.json): **endpoint principal** — retorna pairs_well_with, bottlenecks_with e overkill_for em uma chamada
- [GET /api/graph/gpu-cpu/recommendations/{gpu_slug}.json](/api/graph/gpu-cpu/recommendations/geforce-rtx-4070.json): **endpoint principal GPU** — retorna pairs_well_with, bottlenecked_by e overkill_for em uma chamada
- [GET /api/graph/cpu-gpu/gpus-for-cpu/{cpu_slug}.json](/api/graph/cpu-gpu/gpus-for-cpu/core-i5-12400f.json): GPUs que combinam bem com este CPU (pairs_well_with)
- [GET /api/graph/cpu-gpu/cpus-for-gpu/{gpu_slug}.json](/api/graph/cpu-gpu/cpus-for-gpu/geforce-rtx-4070.json): CPUs que combinam bem com esta GPU (pairs_well_with)
- [GET /api/graph/cpu-gpu/bottlenecks/{cpu_slug}.json](/api/graph/cpu-gpu/bottlenecks/core-i3-10100.json): GPUs que este CPU pode limitar (bottlenecks_with)
- [GET /api/graph/gpu-cpu/bottlenecks/{gpu_slug}.json](/api/graph/gpu-cpu/bottlenecks/geforce-rtx-4090.json): CPUs que podem ser gargalo para esta GPU
- [GET /api/graph/cpu-gpu/overkill/{cpu_slug}.json](/api/graph/cpu-gpu/overkill/core-i3-10100.json): GPUs muito acima do que este CPU consegue aproveitar (overkill_for)
- [GET /api/graph/gpu-cpu/overkill/{gpu_slug}.json](/api/graph/gpu-cpu/overkill/geforce-rtx-5090.json): CPUs que não aproveitam o potencial desta GPU

## Endpoints de Build Recommendation (cross-component reasoning)

- [GET /api/recommend/index.json](/api/recommend/index.json): lista todos os CPUs com build disponível
- [GET /api/recommend/build/{cpu_slug}.json](/api/recommend/build/ryzen-5-5600.json): **endpoint principal de build** — melhor GPU por resolução (1080p/1440p) e faixa de orçamento, com reasoning em português + lista de GPUs a evitar
- [GET /api/recommend/build.json?cpu={cpu_slug}&resolution=1440p&budget=3000](/api/recommend/build.json?cpu=ryzen-5-5600&resolution=1440p&budget=3000): alias com query params (redirect para o arquivo estático)
- [GET /html/builds/best-gpu-for-{cpu_slug}](/html/builds/best-gpu-for-ryzen-5-5600): página HTML de build com reasoning visual

**Estrutura do build endpoint:** cpu, by_resolution (1080p/1440p com budget_brl, gpu, reasoning), avoid_gpus (bottlenecks_with, overkill_for).

Cada recomendacao de GPU no build agora inclui campos padronizados:
- `decision_status`: "recommended" | "acceptable" | "warning" | "not_recommended"
- `decision_scores.fit_score`: 0-1 (score tecnico + ajuste de mercado)
- `decision_scores.confidence`: 0-1 (confianca nos dados)
- `pairing_quality`: "balanced" | "acceptable" | "budget_mismatch" | "bottleneck_risk"
- `market_context.buy_signal`: "buy_now" | "neutral" | "wait" | "avoid"

Para filtrar apenas recomendacoes confiantes: `decision_status == "recommended"` e `decision_scores.fit_score >= 0.70`.

**Exemplos concretos de uso:**

```
# Melhor GPU para Ryzen 5 5600 em 1440p até R$2.000
GET /api/recommend/build/ryzen-5-5600.json
→ filtrar: by_resolution["1440p"] onde budget_brl <= 2000

# Melhor GPU para i5-13600K em 1080p até R$3.000
GET /api/recommend/build/core-i5-13600k.json

# Comparação direta i5-13600K vs Ryzen 5 5600
GET /api/recommend/compare-builds/core-i5-13600k-vs-ryzen-5-5600.json

# Comparação Ryzen 7 9800X3D vs i9-14900K
GET /api/recommend/compare-builds/core-i9-14900k-vs-ryzen-7-9800x3d.json

# Todas as comparações disponíveis (3800+ pares)
GET /api/recommend/compare-builds/index.json
```

**Endpoint de comparação entre dois CPUs:**
- [GET /api/recommend/compare-builds/index.json](/api/recommend/compare-builds/index.json): lista todos os pares (3800+ comparacoes)
- [GET /api/recommend/compare-builds/{cpu_a}-vs-{cpu_b}.json](/api/recommend/compare-builds/core-i5-13600k-vs-ryzen-5-5600.json): comparacao side-by-side com winner_gaming, winner_value, GPUs shared e verdict em portugues
- Nota: cpu_a e cpu_b sao ordenados alfabeticamente pelo slug

## Endpoints do Knowledge Graph GPU

- [GET /api/graph/index.json](/api/graph/index.json): ponto de entrada geral
- [GET /api/graph/upgrades/{slug}.json](/api/graph/upgrades/geforce-rtx-4070.json): GPUs que sao upgrade sobre esta
- [GET /api/graph/competitors/{slug}.json](/api/graph/competitors/geforce-rtx-4070.json): GPUs concorrentes
- [GET /api/graph/same-tier/{slug}.json](/api/graph/same-tier/geforce-rtx-4070.json): GPUs equivalentes em preco e desempenho
- [GET /api/graph/better-than/{slug}.json](/api/graph/better-than/geforce-rtx-4070.json): GPUs que esta supera por caso de uso
- [GET /api/graph/best-for/{use_case}.json](/api/graph/best-for/jogos-em-1440p.json): GPUs recomendadas para um caso de uso

## Casos de uso disponiveis

- [notebooks ultra-finos](/api/graph/best-for/notebooks-ultra-finos.json): 1 GPUs recomendadas
- [baixo consumo](/api/graph/best-for/baixo-consumo.json): 67 GPUs recomendadas
- [jogos em 1440p](/api/graph/best-for/jogos-em-1440p.json): 52 GPUs recomendadas
- [longevidade](/api/graph/best-for/longevidade.json): 9 GPUs recomendadas
- [build compacta](/api/graph/best-for/build-compacta.json): 3 GPUs recomendadas
- [uso geral](/api/graph/best-for/uso-geral.json): 11 GPUs recomendadas
- [longevidade e jogos futuros](/api/graph/best-for/longevidade-e-jogos-futuros.json): 32 GPUs recomendadas
- [uso leve e escritório](/api/graph/best-for/uso-leve-e-escritorio.json): 2 GPUs recomendadas
- [jogos competitivos em 1080p](/api/graph/best-for/jogos-competitivos-em-1080p.json): 44 GPUs recomendadas
- [jogos em 1080p](/api/graph/best-for/jogos-em-1080p.json): 12 GPUs recomendadas
- [jogos de alta performance](/api/graph/best-for/jogos-de-alta-performance.json): 23 GPUs recomendadas
- [custo-beneficio](/api/graph/best-for/custo-beneficio.json): 18 GPUs recomendadas
- [multitarefa e streaming](/api/graph/best-for/multitarefa-e-streaming.json): 31 GPUs recomendadas
- [producao de conteudo](/api/graph/best-for/producao-de-conteudo.json): 17 GPUs recomendadas
- [jogos](/api/graph/best-for/jogos.json): 43 GPUs recomendadas
- [minimo bottleneck em gpu](/api/graph/best-for/minimo-bottleneck-em-gpu.json): 8 GPUs recomendadas
- [build silenciosa](/api/graph/best-for/build-silenciosa.json): 23 GPUs recomendadas
- [renderizacao](/api/graph/best-for/renderizacao.json): 17 GPUs recomendadas

## Ontologia do graph

Todos os endpoints de graph retornam: `slug`, `name`, `confidence` (0.0-1.0) e `meta` com campos especificos da relacao.

**Guia de confidence:** 0.0-0.3 baixa | 0.3-0.6 media | 0.6-0.8 alta | 0.8-1.0 muito alta

**Tipos de relacao do grafo relacional core** (13.104 arestas — subconjunto GPU↔GPU e CPU↔GPU do total de 57.581; os demais sub-grafos estão no breakdown acima):

- **upgrade_from** (4012 arestas): upgrade dentro da mesma vertical
- **competes_with** (3758 arestas): entidades concorrentes na mesma faixa
- **same_tier** (574 arestas): mesmo nivel de desempenho e preco
- **better_than** (702 arestas): entidade A supera B em desempenho/contexto
- **best_for** (413 arestas): entidade recomendada para um caso de uso
- **uses_architecture** (212 arestas): pertence a uma arquitetura
- **uses_memory** (107 arestas): usa um tipo de memoria
- **uses_socket** (106 arestas): usa um socket de CPU

## Proveniencia dos dados

Cada entidade tem um campo `_meta` com fonte, confidence e `resolved_from_evidence_count` por campo.

Fontes principais:
- **TechPowerUp**: benchmarks e specs
- **Kabum**: precos de varejo em BRL
- **NVIDIA / AMD / Intel oficiais**: specs de referencia
- **Curated seed**: dados estruturados manualmente para entidades sem cobertura suficiente

## Formato e linguagem

- Idioma: pt-BR
- Formato: JSON para APIs, HTML com JSON-LD para paginas
- Encoding: UTF-8
- Todos os precos em BRL (R$)
- Slugs: kebab-case

## Exemplos de Q&A com raciocinio

**Q: Qual a melhor GPU para o Ryzen 5 5600 em 1440p ate R$3.000?**

```
GET /api/recommend/build/ryzen-5-5600.json
→ by_resolution["1440p"]  (filtrar por budget_brl <= 3000)
```

Pick principal: **Radeon RX 9050** (R$ 2,499)
Reasoning: Radeon RX 9050 escolhida para 1440p com Ryzen 5 5600 — 93 fps · sem gargalo — R$2.499

Campos relevantes por item em `by_resolution[res]`:
- `technical_fit_score` — compatibilidade técnica (0–1)
- `market_adjusted_fit_score` — score ajustado por preço e disponibilidade
- `market_context.buy_signal` — "buy_now" | "wait" | "avoid"
- `market_context.value_assessment` — "excellent_value" | "fair" | "overpriced"
- `reasoning` — explicacao em portugues do raciocinio

GPUs a evitar: campo `avoid_gpus.bottlenecks_with` no mesmo endpoint.
Tier minimo para nao criar gargalo: `pairs_well_with` com `confidence >= 0.7`.

---

**Q: Qual monitor combina com a RTX 4070 Super?**

```
GET /api/graph/monitor-gpu/monitors-for-gpu/geforce-rtx-4070-super.json
→ by_resolution["1440p"]  ← resolucao ideal para esta GPU
```

Top monitores 1440p: **Rise Mode 24F1002K-B**, **Rise Mode 27F1002K-B**
Filtrar por `best_for: ["competitive"]` para gaming; `best_for: ["aaa"]` para qualidade visual.

Relacao inversa — monitor → GPUs compativeis:
```
GET /api/graph/monitor-gpu/recommendations/{monitor_slug}.json
→ relations.pairs_well_with_gpu.results
→ relations.refresh_rate_match.results  ← GPUs que atingem o refresh rate do monitor
```

---

**Q: Qual fonte preciso para a RTX 4070 Super?**

```
GET /api/recommend/psu-for-gpu/geforce-rtx-4070-super.json
```

Minimo tecnico: **400W**.
Minimo recomendado: **550W**.
Ideal inicial: **650W**.
Faixa segura: **[600, 850]W**.
Tier minimo: `acceptable`. Eficiencia preferida: `80_plus_gold`.

Importante: PSU usa D10. Watts nao significam qualidade; conectores, eficiencia, tier do modelo e contexto da build precisam ser checados. Modelos especificos sao retornados apenas quando `recommendation_status` permite.

Pergunta inversa:

```
GET /api/graph/psu/gpus-for-psu/650.json
GET /api/graph/psu/index.json  <- lista tiers e contagem de GPUs por tier
```

---

**Q: Qual a diferenca entre Core i5-10400t e Core i7-12700K para jogos?**

```
GET /api/recommend/compare-builds/core-i5-10400t-vs-core-i7-12700k.json
```

Campos principais: `verdict` (reasoning em PT-BR), `comparison.gaming_winner`, `comparison.value_winner`, `recommended_gpus`.
Veredicto: Core i7-12700K é 32% mais rápido em jogos....

Nota: slugs sao ordenados alfabeticamente na URL — use o endpoint de index para descobrir pares disponíveis:
```
GET /api/recommend/compare-builds/index.json  ← 3800+ comparacoes
```

---

**Q: Quais monitores sao bons para gaming competitivo ou 1440p equilibrado?**

```
GET /api/peripherals/monitors/index.json
→ by_use_case["competitive"]       ← 155 monitores (144+Hz, resposta rapida)
→ by_use_case["1440p_equilibrado"] ← 33 monitores (1440p 144-200Hz IPS/VA)
→ by_use_case["aaa"]               ← 43 monitores (alta resolucao + painel qualidade)
→ by_use_case["escritorio"]        ← 12 monitores (>=27pol, alta res, <=100Hz)
```

Cada monitor tem campo `best_for` com tags derivadas de refresh_rate_hz, panel_type e screen_size_inches:
- "competitive": 144+Hz e resposta <= 5ms
- "1440p_equilibrado": 1440p 144-200Hz IPS/VA/OLED (sweet spot)
- "aaa": alta resolucao + painel IPS/OLED/QD-OLED/Mini-LED
- "productivity": >=27pol + alta resolucao
- "escritorio": >=27pol + alta res + <=100Hz
- "console": 1080p ou 4K ate 120Hz

Cada aresta monitor-GPU tem campos padronizados:
- `decision_status`: "recommended" | "acceptable" | "not_recommended"
- `decision_scores.fit_score`: 0-1 (cobertura do refresh rate)
- `meta.fps_estimate_type`: "native_1080p" | "native_1440p" | "estimated_4k"
- `meta.vram_4k_adequate`: bool (apenas para monitores 4K, true se VRAM >= 12GB)

NOTA para 4K: FPS exibido e estimativa derivada de benchmarks em 1440p (fator ~0.60x).
FPS nativo em jogos AAA pesados pode ser 20-40% menor. Verificar `fps_estimate_type`.

Para specs completas + GPUs compativeis:
```
GET /api/peripherals/monitors/{slug}.json
GET /api/graph/monitor-gpu/recommendations/{slug}.json
```

Tipos de relacao monitor-GPU: `pairs_well_with_gpu` (geral), `resolution_match` (VRAM focus), `refresh_rate_match` (sweet spot 0.9-1.5x coverage).

---

**Q: O Ryzen 7 7800X3D é compatível com a Gigabyte B650 AORUS Pro AX?**

```
GET /api/compat/cpu-mobo/ryzen-7-7800x3d-gigabyte-b650-aorus-pro-ax.json
```

Resposta inclui:
- `compatible`: true/false
- `pair_type`: "cpu_mobo"
- `compatibility_status`: "native_supported" | "bios_update_required" | "socket_match_unknown_bios"
- `pairing_quality`: "excellent" | "good" | "adequate" | "not_recommended"
- `vrm_headroom`: "comfortable" | "tight" | "critical"
- `confidence`: 0.95 (native) → 0.82 (bios) → 0.55 (unknown)
- `reason`: explicação em português

Para descobrir todos os pares disponíveis:
```
GET /api/compat/index.json  ← catálogo com cpu_mobo, cpu_gpu, gpu_monitor
```

---

**Q: Qual GPU comprar para jogar em 1440p AAA com até R$ 4.000?**

```
GET /api/recommend/gpu/1440p-gaming-aaa-3000-5000.json
→ picks[0..4]  ← top 5 GPUs rankeadas por fps × value_score
→ reasoning.summary  ← explicação do ranking
```

Cada pick inclui: `name`, `avg_fps` (média 1440p), `avg_price_brl`, `value_score`, `best_for`, `avoid_if`

Combinações disponíveis:
- Resoluções: 1080p | 1440p | 4k
- Usos: gaming-aaa | gaming-competitive | produtividade
- Orçamento: ate-1500 | 1500-3000 | 3000-5000 | acima-5000

Para ver todas as combinações: `GET /api/recommend/gpu/index.json`

---

**Q: Ryzen 7 7800X3D + Gigabyte B650 AORUS Pro AX + RTX 5070 Ti — esse build é bom?**

```
GET /api/recommend/build-analysis/ryzen-7-7800x3d-gigabyte-b650-aorus-pro-ax-geforce-rtx-5070-ti.json
```

Resposta estruturada:
- `reasoning.overall_quality`: "excellent" | "good" | "acceptable" | "not_recommended"
- `reasoning.summary`: avaliação geral em português
- `reasoning.why_this_mobo`: justificativa para a placa escolhida
- `reasoning.why_this_gpu`: justificativa para a GPU
- `reasoning.budget_note`: custo estimado do build
- `cpu_mobo.pairing_quality`: qualidade do par CPU-Mobo
- `cpu_gpu.bottleneck_risk`: risco de gargalo
- `psu.ideal_psu_watts`: fonte ideal para o build

Para ver todos os builds disponíveis: `GET /api/recommend/build-analysis/index.json`

---

**Q: Quais placas-mãe são compatíveis com o Ryzen 7 7800X3D?**

```
GET /api/graph/cpu-mobo/mobos-for-cpu/ryzen-7-7800x3d.json
→ compatible_mobos  ← mobos com socket AM5 compatíveis
→ pairs_well_mobos  ← mobos com VRM adequado para o 7800X3D (120W PBP)
→ not_recommended   ← mobos compatíveis mas VRM insuficiente (ex: A620 entry)
```

Cada entry em `compatible_mobos` tem:
- `compatibility_status`: "native_supported" | "bios_update_required" | "socket_match_unknown_bios"
- `bios_support`: "native" | "with_update" | "unknown"
- `bios_version_required`: versão mínima de BIOS quando status = "bios_update_required"
- `confidence`: 0.0–1.0 (0.95 native, 0.82 bios_update, 0.55 unknown)

Cada entry em `pairs_well_mobos` tem:
- `pairing_quality`: "excellent" | "good" | "adequate" | "not_recommended"
- `confidence`: 0.90 excellent | 0.80 good | 0.65 adequate | 0.0 not_recommended

Para listar CPUs compatíveis com uma mobo específica:
```
GET /api/graph/mobo-cpu/cpus-for-mobo/asus-rog-crosshair-x670e-hero.json
```

NOTA: "compatible" significa "pode funcionar", não "faz sentido usar juntos".
Uma A620 + Ryzen 9 7950X é `compatible_cpu: native_supported` mas `pairs_well_with_cpu: not_recommended`
por VRM insuficiente. O Entyrax diferencia os dois casos.

---

**Q: Quais memórias RAM são compatíveis com a Gigabyte B650 Aorus Pro AX?**

```
GET /api/graph/mobo-ram/rams-for-mobo/gigabyte-b650-aorus-pro-ax.json
→ compatible_rams  ← só DDR5 (B650 é AM5; DDR4 fisicamente incompatível)
```

Cada entry tem:
- `supported_speed_mhz`: velocidade efetiva na placa (pode ser menor que a do kit)
- `requires_xmp_expo`: true quando a velocidade nominal exige ativar perfil na BIOS
- `downclocked`: true quando o kit roda abaixo da velocidade nominal nesta placa
- `confidence`: 0.0–1.0

REGRA FÍSICA: DDR4 e DDR5 têm slots incompatíveis. O grafo nunca lista DDR4
para mobos AM5/LGA1851, nem DDR5 para mobos AM4. Se a mobo LGA1700 tem
`memory_type: DDR4`, só kits DDR4 aparecem.

Para o caminho inverso (mobos que aceitam um kit):
```
GET /api/graph/ram-mobo/mobos-for-ram/kingston-fury-beast-ddr5-6000-32gb.json
```

---

**Q: Qual RAM devo comprar para um Ryzen 7 9800X3D com placa B650?**

Raciocínio em 2 passos (o grafo entrega os sinais prontos):

1. Plataforma do CPU define o sweet spot:
```
GET /api/graph/ram-cpu/cpus-for-ram/kingston-fury-beast-ddr5-6000-32gb.json
→ platform_fits[cpu_slug=ryzen-7-9800x3d]
   - sweet_spot: "sweet_spot"        ← DDR5-6000 é o ponto ideal para AM5
   - fit_score, speed_recommendation, apu_impact
```

2. Recomendação direta por mobo (tiers por preço, com vetos):
```
GET /api/recommend/ram-for-build/gigabyte-b650-aorus-pro-ax.json
→ recommended.budget / .mid / .high  ← top picks por tercil de preço, value_score desc
→ acceptable                         ← funciona mas roda downclocked
→ avoid                              ← rodaria muito abaixo do potencial (com reason)
```

REGRAS DE PERFIL:
- XMP é Intel; EXPO é AMD. Kit XMP em AM5 geralmente funciona mas pode exigir ajuste manual — kits EXPO são preferíveis para Ryzen.
- Para APUs AMD (Ryzen 8600G/8700G), `apu_impact: high_impact` indica que RAM mais rápida melhora diretamente o desempenho do iGPU.

Sweet spots por plataforma: AM5 = DDR5-5600–6400 | AM4 = DDR4-3400–3800 |
LGA1851 = DDR5-6000–6800 | LGA1700 = DDR4-3400–3800 ou DDR5-5600–6400.

---

**Q: Quais kits de RAM existem no catálogo e como comparar?**

```
GET /api/rams/index.json   ← todos os kits: slug, brand, ddr_generation, capacity_gb,
                              speed_mhz, kit_type, latency_cl, profile, market_tier,
                              speed_tier, avg_price_brl, value_score
GET /api/rams/{slug}.json  ← ficha completa de um kit
```

Para comparar custo-benefício: ordene por `value_score` dentro do mesmo
`ddr_generation` + `capacity_gb`. Preços em BRL coletados do Kabum.
Páginas HTML por kit: /html/rams/{slug} — com análise editorial, compatibilidade
por plataforma e alternativas no mesmo preço.

---

**Q: O Kingston NV3 (PCIe gen4) funciona na minha B450? Perde desempenho?**

```
GET /api/graph/nvme-mobo/mobos-for-nvme/kingston-nv3-1tb.json
→ compatible_mobos[slug=asrock-b450m-pro4]
   - m2_slot_gen: 3
   - downgraded: true
   - effective_read_mbps: 3500
   - performance_loss_pct: 42
   - reason: "Slot M.2 gen3 limita o gen4 a ~3500 MB/s (-42%)"
```

Funciona (NVMe é retrocompatível), mas o grafo quantifica a perda — o agente
pode recomendar um gen3 mais barato para essa placa sem perda real.

Caminho inverso (SSDs para uma placa):
```
GET /api/graph/mobo-storage/nvmes-for-mobo/gigabyte-b650-aorus-pro-ax.json
```

---

**Q: Qual HD comprar para NAS? O BarraCuda 4TB serve?**

```
GET /api/graph/storage/better-for-workload/seagate-barracuda-4tb.json
→ better_for_workload[0]
   - slug: wd-blue-4tb (CMR)
   - recording_advantage: "CMR não degrada em escrita sustentada/RAID —
     SMR sofre em resilver"
   - price_delta_pct: +9.3
```

O BarraCuda 4TB é SMR — em NAS/RAID degrada em rebuilds. Por ~9% a mais o
WD Blue CMR resolve. HDs com `recording: SMR` e `workload: nas` recebem
nota-teto 4.0 no value_score (veto Lei D4, precedente WD Red SMR 2020).

Concorrentes e melhor R$/GB:
```
GET /api/graph/storage/competitors/{slug}.json
GET /api/graph/storage/better-value/{slug}.json
```

---

**Q: Qual SSD e HD comprar para minha placa-mãe?**

```
GET /api/recommend/storage-for-build/gigabyte-b650-aorus-pro-ax.json
→ nvme.recommended.budget/.mid/.high  ← picks full-speed no slot, por tercil
→ nvme.acceptable_downgraded          ← perda <= 15% (aceitável com aviso)
→ nvme.avoid                          ← gen4/5 que perderia muito no slot,
                                        QLC DRAM-less p/ escrita pesada — com reason
→ data_drive.hdd_picks                ← massa de dados CMR por R$/GB (Lei D4)
→ data_drive.sata_ssd_picks           ← SATA para upgrade/secundário
```

Índices públicos: /api/nvmes/index.json · /api/sata-ssds/index.json ·
/api/hdds/index.json. Páginas: /html/nvmes/{slug}, /html/hdds/{slug}.

---

**Q: Qual cooler aguenta o Core i9-14900K? O cooler de caixa serve?**

```
GET /api/recommend/cooler-for-cpu/core-i9-14900k.json
→ unlocked: true              ← K/X/X3D: headroom 1.3x sobre o TDP de etiqueta
→ recommended.budget/.mid/.high  ← só comfortable/adequate (ratio >= 1.2)
→ tight                       ← no limite: throttling em boost sustentado
→ insufficient                ← vetados com reason (Lei D4)
→ stock_cooler_note           ← Ryzen não-X <= 65W vem com Wraith; K/X3D não vêm
```

Intel K não vem com cooler. Para CPUs de 65W o Wraith de caixa resolve —
o Entyrax diz quando NÃO comprar. Índice público: /api/coolers/index.json.

## MCP (Model Context Protocol)

O Entyrax tem um MCP server VIVO (JSON-RPC 2.0, Streamable HTTP, SEM autenticacao):
- Endpoint: https://www.entyrax.com/mcp
- Tools de decisao: check_compatibility, recommend_gpu_by_context, analyze_build
- Fluxo: initialize -> tools/list -> tools/call (sem API key, sem configuracao)
- Server Card: https://www.entyrax.com/.well-known/mcp/server-card.json
- Registry oficial: com.entyrax/entyrax em registry.modelcontextprotocol.io
- Smithery: https://smithery.ai/servers/matheussteffens2/entyrax

Cada tool retorna veredicto + reasoning estruturado (nao lista bruta). Para consultas
de dado (listas, indices), use os endpoints REST documentados acima.

## Contato

hello@entyrax.com

---
Versao publica: 0.11.0
Gerado em: 2026-10-26