Skip to content

Commit 1345dee

Browse files
authored
[All Hosts] (devx) Teams Toolkit becoming Agents Toolkit (#5167)
* [All Hosts] (devx) Teams Toolkit becoming Agents Toolkit * fix bookmarks * removing 'the' from tool name * CLI name change * link fix * toc * rename file * format
1 parent 404bfc6 commit 1345dee

26 files changed

+100
-96
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
11
{
22
"redirections": [
3-
{
3+
{
4+
"source_path": "docs/develop/teams-toolkit-overview.md",
5+
"redirect_url": "/office/dev/add-ins/develop/agents-toolkit-overview"
6+
},
7+
{
48
"source_path": "docs/develop/grant-admin-consent-to-an-add-in.md",
59
"redirect_url": "/entra/identity-platform/quickstart-configure-app-access-web-apis#more-on-api-permissions-and-admin-consent"
610
},

docs/develop/teams-toolkit-overview.md renamed to docs/develop/agents-toolkit-overview.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
2-
title: Create Office Add-in projects using Teams Toolkit
3-
description: Learn how to create Office Add-in projects using Teams Toolkit.
4-
ms.date: 04/10/2025
2+
title: Create Office Add-in projects using Microsoft 365 Agents Toolkit
3+
description: Learn how to create Office Add-in projects using Microsoft 365 Agents Toolkit.
4+
ms.date: 05/19/2025
55
ms.localizationpriority: high
66
---
77

8-
# Create Office Add-in projects with Teams Toolkit
8+
# Create Office Add-in projects with Microsoft 365 Agents Toolkit
99

10-
A primary tool for developing Teams Apps is Teams Toolkit. You can create Office Add-ins with Teams Toolkit.
10+
A primary tool for developing Microsoft 365 apps and agents, including Office Add-ins, is Microsoft 365 Agents Toolkit.
1111

12-
Add-ins created with Teams Toolkit use the [unified manifest for Microsoft 365](unified-manifest-overview.md).
12+
Add-ins created with Agents Toolkit use the [unified manifest for Microsoft 365](unified-manifest-overview.md).
1313

1414
[!INCLUDE [Unified manifest support note for Office applications](../includes/unified-manifest-support-note.md)]
1515

@@ -18,28 +18,28 @@ Add-ins created with Teams Toolkit use the [unified manifest for Microsoft 365](
1818
1919
[!INCLUDE [non-unified manifest clients note](../includes/non-unified-manifest-clients.md)]
2020

21-
Install the latest version of Teams Toolkit into Visual Studio Code as described in [Install Teams Toolkit](/microsoftteams/platform/toolkit/install-teams-toolkit?tabs=vscode).
21+
Install the latest version of Agents Toolkit into Visual Studio Code as described in [Install Microsoft 365 Agents Toolkit](/microsoftteams/platform/toolkit/install-teams-toolkit?tabs=vscode).
2222

2323
> [!IMPORTANT]
24-
> You can create an Outlook add-in with the latest released version of Teams Toolkit. To create an add-in for Excel, PowerPoint, or Word, install the prerelease version as described in [Install a prerelease version](/microsoftteams/platform/toolkit/install-teams-toolkit?tabs=vscode#install-a-prerelease-version). The toolkit creates projects that use the [unified manifest for Microsoft 365](json-manifest-overview.md). Support for this manifest in Excel, PowerPoint, and Word is preview only.
24+
> You can create an Outlook add-in with the latest released version of Agents Toolkit. To create an add-in for Excel, PowerPoint, or Word, install the prerelease version as described in [Install a prerelease version](/microsoftteams/platform/toolkit/install-teams-toolkit?tabs=vscode#install-a-prerelease-version). The toolkit creates projects that use the [unified manifest for Microsoft 365](json-manifest-overview.md). Support for this manifest in Excel, PowerPoint, and Word is preview only.
2525
2626
## Create an Office Add-in project
2727

28-
1. Open Visual Studio Code and select Teams Toolkit icon in the **Activity Bar**.
28+
1. Open Visual Studio Code and select the Agents Toolkit icon in the **Activity Bar**.
2929

30-
:::image type="content" source="../images/teams-toolkit-icon.png" alt-text="Teams Toolkit icon.":::
30+
:::image type="content" source="../images/atk-toolkit-icon.png" alt-text="Agents Toolkit icon.":::
3131

3232
1. Select **Create a New App**.
33-
1. The **New Project** dropdown menu opens. The options listed will vary depending on your version of Teams Toolkit. Select **Office Add-in**.
33+
1. The **New Project** dropdown menu opens. The options listed will vary depending on your version of Agents Toolkit. Select **Office Add-in**.
3434

35-
:::image type="content" source="../images/teams-toolkit-create-office-add-in.png" alt-text="The options in New Project dropdown menu. The last option is called 'Office Add-in'.":::
35+
:::image type="content" source="../images/atk-toolkit-new-project-list.png" alt-text="The options in New Project dropdown menu. One option is called 'Office Add-in'.":::
3636

37-
1. The **App Features Using an Office Add-in** dropdown menu opens. The options listed will vary depending on your version of Teams Toolkit. Select **Task pane**.
37+
1. The **App Features Using an Office Add-in** dropdown menu opens. The options listed will vary depending on your version of Agents Toolkit. Select **Task pane**.
3838

3939
:::image type="content" source="../images/teams-toolkit-create-office-task-pane-capability.png" alt-text="The options in the App Features Using an Office Add-in dropdown menu. The option 'Task pane' is selected.":::
4040

4141
1. In the **Workspace Folder** dialog that opens, select the folder where you want to create the project.
42-
1. Give a name to the project (with no spaces) when prompted. Teams Toolkit will create the project with basic files and scaffolding. It will then open the project *in a second Visual Studio Code window*. Close the original Visual Studio Code window.
42+
1. Give a name to the project (with no spaces) when prompted. Agents Toolkit will create the project with basic files and scaffolding. It will then open the project *in a second Visual Studio Code window*. Close the original Visual Studio Code window.
4343

4444
> [!NOTE]
4545
> The project that's generated is configured to be installable on Excel, Outlook, PowerPoint, and Word. You can edit the manifest and source files as needed to change which Office applications are supported.
@@ -76,11 +76,11 @@ Install the latest version of Teams Toolkit into Visual Studio Code as described
7676
### Sideload in Outlook
7777

7878
> [!NOTE]
79-
> If your development computer is Windows, be sure that your Outlook client is classic Outlook for Windows, not [new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627). There is currently a bug that prevents add-ins created with the Teams Toolkit from properly sideloading in new Outlook for Windows or in Outlook on the web.
79+
> If your development computer is Windows, be sure that your Outlook client is classic Outlook for Windows, not [new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627). There is currently a bug that prevents add-ins created with Agents Toolkit from properly sideloading in new Outlook for Windows or in Outlook on the web.
8080
8181
1. Ensure that your account in your Microsoft 365 developer tenancy is also an email account in desktop Outlook. If it isn't, follow the guidance in [Add an email account to Outlook](https://support.microsoft.com/office/e9da47c4-9b89-4b49-b945-a204aeea6726).
8282
1. **Close Outlook desktop**.
83-
1. In Visual Studio Code, open Teams Toolkit.
83+
1. In Visual Studio Code, open Agents Toolkit.
8484
1. In the **ACCOUNTS** section, verify that you're signed into Microsoft 365.
8585
1. Select **View** | **Run** in Visual Studio Code. In the **RUN AND DEBUG** dropdown menu, select the option, **Outlook Desktop (Edge Chromium)**, and then press F5. The project builds and a Node dev-server window opens. This process may take a couple of minutes and then Outlook desktop will open.
8686

docs/develop/convert-xml-to-json-manifest.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Convert an add-in to use the unified manifest for Microsoft 365
33
description: Learn the various methods for converting an add-in with an add-in only manifest to the unified manifest for Microsoft 365 and sideload the add-in.
44
ms.topic: how-to
5-
ms.date: 05/08/2025
5+
ms.date: 05/19/2025
66
ms.localizationpriority: medium
77
---
88

@@ -24,7 +24,7 @@ There are three basic tasks to converting an add-in project from the add-in only
2424
>
2525
> - Add-ins that use the unified manifest can be sideloaded only on Office Version 2304 (Build 16320.20000) or later.
2626
> - Projects created in Visual Studio, as distinct from Visual Studio Code, can't be converted at this time.
27-
> - If you [created the project with Teams Toolkit](teams-toolkit-overview.md) or with the "unified manifest" option in the [Office Yeoman Generator](yeoman-generator-overview.md), it already uses the unified manifest.
27+
> - If you [created the project with Teams Toolkit or Microsoft 365 Agents Toolkit](agents-toolkit-overview.md) or with the "unified manifest" option in the [Office Yeoman Generator](yeoman-generator-overview.md), it already uses the unified manifest.
2828
2929
## Ensure that your manifest is ready to convert
3030

@@ -102,7 +102,7 @@ There are several ways to carry out the remaining tasks, depending on the IDE an
102102
- [Convert NodeJS and npm projects that weren't created with the Yeoman generator for Office Add-ins (Yo Office)](#convert-nodejs-and-npm-projects-that-werent-created-with-the-yeoman-generator-for-office-add-ins-yo-office)
103103

104104
> [!NOTE]
105-
> Conversion of the manifest is one of the effects of importing the add-in project into Teams Toolkit if you do so using the toolkit's importation feature. For details, see [Import an add-in project to Teams Toolkit](import-teams-toolkit.md)
105+
> Conversion of the manifest is one of the effects of importing the add-in project into Agents Toolkit if you do so using the toolkit's importation feature. For details, see [Import an add-in project to Agents Toolkit](import-teams-toolkit.md)
106106
107107
### Convert projects created with the Yeoman generator for Office Add-ins (aka "Yo Office")
108108

docs/develop/create-addin-commands-unified-manifest.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Create add-in commands with the unified manifest for Microsoft 365
33
description: Configure the unified manifest for Microsoft 365 to define add-in commands for Excel, Outlook, PowerPoint, and Word. Use add-in commands to create UI elements, add buttons or lists, and perform actions.
4-
ms.date: 02/12/2025
4+
ms.date: 05/19/2025
55
ms.localizationpriority: medium
66
---
77

@@ -20,7 +20,7 @@ This article describes how to configure the [Unified manifest for Microsoft 365]
2020

2121
## Starting point and major steps
2222

23-
Both of the tools that create add-in projects with a unified manifest — the [Office Yeoman generator](yeoman-generator-overview.md) and [Teams Toolkit](teams-toolkit-overview.md) — create projects with one or more add-in commands. The only time you won't already have an add-in command is if you are updating an add-in which previously didn't have one.
23+
Both of the tools that create add-in projects with a unified manifest — the [Office Yeoman generator](yeoman-generator-overview.md) and [Microsoft 365 Agents Toolkit](agents-toolkit-overview.md) — create projects with one or more add-in commands. The only time you won't already have an add-in command is if you are updating an add-in which previously didn't have one.
2424

2525
## Two decisions
2626

docs/develop/develop-overview.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Develop Office Add-ins
33
description: An introduction to developing Office Add-ins.
44
ms.topic: overview
5-
ms.date: 03/12/2025
5+
ms.date: 05/19/2025
66
ms.localizationpriority: high
77
---
88

@@ -15,7 +15,7 @@ All Office Add-ins are built upon the Office Add-ins platform. For any add-in yo
1515

1616
## Create an Office Add-in
1717

18-
You can create an Office Add-in by using the [Yeoman generator for Office Add-ins](yeoman-generator-overview.md), Visual Studio, Teams Toolkit, or the [Office Add-ins Development Kit (preview)](development-kit-overview.md).
18+
You can create an Office Add-in by using the [Yeoman generator for Office Add-ins](yeoman-generator-overview.md), Visual Studio, Microsoft 365 Agents Toolkit, or the [Office Add-ins Development Kit](development-kit-overview.md).
1919

2020
### Yeoman generator
2121

@@ -35,9 +35,9 @@ Create your project using HTML, CSS and JavaScript (or TypeScript), or using Rea
3535

3636
Visual Studio can be used to create Office Add-ins for Excel, Outlook, Word, and PowerPoint. An Office Add-in project gets created as part of a Visual Studio solution and uses HTML, CSS, and JavaScript. For more information about creating add-ins with Visual Studio, see [Develop Office Add-ins with Visual Studio](../develop/develop-add-ins-visual-studio.md).
3737

38-
### Teams Toolkit
38+
### Agents Toolkit
3939

40-
The Teams Toolkit can be used to create almost any kind of Teams App, a term which includes all extensions of Microsoft 365, including those that don't extend the Teams application. For details about creating an add-in, see [Create Office Add-in projects with Teams Toolkit](teams-toolkit-overview.md).
40+
The Agents Toolkit can be used to create almost any kind of Microsoft 365 extension. For details about creating an add-in, see [Create Office Add-in projects with Microsoft 365 Agents Toolkit](agents-toolkit-overview.md).
4141

4242
### Office Add-ins Development Kit (preview)
4343

0 commit comments

Comments
 (0)