Files
roboco/tests/unit/services/test_optimal_search_fanout.py
T
Renn F d7aee91b39 perf(rag): embed the query once and search indexes concurrently
OptimalService.search / query (via _aggregate_citations) ran each index's
plugin.search() sequentially, and every plugin.search re-ran HyDE + embed — so an
N-index query made N LLM+embed round-trips in series (~28s across all indexes,
even though the SQL is fast). Embed the query ONCE
(BaseIndexPlugin.compute_query_embedding) and run every index's vector search
concurrently against that single embedding (search_with_embedding +
asyncio.gather). The search/query signatures and return contract are unchanged;
behavior is identical, just ~Nx fewer embed calls and parallel fetch.

Adds a regression test asserting one embed + per-index fan-out.
2026-06-15 06:12:00 +02:00

55 lines
1.8 KiB
Python

"""OptimalService.search embeds the query once and fans out across indexes.
Guards the latency fix: previously each index re-ran HyDE + embed sequentially
(N LLM calls, serial), so an all-index search took ~28s. Now the query is
embedded once and every index's vector search runs concurrently with that single
embedding.
"""
from __future__ import annotations
from unittest.mock import AsyncMock, MagicMock
import pytest
from roboco.models.optimal import IndexType, SearchOutcome
from roboco.services.optimal import OptimalService
def _fake_plugin(index_type: IndexType) -> MagicMock:
plugin = MagicMock()
plugin.compute_query_embedding = AsyncMock(return_value=[0.1, 0.2, 0.3])
plugin.search_with_embedding = AsyncMock(
return_value=SearchOutcome(results=[], success=True, index_type=index_type)
)
plugin.count = AsyncMock(return_value=1)
return plugin
@pytest.mark.asyncio
async def test_search_embeds_once_and_fans_out(
monkeypatch: pytest.MonkeyPatch,
) -> None:
svc = OptimalService.__new__(OptimalService)
p_docs = _fake_plugin(IndexType.DOCUMENTATION)
p_journals = _fake_plugin(IndexType.JOURNALS)
monkeypatch.setattr(svc, "_initialized", True, raising=False)
monkeypatch.setattr(
svc,
"_plugins",
{IndexType.DOCUMENTATION: p_docs, IndexType.JOURNALS: p_journals},
raising=False,
)
await svc.search("anything")
# Embedded exactly once total (on the first plugin), reused across indexes —
# not once per index.
embed_calls = (
p_docs.compute_query_embedding.await_count
+ p_journals.compute_query_embedding.await_count
)
assert embed_calls == 1
# Every index ran a vector search with the pre-computed embedding.
p_docs.search_with_embedding.assert_awaited_once()
p_journals.search_with_embedding.assert_awaited_once()