Short-circuit FAQ

La cache FAQ restituisce una risposta verificata da esperti di dominio per una domanda nota, bypassando completamente l'LLM, il fact store e il retriever. È un'ottimizzazione di latenza e costi — e un livello ad alto rischio, perché si trova a monte della protezione di prevenzione delle risposte inventate. Uno short-circuit errato salterebbe ogni controllo di sicurezza a valle.

Dove si colloca

Nella route /v1/ask (service/api/routes.py), il lookup FAQ viene eseguito per primo:

# 1) FAQ short-circuit — on hit, never touches provider / fact store / retriever
hit = faq_cache.lookup(req.question, reference_date=ref)
if hit is not None:
    return AskResponse(..., route="faq", answer=hit.answer, sources=[...])

# 2) miss -> normal workflow (anti-fabrication guard, dual channel, ...)
result = answer_question(req.question, store, provider, ...)

lookup è una funzione pura (service/faq/faq_cache.py): consulta parse_intent / clarify_scope per le decisioni di confine ma non raggiunge mai l'LLM, il fact store o il retriever. La corrispondenza avviene esclusivamente per match esatto normalizzato / alias (NFKC, casefold, normalizzazione degli spazi e rimozione della punteggiatura finale) — nessuna corrispondenza fuzzy o basata su embedding.

Le esclusioni conservative

lookup restituisce un miss (None) se una qualsiasi di queste condizioni è vera — le esclusioni vengono verificate prima di consultare l'indice della cache:

Un elemento FAQ

Gli elementi sono verificati da esperti di dominio e tracciati per versione; l'hit trasporta la propria provenienza (FAQHit.source):

{
  "id": "what-is-ragspine",
  "question": "RAGSpine 是什么？",
  "aliases": ["What is RAGSpine?"],
  "answer": "RAGSpine 是一个无框架的后端 RAG 引擎……",
  "source": "internal/faq-handbook.md",
  "version": 3,
  "enabled": true,
  "valid_from": "2026-01-01",
  "valid_until": null,
  "sensitivity": "INTERNAL"
}