Serverless Vector¶
Use Astra DB Serverless through IBM watsonx.data for elastic vector storage and similarity search in RAG, semantic search and AI application patterns.
Product mapping
IBM watsonx.data + Astra DB Serverless — add an Astra DB service from the watsonx.data infrastructure experience and provision a Serverless (vector) or Serverless (tables) database.
GitHub Repository
The complete source code and examples are available in the GitHub repository:
Architecture note
The Astra DB Vector Search Building Block may reflect an earlier integration pattern. Current watsonx.data documentation supports provisioning Astra DB Serverless (vector) directly from the watsonx.data infrastructure experience — see IBM watsonx.data documentation for the current product integration.
Why It Matters¶
Vector search is the retrieval engine behind modern RAG, semantic search and agent memory. Traditional search systems match keywords — vector search matches meaning. Serverless vector databases make this capability available without requiring teams to provision, scale and operate a dedicated vector cluster.

Business Value¶
Key outcomes
| Outcome | What It Means |
|---|---|
| Avoid vector-cluster operations | Serverless capacity scales with application usage — no provisioning or tuning of clusters |
| Support RAG and semantic search | Store embeddings and run approximate nearest-neighbor similarity search at application scale |
| Keep vector and application data close | Astra DB can store vector and non-vector fields together in the same collection |
| Faster application development | Use APIs designed for application access while watsonx.data provides a broader data foundation |
| Multi-cloud placement | Astra DB Serverless supports cloud/region choices, helping place vector data near applications |
When to Use¶
Use Serverless Vector when:
- You need an elastic vector store for RAG, agents, recommendation or semantic search.
- Application teams prefer API-driven access over managing a search/vector cluster.
- Workload demand is variable and serverless scaling is attractive.
- You want Astra DB available as a managed service inside the watsonx.data environment.
RAG vs Serverless Vector
For agentic enterprise search where OpenRAG capabilities are the primary requirement, use the RAG building block. For vector storage as an application service — especially where teams need direct embedding/query API access — Serverless Vector is often the simpler abstraction.
How Vector Search Works¶
- Generate embeddings for content using an embedding model.
- Store vectors alongside the corresponding records or documents.
- Generate an embedding for the incoming query.
- Run similarity search to find the nearest vectors.
- Return the matching content to the application or RAG pipeline.
flowchart LR
D["Documents / records"] --> E["Embedding model"]
E --> V["Astra DB Serverless<br/>vector database"]
Q["Query"] --> QE["Query embedding"]
QE --> V
V --> R["Nearest matching content"]
R --> A["RAG / Agent / Semantic search"]
What to Demonstrate¶
- Add an Astra DB service from watsonx.data.
- Provision a Serverless (vector) database.
- Create a vector-enabled collection or table.
- Insert sample records with embeddings or a vectorize integration where supported.
- Run vector similarity search.
- Use the results as retrieval context for an AI application.
Design Considerations¶
Vector database design matters
- Use the same embedding model and dimensions for indexed content and query vectors.
- Select the similarity metric appropriate to the embedding model and use case (cosine, dot product, Euclidean).
- Keep metadata filters alongside vectors when applications need scoped retrieval.
- Evaluate recall and precision with domain-specific test queries.
- Design deletion and re-embedding workflows for source-content changes.
IBM Products Used¶
| Product | Role |
|---|---|
| IBM watsonx.data — Adding Astra DB | Provision and manage Astra DB Serverless from within the watsonx.data infrastructure experience |
| Astra DB Serverless | Serverless vector database for embeddings, similarity search, RAG and AI applications |