[Search] Refresh azure-search-documents samples for 2026-04-01 GA (#46677)

- Add sample_knowledge_source_crud(.py/_async.py) and
  sample_knowledge_base_crud(.py/_async.py) as CRUD reference samples.
- Refocus sample_agentic_retrieval(.py/_async.py) on the end-to-end
  retrieval flow (setup KS+KB, retrieve, cleanup) and cross-reference
  the CRUD samples for full lifecycle coverage.
- Unify sample resource naming on the hotels-sample-* convention
  across alias, vector profile/HNSW configs, KS, KB, semantic config,
  and indexer data source samples.
- Fix sample_query_vector(.py/_async.py) post-upload race by polling
  get_document_count before issuing the first query.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: hizixin

sdk/search/azure-search-documents/samples/sample_agentic_retrieval.py

@@ -7,8 +7,13 @@
 
 """
 DESCRIPTION:
-    Demonstrates Knowledge Source and Knowledge Base CRUD operations and
-    a minimal retrieval query using a semantic intent.
+    Demonstrates the end-to-end agentic retrieval scenario: create a knowledge
+    source over an existing search index, create a knowledge base that
+    references it, query the knowledge base with a semantic intent, and clean
+    up.
+
+    For knowledge source / knowledge base CRUD details (get, update, list),
+    see sample_knowledge_source_crud.py and sample_knowledge_base_crud.py.
 
 USAGE:
     python sample_agentic_retrieval.py
@@ -24,18 +29,15 @@
 import os
 
 from azure.core.credentials import AzureKeyCredential
-from azure.core.exceptions import ResourceNotFoundError
 from azure.search.documents.indexes import SearchIndexClient
 from azure.search.documents.knowledgebases import KnowledgeBaseRetrievalClient
 from azure.search.documents.knowledgebases.models import (
     KnowledgeBaseRetrievalRequest,
     KnowledgeRetrievalSemanticIntent,
-    KnowledgeRetrievalMinimalReasoningEffort,
 )
 from azure.search.documents.indexes.models import (
     KnowledgeBase,
     KnowledgeSourceReference,
-    SearchIndexFieldReference,
     SearchIndexKnowledgeSource,
     SearchIndexKnowledgeSourceParameters,
 )
@@ -48,111 +50,35 @@
 knowledge_base_name = "hotels-sample-knowledge-base"
 
 
-def create_knowledge_source():
-    # [START create_knowledge_source]
+def setup_knowledge_base():
     index_client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
 
     knowledge_source = SearchIndexKnowledgeSource(
         name=knowledge_source_name,
         search_index_parameters=SearchIndexKnowledgeSourceParameters(search_index_name=index_name),
     )
-
     index_client.create_or_update_knowledge_source(knowledge_source=knowledge_source)
     print(f"Created: knowledge source '{knowledge_source_name}'")
-    # [END create_knowledge_source]
-
-
-def get_knowledge_source():
-    # [START get_knowledge_source]
-    index_client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
-
-    knowledge_source = index_client.get_knowledge_source(knowledge_source_name)
-    print(f"Retrieved: knowledge source '{knowledge_source.name}'")
-    # [END get_knowledge_source]
-
-
-def update_knowledge_source():
-    # [START update_knowledge_source]
-    index_client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
-
-    knowledge_source = SearchIndexKnowledgeSource(
-        name=knowledge_source_name,
-        search_index_parameters=SearchIndexKnowledgeSourceParameters(
-            search_index_name=index_name,
-            source_data_fields=[
-                SearchIndexFieldReference(name="HotelId"),
-                SearchIndexFieldReference(name="HotelName"),
-                SearchIndexFieldReference(name="Description"),
-                SearchIndexFieldReference(name="Category"),
-                SearchIndexFieldReference(name="Tags"),
-            ],
-        ),
-    )
-
-    index_client.create_or_update_knowledge_source(knowledge_source=knowledge_source)
-    print(f"Updated: knowledge source '{knowledge_source_name}'")
-    # [END update_knowledge_source]
-
-
-def delete_knowledge_source():
-    # [START delete_knowledge_source]
-    index_client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
-    try:
-        index_client.delete_knowledge_source(knowledge_source_name)
-        print(f"Deleted: knowledge source '{knowledge_source_name}'")
-    except ResourceNotFoundError:
-        print(f"Skipped: knowledge source '{knowledge_source_name}' not found")
-    # [END delete_knowledge_source]
-
-
-def create_knowledge_base():
-    # [START create_knowledge_base]
-    index_client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
 
     knowledge_base = KnowledgeBase(
         name=knowledge_base_name,
         knowledge_sources=[KnowledgeSourceReference(name=knowledge_source_name)],
     )
-
     index_client.create_or_update_knowledge_base(knowledge_base)
     print(f"Created: knowledge base '{knowledge_base_name}'")
-    # [END create_knowledge_base]
-
-
-def get_knowledge_base():
-    # [START get_knowledge_base]
-    index_client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
-
-    knowledge_base = index_client.get_knowledge_base(knowledge_base_name)
-    print(f"Retrieved: knowledge base '{knowledge_base.name}'")
-    # [END get_knowledge_base]
-
-
-def update_knowledge_base():
-    # [START update_knowledge_base]
-    index_client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
-
-    knowledge_base = KnowledgeBase(
-        name=knowledge_base_name,
-        knowledge_sources=[KnowledgeSourceReference(name=knowledge_source_name)],
-        retrieval_reasoning_effort=KnowledgeRetrievalMinimalReasoningEffort(),
-    )
-
-    index_client.create_or_update_knowledge_base(knowledge_base)
-    print(f"Updated: knowledge base '{knowledge_base_name}'")
-    # [END update_knowledge_base]
 
 
 def retrieve_knowledge_base():
     # [START retrieve_knowledge_base]
     retrieval_client = KnowledgeBaseRetrievalClient(
         service_endpoint,
         credential=AzureKeyCredential(key),
+        knowledge_base_name=knowledge_base_name,
     )
 
     request = KnowledgeBaseRetrievalRequest(intents=[KnowledgeRetrievalSemanticIntent(search="hotels with free wifi")])
 
-    result = retrieval_client.retrieve(knowledge_base_name=knowledge_base_name, retrieval_request=request)
+    result = retrieval_client.retrieve(request)
     print("Results: knowledge base retrieval")
 
     response_parts = []
@@ -162,9 +88,7 @@ def retrieve_knowledge_base():
                 response_parts.append(content.text)
 
     if response_parts:
-        response_content = "\n\n".join(response_parts)
-
-        items = json.loads(response_content)
+        items = json.loads("\n\n".join(response_parts))
         for i, item in enumerate(items[:5], start=1):
             print(f"  Result {i}:")
             print(f"    Title: {item.get('title')}")
@@ -174,24 +98,15 @@ def retrieve_knowledge_base():
     # [END retrieve_knowledge_base]
 
 
-def delete_knowledge_base():
-    # [START delete_knowledge_base]
+def cleanup():
     index_client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
-    try:
-        index_client.delete_knowledge_base(knowledge_base_name)
-        print(f"Deleted: knowledge base '{knowledge_base_name}'")
-    except ResourceNotFoundError:
-        print(f"Skipped: knowledge base '{knowledge_base_name}' not found")
-    # [END delete_knowledge_base]
+    index_client.delete_knowledge_base(knowledge_base_name)
+    print(f"Deleted: knowledge base '{knowledge_base_name}'")
+    index_client.delete_knowledge_source(knowledge_source_name)
+    print(f"Deleted: knowledge source '{knowledge_source_name}'")
 
 
 if __name__ == "__main__":
-    create_knowledge_source()
-    get_knowledge_source()
-    update_knowledge_source()
-    create_knowledge_base()
-    get_knowledge_base()
-    update_knowledge_base()
+    setup_knowledge_base()
     retrieve_knowledge_base()
-    delete_knowledge_base()
-    delete_knowledge_source()
+    cleanup()