From 4fb1c6db3a536404f78ddf39072f749615de2159 Mon Sep 17 00:00:00 2001 From: Diego Luces Date: Tue, 3 Mar 2026 16:05:27 -0800 Subject: [PATCH 1/3] Mark SPE agent as deprecated --- .../development/declarative-agent/spe-da-adv.md | 5 +++++ .../development/declarative-agent/spe-da.md | 15 +++++++++------ docs/toc.yml | 8 ++++---- 3 files changed, 18 insertions(+), 10 deletions(-) diff --git a/docs/embedded/development/declarative-agent/spe-da-adv.md b/docs/embedded/development/declarative-agent/spe-da-adv.md index 54b6c5c3a8..542e12f95d 100644 --- a/docs/embedded/development/declarative-agent/spe-da-adv.md +++ b/docs/embedded/development/declarative-agent/spe-da-adv.md @@ -7,6 +7,11 @@ 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?pivots=python) configured for SharePoint Embedded using the `container_type_id` [source-specific property](/azure/search/agentic-knowledge-source-how-to-sharepoint-remote?pivots=python#source-specific-properties). 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 diff --git a/docs/embedded/development/declarative-agent/spe-da.md b/docs/embedded/development/declarative-agent/spe-da.md index 3e7026291b..fd29760a1e 100644 --- a/docs/embedded/development/declarative-agent/spe-da.md +++ b/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/03/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?pivots=python) configured for SharePoint Embedded using the `container_type_id` [source-specific property](/azure/search/agentic-knowledge-source-how-to-sharepoint-remote?pivots=python#source-specific-properties). 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. Stay tuned for the next iteration of SharePoint Embedded agent. > > 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. diff --git a/docs/toc.yml b/docs/toc.yml index 551e034d96..640ccb94e5 100644 --- a/docs/toc.yml +++ b/docs/toc.yml @@ -656,13 +656,13 @@ 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 ( Deprecated ) items: - - name: SharePoint Embedded agent Overview + - name: SharePoint Embedded agent SDK ( Deprecated ) href: embedded/development/declarative-agent/spe-da.md - - name: SharePoint Embedded agent Tutorial + - name: SharePoint Embedded agent Tutorial ( Deprecated ) href: embedded/development/tutorials/spe-da-vscode.md - - name: SharePoint Embedded agent Advanced Topics + - name: SharePoint Embedded agent Advanced Topics ( Deprecated ) href: embedded/development/declarative-agent/spe-da-adv.md - name: Microsoft Teams items: From b306afb6fa2dba8fa1cc43dda9c3aac6eefd76dc Mon Sep 17 00:00:00 2001 From: Diego Luces Date: Tue, 17 Mar 2026 15:39:46 -0700 Subject: [PATCH 2/3] Expand SPE knowledge source article --- .../sharepoint-embedded-knowledge-source.md | 16 ++++++++-------- docs/toc.yml | 10 +++------- 2 files changed, 11 insertions(+), 15 deletions(-) diff --git a/docs/embedded/development/declarative-agent/sharepoint-embedded-knowledge-source.md b/docs/embedded/development/declarative-agent/sharepoint-embedded-knowledge-source.md index d4af38b4ad..52e2f34c4e 100644 --- a/docs/embedded/development/declarative-agent/sharepoint-embedded-knowledge-source.md +++ b/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. diff --git a/docs/toc.yml b/docs/toc.yml index 640ccb94e5..611d88ef40 100644 --- a/docs/toc.yml +++ b/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 ( Deprecated ) + - name: SharePoint Embedded agent items: - - name: SharePoint Embedded agent SDK ( Deprecated ) - href: embedded/development/declarative-agent/spe-da.md - - name: SharePoint Embedded agent Tutorial ( Deprecated ) - href: embedded/development/tutorials/spe-da-vscode.md - - name: SharePoint Embedded agent Advanced Topics ( Deprecated ) - 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 From bea317fef25126816e802b7dce501b7325617d54 Mon Sep 17 00:00:00 2001 From: Diego Luces Date: Tue, 17 Mar 2026 15:44:52 -0700 Subject: [PATCH 3/3] Improve deprecation notices in SPE agent SDK pages --- docs/embedded/development/declarative-agent/spe-da-adv.md | 4 ++-- docs/embedded/development/declarative-agent/spe-da.md | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/embedded/development/declarative-agent/spe-da-adv.md b/docs/embedded/development/declarative-agent/spe-da-adv.md index 542e12f95d..9caedb69b4 100644 --- a/docs/embedded/development/declarative-agent/spe-da-adv.md +++ b/docs/embedded/development/declarative-agent/spe-da-adv.md @@ -1,14 +1,14 @@ --- 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?pivots=python) configured for SharePoint Embedded using the `container_type_id` [source-specific property](/azure/search/agentic-knowledge-source-how-to-sharepoint-remote?pivots=python#source-specific-properties). Learn how to [set up SharePoint Embedded as a knowledge source in Microsoft Foundry](sharepoint-embedded-knowledge-source.md). +> 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. diff --git a/docs/embedded/development/declarative-agent/spe-da.md b/docs/embedded/development/declarative-agent/spe-da.md index fd29760a1e..76047def79 100644 --- a/docs/embedded/development/declarative-agent/spe-da.md +++ b/docs/embedded/development/declarative-agent/spe-da.md @@ -1,20 +1,20 @@ --- title: SharePoint Embedded agent (Deprecated) description: Details usage and billing for SharePoint Embedded agents -ms.date: 03/03/2026 +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?pivots=python) configured for SharePoint Embedded using the `container_type_id` [source-specific property](/azure/search/agentic-knowledge-source-how-to-sharepoint-remote?pivots=python#source-specific-properties). Learn how to [set up SharePoint Embedded as a knowledge source in Microsoft Foundry](sharepoint-embedded-knowledge-source.md). +> 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] > -> The SharePoint Embedded agent SDK is not suitable for production use cases. Stay tuned for the next iteration of SharePoint Embedded agent. +> 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).