Mark SPE agent as deprecated

docs/embedded/development/declarative-agent/sharepoint-embedded-knowledge-source.md

@@ -11,23 +11,23 @@ ms.localizationpriority: high
 >
 > This functionality is currently in preview.
 
-This article configures a SPE container type with the necessary permission for an Azure AI Foundry agent to use it as a knowledge source.
+This article helps you configure [Microsoft Foundry Agent Service](/azure/foundry/agents/overview) with a [SharePoint knowledge source (Preview)](/azure/search/agentic-knowledge-source-how-to-sharepoint-remote) configured for SharePoint Embedded (SPE).
 
 ## Prerequisites
 
 - You have set up an SPE app with at least one container. To get started, learn more at [SharePoint Embedded Overview](../../overview.md).
-- You have at least one Copilot license on your tenant. This requirement is for the preview period only. We will switch to metered billing once we transition out of preview. 
+- You have at least one Copilot license on your tenant. This requirement is for the preview period only. We will switch to metered billing once we transition out of preview.
 
-## Grant Foundry access to a container type
+## Set up the SharePoint knowledge source for SharePoint Embedded
 
-Run the following to grant the necessary application permission using the Microsoft Graph API:
+The SharePoint knowledge source must be configured with the `remoteSharePointParameters.containerTypeId` pointing to your application's container type. For more information, see the [SharePoint knowledge source properties](/azure/search/agentic-knowledge-source-how-to-sharepoint-remote#source-specific-properties).
 
-Replace `{fileStorageContainerTypeId}` with your container type ID. The container type's owning application must call this API on a consuming tenant.
+## Grant Foundry access to a container type
 
-[Learn more about Container Type Registration API](/graph/api/filestoragecontainertyperegistration-post-applicationpermissiongrants)
+You also need to grant Microsoft Foundry the necessary application permission to access your container type. You can do this by updating the container type registration in your consuming tenants as shown below. Replace `{fileStorageContainerTypeId}` with your container type ID. The container type's owning application must call this API on consuming tenants.
 
 ```http
-PUT https://graph.microsoft.com/beta/storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}/applicationPermissionGrants/880da380-985e-4198-81b9-e05b1cc53158
+PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}/applicationPermissionGrants/880da380-985e-4198-81b9-e05b1cc53158
 Content-Type: application/json
 
 {
@@ -37,4 +37,4 @@ Content-Type: application/json
 ```
 
 > [!TIP]
-> This may also be done during initial container type registration using the Microsoft Graph endpoint [filestorage-post-containertyperegistrations](/graph/api/filestorage-post-containertyperegistrations).
+> This may also be done during initial container type registration using the [Create container type registration](/graph/api/filestorage-post-containertyperegistrations) endpoint.

docs/embedded/development/declarative-agent/spe-da-adv.md

@@ -1,12 +1,17 @@
 ---
 title: SharePoint Embedded agent Advanced Topics
 description: Learn how the semantic index powers Retrieval-Augmented Generation (RAG) to provide accurate, context-aware AI responses in SharePoint Embedded agent.
-ms.date: 06/10/2025
+ms.date: 03/17/2026
 ms.localizationpriority: high
 ---
 
 # SharePoint Embedded agent Advanced Topics Overview
 
+> [!CAUTION]
+> SharePoint Embedded agent has been deprecated in its current form and replaced with [Microsoft Foundry Agent Service](/azure/foundry/agents/overview) with a [SharePoint knowledge source (Preview)](/azure/search/agentic-knowledge-source-how-to-sharepoint-remote) configured for SharePoint Embedded. Learn how to [set up SharePoint Embedded as a knowledge source in Microsoft Foundry](sharepoint-embedded-knowledge-source.md).
+
+This article will remain in place for a limited time for historical reference.
+
 This advanced guide covers how the semantic index powers Retrieval-Augmented Generation (RAG) to provide accurate, context-aware AI responses. We explore how these concepts work together to ensure your agent retrieves relevant information from your data and returns grounded answers.
 
 ## Caveats

docs/embedded/development/declarative-agent/spe-da.md

@@ -1,21 +1,24 @@
 ---
-title: SharePoint Embedded agent 
+title: SharePoint Embedded agent (Deprecated)
 description: Details usage and billing for SharePoint Embedded agents
-ms.date: 05/12/2025
+ms.date: 03/17/2026
 ms.localizationpriority: high
 ---
 
 # Overview
 
+> [!CAUTION]
+> SharePoint Embedded agent has been deprecated in its current form and replaced with [Microsoft Foundry Agent Service](/azure/foundry/agents/overview) with a [SharePoint knowledge source (Preview)](/azure/search/agentic-knowledge-source-how-to-sharepoint-remote) configured for SharePoint Embedded. Learn how to [set up SharePoint Embedded as a knowledge source in Microsoft Foundry](sharepoint-embedded-knowledge-source.md).
+
+This article will remain in place for a limited time for historical reference.
+
 > [!NOTE]
 >
-> SharePoint Embedded agent is currently in private preview. Stay tuned for latest API and SDK changes on this page.
+> The SharePoint Embedded agent SDK is not suitable for production use cases.
 >
 > SPE agent consumption-based model will be available in May 2025! Starting May 1st, standard billing model will be available to all private preview customers and this rollout is expected to complete by May 15th. This means that starting May 15th, to use SPE agent within an SPE application, you will need to use standard Container Type. SPE Agent interactions, including those from Microsoft 365 Copilot license users, will be billed to the Azure subscription associated with your Container Type. Learn more about [SharePoint Embedded billing management](/sharepoint/dev/embedded/administration/billing/billingmanagement).
->
-> We are actively working on enabling Direct-to-Customer billing model for SPE agent. Stay tuned for more announcements.
 
-SharePoint Embedded agent enables you to add AI capabilities into your application through a simple SDK. This chat control offers the following features:
+SharePoint Embedded agent enables you to quickly demo AI capabilities into your application through a simple SDK, though it is not intended for production use. This chat control offers the following features:
 
 - Reason over documents in SharePoint Embedded containers using RAG.
 - Developers can configure the application code to limit the search scope to files, folders, and containers.

docs/toc.yml

@@ -656,14 +656,10 @@
         href: /training/modules/sharepoint-embedded-setup
       - name: SharePoint Embedded - building applications
         href: /training/modules/sharepoint-embedded-create-app
-  - name: SharePoint Embedded agent ( Private Preview )
+  - name: SharePoint Embedded agent
     items:
-    - name: SharePoint Embedded agent Overview
-      href: embedded/development/declarative-agent/spe-da.md
-    - name: SharePoint Embedded agent Tutorial
-      href: embedded/development/tutorials/spe-da-vscode.md
-    - name: SharePoint Embedded agent Advanced Topics
-      href: embedded/development/declarative-agent/spe-da-adv.md
+    - name: SharePoint Embedded knowledge source in Microsoft Foundry (Preview)
+      href: embedded/development/declarative-agent/sharepoint-embedded-knowledge-source.md
 - name: Microsoft Teams
   items:
   - name: Overview