Embedding migration

Manage embedding model selection and migration per tenant.

Inventory

Tenant embedding status

Policy

Per-purpose × per-tenant policy

Set the embedding model for each purpose on a specific tenant, or use __platform__ for the global default. Setting a new model for an in-use tenant queues a dual-write migration (#3210 companion).

Migrate

Start migration

Warning: Migration will re-embed all memories for the tenant. This may take time and incur API costs.
Status

Migration status

Reference

About embedding migration

Embeddings are model-specific vectors that power semantic search. Changing the embedding model requires migrating all existing vectors through a careful dual-write lifecycle:

  1. Dual write: Write embeddings with both old and new models.
  2. Backfill: Re-embed all existing memories with the new model.
  3. Cutover: Switch to the new model exclusively.

Supported models: