Why this is needed:
Users need practical examples to understand how to use the new vector storage
model isolation feature. Without examples, the automatic migration and multi-model
coexistence patterns may not be clear to developers implementing this feature.
What this adds:
- Comprehensive demo covering three key scenarios:
1. Creating new workspace with explicit model name
2. Automatic migration from legacy format (without model_name)
3. Multiple embedding models coexisting safely
- Detailed inline comments explaining each scenario
- Expected collection/table naming patterns
- Verification steps for each scenario
Impact:
- Provides clear guidance for users upgrading to model isolation
- Demonstrates best practices for specifying model_name
- Shows how to verify successful migrations
- Reduces support burden by answering common questions upfront
Testing:
Example code includes complete async/await patterns and can be run directly
after configuring OpenAI API credentials. Each scenario is self-contained
with explanatory output.
Related commits:
- df5aacb5: Qdrant model isolation implementation
- ad68624d: PostgreSQL model isolation implementation
a0dfb47d0d