Vectorize – Gotchas

# Vectorize Gotchas ## Critical Warnings ### Async Mutations Insert/upsert/delete return immediately but vectors aren't queryable for 5-10 seconds. ### Batch Size Limit **Workers API: 500 vectors max per call** (undocumented, silently truncates) ```typescript // ✅ Chunk into 500 for (let i = 0; i 64 bytes truncated - Use dot notation for nested: `"product.category"` ## Model Dimensions - `@cf/baai/bge-small-en-v1.5`: 384 - `@cf/baai/bge-base-en-v1.5`: 768 - `@cf/baai/bge-large-en-v1.5`: 1024