Developers

Solo indice invertido BM25 (pg_textsearch). Sin embeddings, sin router. El texto de la consulta se procesa con la configuracion legal_spanish (unaccent + spanish_stem).

Ideal para: autocompletado, coincidencias exactas, respuestas en <100ms.

curl -X POST https://despacho.ai/api/v1/search \
  -H "Content-Type: application/json" \
  -d '[object Object]'

{
  "total_ms": 82.3,
  "result_count": 5,
  "reranked": true,
  "cache": null
}

skip_vector: true desactiva la generacion de embeddings y el indice vectorial. Solo se consulta el indice BM25 con to_bm25query().

Genera un embedding con gemini-embedding-001 (768 dimensiones, normalizado L2) y combina resultados BM25 + HNSW vectorial mediante Reciprocal Rank Fusion (RRF, k=60). El router se omite porque la intencion es explicita.

Ideal para: consultas dirigidas donde conoces la fuente, jurisdiccion o tipo de documento.

curl -X POST https://despacho.ai/api/v1/search \
  -H "Content-Type: application/json" \
  -d '[object Object]'

{
  "total_ms": 356.2,
  "result_count": 10,
  "reranked": true,
  "cache": null
}

Cualquier filtro (source_key, jurisdiction, document_type, legal_matter, authority_min, date_from/to) activa el modo hibrido de una sola consulta. El router se omite automaticamente.

Un LLM (gemini-3.1-flash-lite) analiza la consulta y la descompone en 2-4 sub-busquedas paralelas, cada una con filtros y pesos especificos. Los resultados se fusionan con RRF ponderado (k=60). El router identifica la intencion (legislacion, jurisprudencia, disposicion, comparativa, administrativa, general) y selecciona las fuentes mas relevantes del catalogo.

Ideal para: consultas amplias o ambiguas. El sistema decide que fuentes consultar y como ponderar los resultados.

curl -X POST https://despacho.ai/api/v1/search \
  -H "Content-Type: application/json" \
  -d '[object Object]'

{
  "total_ms": 890.1,
  "result_count": 10,
  "reranked": true,
  "cache": null,
  "embedding": {
    "latency_ms": 182.3,
    "model": "gemini-embedding-001",
    "dimensions": 768
  },
  "router": {
    "intent": "provision",
    "sub_queries": 3,
    "succeeded": 3
  }
}

Se activa automaticamente cuando: no hay filtros explicitos + skip_vector: false (default). Las sub-consultas del router se ejecutan en paralelo y sus resultados se fusionan.