Skip to content

Mark SPE agent as deprecated #10697

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
dluces wants to merge 1 commit into
base: main
Choose a base branch
from
+18 −10
Open

Mark SPE agent as deprecated #10697

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/embedded/development/declarative-agent/spe-da-adv.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
15 changes: 9 additions & 6 deletions docs/embedded/development/declarative-agent/spe-da.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
8 changes: 4 additions & 4 deletions docs/toc.yml
View file
Open in desktop
Copy link
Collaborator

@andrewconnell andrewconnell Mar 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dluces Do we need to keep the link to the agent in the docs if it's been deprecated? The docs don't normally do that... so this PR should remove the TOC entries.

It's fine if the pages remain with the pointers to the replacement in Foundry

Copy link
Contributor Author

@dluces dluces Mar 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That makes sense, the idea was to provide some continuity. But that sounds good, I'll make this change

Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down