1
Curious builder0 XP earned · 300 to level 2
0 daysFinish a lesson to begin
Badge collection0 of 6 unlocked
51 small wins to finish your pathNext question →
You switched to a new embedding model and a new chunking strategy, and production quality dropped. How should you have managed this migration, and what now?
30-second answerSay your answer out loud first, then reveal.
Immediate actions
- Roll back: point traffic to the previous index and pipeline version. This requires that the old index wasn't deleted. (If it was, that's lesson #1.)
- Root-cause: evaluate four combinations: (old/new chunking) × (old/new embedder). Find which change hurt, and on which query types.
- Common culprits: the new model needs query/passage prefixes or a different similarity metric; the new chunk sizes exceed the model's token limit (truncation); different normalisation; BM25 tokenisation changed; metadata lost in the new pipeline.
Proper migration process (blue-green indexing)

Principles
- One change at a time (or a factorial test), so you can attribute effects.
- Version everything: parser, chunker, embedder, index config. Store the pipeline version on each chunk.
- Index aliases to switch atomically.
- Cost and time planning: re-embedding millions of chunks takes time and money; run it in the background with checkpoints.
- Segment-level evaluation: a change can improve the average but hurt critical segments (e.g. Hindi queries, tables).
Related
Every expert started right here.