Merge pull request #7551 from HeidiSteen/heidist-bulk-edit-file-rename

[azure search] BULK EDIT file rename

Author: AnnaMHuff

articles/search/.openpublishing.redirection.search.json

@@ -357,8 +357,8 @@
         },
         {
             "source_path_from_root": "/articles/search/search-howto-index-documentdb.md",
-            "redirect_url": "/azure/search/search-howto-index-cosmosdb",
-            "redirect_document_id": true
+            "redirect_url": "/azure/search/search-how-to-index-cosmosdb-sql",
+            "redirect_document_id": false
         },
         {
             "source_path_from_root": "/articles/search/search-create-index-portal.md",
@@ -460,6 +460,141 @@
             "source_path_from_root": "/articles/search/search-reliability.md",
             "redirect_url": "/azure/reliability/reliability-ai-search",
             "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/search/search-agentic-retrieval-concept.md",
+            "redirect_url": "/azure/search/agentic-retrieval-overview",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-agentic-retrieval-how-to-create.md",
+            "redirect_url": "/azure/search/agentic-retrieval-how-to-create-knowledge-base",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-agentic-retrieval-how-to-index.md",
+            "redirect_url": "/azure/search/agentic-retrieval-how-to-create-index",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-agentic-retrieval-how-to-migrate.md",
+            "redirect_url": "/azure/search/agentic-retrieval-how-to-migrate",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-agentic-retrieval-how-to-pipeline.md",
+            "redirect_url": "/azure/search/agentic-retrieval-how-to-create-pipeline",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-agentic-retrieval-how-to-retrieve.md",
+            "redirect_url": "/azure/search/agentic-retrieval-how-to-retrieve",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-agentic-retrieval-how-to-synthesize.md",
+            "redirect_url": "/azure/search/agentic-retrieval-how-to-answer-synthesis",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-knowledge-source-how-to-blob.md",
+            "redirect_url": "/azure/search/agentic-knowledge-source-how-to-blob",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-knowledge-source-how-to-index.md",
+            "redirect_url": "/azure/search/agentic-knowledge-source-how-to-search-index",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-knowledge-source-overview.md",
+            "redirect_url": "/azure/search/agentic-knowledge-source-overview",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-azure-data-lake-storage.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-data-lake-storage",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-changed-deleted-blobs.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-blob-changed-deleted",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-cosmosdb-gremlin.md",
+            "redirect_url": "/azure/search/search-how-to-index-cosmosdb-gremlin",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-cosmosdb-mongodb.md",
+            "redirect_url": "/azure/search/search-how-to-index-cosmosdb-mongodb",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-cosmosdb.md",
+            "redirect_url": "/azure/search/search-how-to-index-cosmosdb-sql",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-how-to-index-csv-blobs.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-blob-csv",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-encrypted-blobs.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-blob-encrypted",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-json-blobs.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-blob-json",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-mysql.md",
+            "redirect_url": "/azure/search/search-how-to-index-mysql",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-one-to-many-blobs.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-blob-one-to-many",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-plaintext-blobs.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-blob-plaintext",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-index-sharepoint-online.md",
+            "redirect_url": "/azure/search/search-how-to-index-sharepoint-online",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-indexing-azure-blob-storage.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-blob-storage",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-howto-indexing-azure-tables.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-tables",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-index-azure-sql-managed-instance-with-managed-identity.md",
+            "redirect_url": "/azure/search/search-how-to-index-sql-managed-instance-with-managed-identity",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-how-to-index-markdown-blobs.md",
+            "redirect_url": "/azure/search/search-how-to-index-azure-blob-markdown",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-how-to-index-logic-apps-indexers.md",
+            "redirect_url": "/azure/search/search-how-to-index-logic-apps",
+            "redirect_document_id": true
         }
     ]
   }

articles/search/search-knowledge-source-how-to-blob.md renamed to articles/search/agentic-knowledge-source-how-to-blob.md

@@ -14,9 +14,9 @@ ms.date: 08/29/2025
 
 [!INCLUDE [Feature preview](./includes/previews/preview-generic.md)]
 
-A *blob knowledge source* specifies all of the information necessary for indexing and querying multimodal Azure blob content in an Azure AI Search agentic pipeline. It's created independently, and then referenced by a [knowledge agent](search-agentic-retrieval-how-to-create.md) and used at query time when an agent or chat bot calls a [retrieve](/rest/api/searchservice/knowledge-retrieval/retrieve?view=rest-searchservice-2025-08-01-preview&preserve-view=true) action.
+A *blob knowledge source* specifies all of the information necessary for indexing and querying multimodal Azure blob content in an Azure AI Search agentic pipeline. It's created independently, and then referenced by a [knowledge agent](agentic-retrieval-how-to-create-knowledge-base.md) and used at query time when an agent or chat bot calls a [retrieve](/rest/api/searchservice/knowledge-retrieval/retrieve?view=rest-searchservice-2025-08-01-preview&preserve-view=true) action.
 
-In contrast with a [search index knowledge source](search-knowledge-source-how-to-index.md) that specifies an existing and qualified index, a blob knowledge source specifies an external data source (a blob container) plus models and properties that are used to create an entire enrichment pipeline:
+In contrast with a [search index knowledge source](agentic-knowledge-source-how-to-search-index.md) that specifies an existing and qualified index, a blob knowledge source specifies an external data source (a blob container) plus models and properties that are used to create an entire enrichment pipeline:
 
 + The generated data source specifies the blob container
 + The generated skillset chunks and vectorizes multimodal content
@@ -29,7 +29,7 @@ Knowledge sources are new in the 2025-08-01-preview release.
 
 ## Prerequisites
 
-+ Azure Storage with a blob container containing [supported content types](search-howto-indexing-azure-blob-storage.md#supported-document-formats) for text content. For images, the supported content type depends on your chat completion model and whether it can analyze and describe the image file.
++ Azure Storage with a blob container containing [supported content types](search-how-to-index-azure-blob-storage.md#supported-document-formats) for text content. For images, the supported content type depends on your chat completion model and whether it can analyze and describe the image file.
 
 + Azure AI Search, basic tier or higher, configured for semantic ranker.
 
@@ -114,7 +114,7 @@ A response for blob knowledge source might look like the following example.
 
 ## Create a knowledge source
 
-To create a [knowledge source](search-knowledge-source-overview.md), use the 2025-08-01-preview data plane REST API or an Azure SDK preview package that provides equivalent functionality.
+To create a [knowledge source](agentic-knowledge-source-overview.md), use the 2025-08-01-preview data plane REST API or an Azure SDK preview package that provides equivalent functionality.
 
 A knowledge source can contain exactly one of the following: `searchIndexParameters` *or* `azureBlobParameters`. The `webParameters` property isn't supported in this release. If you specify `azureBlobParameters`, then `searchIndexParameters` must be null.
 
@@ -211,7 +211,7 @@ We recommend using the Azure portal to validate output creation.
 
 ## Assign to a knowledge agent
 
-If you're satisfied with the index, continue to the next step: specify the knowledge source in a [knowledge agent](search-agentic-retrieval-how-to-create.md).
+If you're satisfied with the index, continue to the next step: specify the knowledge source in a [knowledge agent](agentic-retrieval-how-to-create-knowledge-base.md).
 
 Within the knowledge agent, there are more properties to set on the knowledge source that are specific to query operations.
 
@@ -237,7 +237,7 @@ api-key: {{api-key}}
 
 + [Azure AI Search Blob knowledge source Python sample](https://github.com/Azure/azure-search-vector-samples/blob/main/demo-python/code/knowledge/blob-knowledge-source.ipynb)
 
-+ [Agentic retrieval in Azure AI Search](search-agentic-retrieval-concept.md)
++ [Agentic retrieval in Azure AI Search](agentic-retrieval-overview.md)
 
 + [Agentic RAG: build a reasoning retrieval engine with Azure AI Search (YouTube video)](https://www.youtube.com/watch?v=PeTmOidqHM8)
 

articles/search/search-knowledge-source-how-to-index.md renamed to articles/search/agentic-knowledge-source-how-to-search-index.md

@@ -14,13 +14,13 @@ ms.date: 08/29/2025
 
 [!INCLUDE [Feature preview](./includes/previews/preview-generic.md)]
 
-A *search index knowledge source* specifies a connection to a search index on Azure AI Search that provides searchable content in an agentic retrieval pipeline. It's created independently, and then referenced by a [knowledge agent](search-agentic-retrieval-how-to-create.md) and used at query time when an agent or chat bot calls a [retrieve](/rest/api/searchservice/knowledge-retrieval/retrieve?view=rest-searchservice-2025-08-01-preview&preserve-view=true) action.
+A *search index knowledge source* specifies a connection to a search index on Azure AI Search that provides searchable content in an agentic retrieval pipeline. It's created independently, and then referenced by a [knowledge agent](agentic-retrieval-how-to-create-knowledge-base.md) and used at query time when an agent or chat bot calls a [retrieve](/rest/api/searchservice/knowledge-retrieval/retrieve?view=rest-searchservice-2025-08-01-preview&preserve-view=true) action.
 
 Knowledge sources are new in the 2025-08-01-preview release.
 
 ## Prerequisites
 
-You need a search index containing plain text or vector content, with a semantic configuration. [Review index criteria for agentic retrieval](search-agentic-retrieval-how-to-index.md#criteria-for-agentic-retrieval). The search index must be on the same search service as the knowledge agent.
+You need a search index containing plain text or vector content, with a semantic configuration. [Review index criteria for agentic retrieval](agentic-retrieval-how-to-create-index.md#criteria-for-agentic-retrieval). The search index must be on the same search service as the knowledge agent.
 
 To try the examples in this article, we recommend [Visual Studio Code](https://code.visualstudio.com/download) with a [REST client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) for sending preview REST API calls to Azure AI Search. There's no portal support at this time.
 
@@ -69,13 +69,13 @@ An example response for a `searchIndex` knowledge source might look like the fol
 
 ## Create a knowledge source
 
-To create a [knowledge source](search-knowledge-source-overview.md), use the 2025-08-01-preview data plane REST API or an Azure SDK preview package that provides equivalent functionality.
+To create a [knowledge source](agentic-knowledge-source-overview.md), use the 2025-08-01-preview data plane REST API or an Azure SDK preview package that provides equivalent functionality.
 
 A knowledge source can contain exactly one of the following: `searchIndexParameters` *or* `azureBlobParameters`. The `webParameters` property isn't supported in this release. If you specify `searchIndexParameters`, then `azureBlobParameters` must be null.
 
 For `searchIndexParameters`:
 
-+ Choose an index [designed for agentic retrieval](search-agentic-retrieval-how-to-index.md)
++ Choose an index [designed for agentic retrieval](agentic-retrieval-how-to-create-index.md)
 + Specify any `retrievable` fields that can be used for citations, such as a file name or page number.
 
 1. Use the [Create or Update Knowledge Source](/rest/api/searchservice/knowledge-sources/create-or-update?view=rest-searchservice-2025-08-01-preview&preserve-view=true) preview REST API.
@@ -115,7 +115,7 @@ For `searchIndexParameters`:
 
 ## Assign to a knowledge agent
 
-If you're satisfied with the index, continue to the next step: specifying the knowledge source in a [knowledge agent](search-agentic-retrieval-how-to-create.md).
+If you're satisfied with the index, continue to the next step: specifying the knowledge source in a [knowledge agent](agentic-retrieval-how-to-create-knowledge-base.md).
 
 Within the knowledge agent, there are more properties to set on the knowledge source that are specific to query operations.
 
@@ -131,7 +131,7 @@ api-key: {{api-key}}
 
 ## Learn more
 
-+ [Agentic retrieval in Azure AI Search](search-agentic-retrieval-concept.md)
++ [Agentic retrieval in Azure AI Search](agentic-retrieval-overview.md)
 
 + [Agentic RAG: build a reasoning retrieval engine with Azure AI Search (YouTube video)](https://www.youtube.com/watch?v=PeTmOidqHM8)
 

articles/search/search-knowledge-source-overview.md renamed to articles/search/agentic-knowledge-source-overview.md

@@ -28,16 +28,16 @@ Make sure you have at least one knowledge source before creating a knowledge age
 
 + A knowledge source, its index, and the knowledge agent must all exist on the same search service.
 
-+ Each knowledge source points to exactly one index, and that index must [meet the criteria for agentic retrieval](search-agentic-retrieval-how-to-index.md).
++ Each knowledge source points to exactly one index, and that index must [meet the criteria for agentic retrieval](agentic-retrieval-how-to-create-index.md).
 
 + For each knowledge source, the knowledge agent provides extra properties for query execution. [KnowledgeSourceReference](/rest/api/searchservice/knowledge-agents/create-or-update#knowledgesourcereference?view=rest-searchservice-2025-08-01-preview&preserve-view=true) properties affect query planning. [KnowledgeAgentOutputConfiguration](/rest/api/searchservice/knowledge-agents/create-or-update#knowledgeagentoutputconfiguration?view=rest-searchservice-2025-08-01-preview&preserve-view=true) properties affect query output.
 
 ## Supported knowledge sources
 
 Here are the knowledge sources you can create in this preview:
 
-+ [Search index knowledge source (an existing index)](search-knowledge-source-how-to-index.md)
-+ [Blob knowledge source](search-knowledge-source-how-to-blob.md)
++ [Search index knowledge source (an existing index)](agentic-knowledge-source-how-to-search-index.md)
++ [Blob knowledge source](agentic-knowledge-source-how-to-blob.md)
 
 A platform-specific knowledge source like the blob knowledge source includes specifications for generating an entire indexing pipeline that provides all extraction, enrichment and transformations over blob content, and a viable index. You can modify the pipeline and rerun the indexer, but you can't rename the objects.
 
@@ -93,7 +93,7 @@ To achieve the fastest possible response times, follow these best practices:
 
    + Set `knowledgeSources.includeReferenceSourceData` to false if you don't need the verbatim content from the index. Omitting this information simplifies the response and makes it more readable.
 
-1. In the [retrieve action](search-agentic-retrieval-how-to-retrieve.md), provide a single message query that's fewer than 512 characters.
+1. In the [retrieve action](agentic-retrieval-how-to-retrieve.md), provide a single message query that's fewer than 512 characters.
 
 ## Delete a knowledge source