From 1039c8e7cfe088f376d0f33686fce31d9d01b6fa Mon Sep 17 00:00:00 2001 From: Adam Young Date: Sun, 14 Sep 2025 15:10:01 -0500 Subject: [PATCH] docs: Fix incorrect vector_db_id usage in RAG tutorial The detailed RAG tutorial was using a client-generated `vector_db_id`. Recent versions of Llama-Stack ignore this ID and assign a new server-side ID, causing the `rag_tool.insert` call to fail with a `400 Bad Request` error. This commit updates the code to capture the authoritative ID from the `.identifier` attribute of the `register()` method's response object. A concise comment is also added to explain why this is necessary. This ensures the tutorial code runs successfully and reflects the current API behavior related to the deprecation of VectorDB. --- docs/source/getting_started/detailed_tutorial.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/source/getting_started/detailed_tutorial.md b/docs/source/getting_started/detailed_tutorial.md index 14f888628..77a899c48 100644 --- a/docs/source/getting_started/detailed_tutorial.md +++ b/docs/source/getting_started/detailed_tutorial.md @@ -460,10 +460,12 @@ client = LlamaStackClient(base_url="http://localhost:8321") embed_lm = next(m for m in client.models.list() if m.model_type == "embedding") embedding_model = embed_lm.identifier vector_db_id = f"v{uuid.uuid4().hex}" -client.vector_dbs.register( +# The VectorDB API is deprecated; the server now returns its own authoritative ID. +# We capture the correct ID from the response's .identifier attribute. +vector_db_id = client.vector_dbs.register( vector_db_id=vector_db_id, embedding_model=embedding_model, -) +).identifier # Create Documents urls = [