Merge pull request #7613 from MicrosoftDocs/main

Auto Publish – main to live - 2025-10-10 22:10 UTC

Author: learn-build-service-prod[bot]

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

@@ -7,7 +7,7 @@ author: HeidiSteen
 ms.author: heidist
 ms.service: azure-ai-search
 ms.topic: how-to
-ms.date: 08/29/2025
+ms.date: 10/10/2025
 ---
 
 # Create a blob knowledge source
@@ -219,19 +219,7 @@ After the knowledge agent is configured, use the retrieve action to query the kn
 
 ## Delete a knowledge source
 
-If you no longer need the knowledge source, or if you need to rebuild it on the search service, use this request to delete the current object.
-
-```http
-# Delete agent
-DELETE {{search-url}}/knowledgeSources/{{ks-name}}?api-version=2025-08-01-preview
-api-key: {{api-key}}
-```
-
-> [!IMPORTANT]
-> Before you can delete a knowledge source, you must first update the knowledge agent to remove all references to the knowledge source.
->
-> Deleting a blob knowledge source also deletes the objects it created. The indexer, data source, skillset, and index are automatically deleted when the blob knowledge source is deleted.
->
+[!INCLUDE [Delete knowledge source](includes/how-tos/knowledge-source-delete-rest.md)]
 
 ## Learn more
 

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

@@ -7,7 +7,7 @@ author: HeidiSteen
 ms.author: heidist
 ms.service: azure-ai-search
 ms.topic: how-to
-ms.date: 08/29/2025
+ms.date: 10/10/2025
 ---
 
 # Create a search index knowledge source
@@ -121,13 +121,7 @@ Within the knowledge agent, there are more properties to set on the knowledge so
 
 ## Delete a knowledge source
 
-If you no longer need the knowledge source, or if you need to rebuild it on the search service, use this request to delete the current object.
-
-```http
-# Delete agent
-DELETE {{search-url}}/knowledgeSources/{{ks-name}}?api-version=2025-08-01-preview
-api-key: {{api-key}}
-```
+[!INCLUDE [Delete knowledge source](includes/how-tos/knowledge-source-delete-rest.md)]
 
 ## Learn more
 

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

@@ -46,7 +46,7 @@ A platform-specific knowledge source like the blob knowledge source includes spe
 > [!NOTE]
 > `WebKnowledgeSource` (also referred to as `WebParameters` in REST APIs) isn't currently operational in the 2025-08-01-preview.
 
-## Create a knowledge source
+## Creating knowledge sources
 
 You must have [**Search Service Contributor** permissions](search-security-rbac.md) to create objects on a search service.  You also need **Search Index Data Contributor** permissions to load an index if you're using a knowledge source that creates an indexer pipeline. Alternatively, you can [use an API admin key](search-security-api-keys.md) instead of roles.
 
@@ -57,7 +57,7 @@ You must use the REST API or an Azure SDK preview package to create a knowledge
 
 After the knowledge source is created, you can reference it in a knowledge agent.
 
-## Use a knowledge source
+## Using knowledge sources
 
 Properties on the [*knowledge agent*](agentic-retrieval-how-to-create-knowledge-base.md) determine whether and how the knowledge source is used.
 
@@ -113,36 +113,3 @@ 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](agentic-retrieval-how-to-retrieve.md), provide a single message query that's fewer than 512 characters.
-
-## Delete a knowledge source
-
-Before you can delete a knowledge source, you must delete or update any knowledge agent that references it. The associated index is a standalone object in Azure AI Search and doesn't need to be deleted or updated in tandem with the knowledge source, but no references to the knowledge source can exist if you want to delete it.
-
-If you try to delete a knowledge source that's in use, the action fails and a list of affected knowledge agents is returned.
-
-1. Get the knowledge agent definition to confirm knowledge source references.
-
-    ```http
-    ### Get the knowledge agent
-    GET {{search-endpoint}}/agents/hotels-index-ka?api-version=2025-08-01-preview
-    api-key: {{api-key}}
-    Content-Type: application/json
-    ```
-
-1. Either update the knowledge agent by removing the knowledge source, or delete the knowledge agent. This example shows deletion.
-
-    ```http
-    ### Delete knowledge agent
-    DELETE {{search-endpoint}}/agents/hotels-index-ka?api-version=2025-08-01-preview
-    api-key: {{api-key}}
-    Content-Type: application/json
-    ```
-
-1. Delete the knowledge source.
-
-    ```http
-    ### Delete a knowledge source definition
-    GET {{search-endpoint}}/knowledgeSources/hotels-index-ks?api-version=2025-08-01-preview
-    api-key: {{api-key}}
-    Content-Type: application/json
-    ```

articles/search/includes/how-tos/knowledge-source-delete-rest.md

@@ -0,0 +1,89 @@
+---
+manager: nitinme
+author: heidisteen
+ms.author: heidist
+ms.service: azure-ai-search
+ms.topic: include
+ms.date: 10/10/2025
+---
+
+If you no longer need the knowledge source, or if you need to rebuild it on the search service, use this request to delete the current object.
+
+Before you can delete a knowledge source, you must delete any knowledge agent that references it, or remote the references in an update action. The associated index and any indexer pipeline objects created from the knowledge source are standalone objects and don't need to be deleted or updated in tandem with the knowledge source.
+
+If you try to delete a knowledge source that's in use, the action fails and a list of affected knowledge agents is returned.
+
+1. Start by getting a list of all knowledge agents. This request returns all knowledge agents on your search service.
+
+    ```http
+    ### Get the knowledge agent
+    GET {{search-endpoint}}/agents?api-version=2025-08-01-preview&$select=name
+    api-key: {{api-key}}
+    Content-Type: application/json
+    ```
+
+   An example response might look like the following:
+
+   ```json
+    {
+        "@odata.context": "https://my-demo-search-service.search.windows.net/$metadata#agents(name)",
+        "value": [
+        {
+            "name": "earth-blob-ka"
+        },
+        {
+            "name": "hotels-sample-ka"
+        }
+        ]
+    }
+   ```
+
+1. Get the individual knowledge agent definition to check for knowledge source references.
+
+    ```http
+    GET {{search-endpoint}}/agents/hotels-sample-ka?api-version=2025-08-01-preview
+    api-key: {{api-key}}
+    Content-Type: application/json
+    ```
+
+   An example response might look like the following:
+
+   ```json
+    {
+      "name": "hotels-sample-ka",
+      "description": null,
+      "retrievalInstructions": null,
+      "knowledgeSources": [
+        {
+          "name": "hotels-sample-ks",
+          "alwaysQuerySource": false,
+          "includeReferences": true,
+          "includeReferenceSourceData": false,
+          "maxSubQueries": null,
+          "rerankerThreshold": null
+        }
+      ],
+      "models": [ trimmed for brevity ],
+      "outputConfiguration": { trimmed for brevity },
+      "requestLimits": { trimmed for brevity},
+      "encryptionKey": null
+    }
+   ```
+
+1. Either [update the knowledge agent](/rest/api/searchservice/knowledge-agents/create-or-update?view=rest-searchservice-2025-08-01-preview&preserve-view=true) by removing the knowledge source if you have multiple sources, or delete the knowledge agent. This example shows deletion.
+
+    ```http
+    ### Delete knowledge agent
+    DELETE {{search-endpoint}}/agents/hotels-sample-ka?api-version=2025-08-01-preview
+    api-key: {{api-key}}
+    Content-Type: application/json
+    ```
+
+1. Delete the knowledge source.
+
+    ```http
+    ### Delete a knowledge source definition
+    GET {{search-endpoint}}/knowledgeSources/hotels-sample-ks?api-version=2025-08-01-preview
+    api-key: {{api-key}}
+    Content-Type: application/json
+    ```