Skip to content

install-Agents-Toolkit.md

Latest commit

 

History

History
133 lines (81 loc) · 9.33 KB

install-Agents-Toolkit.md

File metadata and controls

133 lines (81 loc) · 9.33 KB
title Steps to Install Agents Toolkit
author zyxiaoyuer
description Learn how to install Microsoft 365 Agents Toolkit from Visual Studio Code and marketplace, and to install different Agents Toolkit versions and prerelease versions.
ms.author zhany
ms.localizationpriority medium
ms.topic overview
ms.date 03/10/2025

Install Agents Toolkit

This section helps you to know about the prerequisites, install Microsoft 365 Agents Toolkit (previously known as Teams Toolkit) for Microsoft Visual Studio Code, and install a different version of Agents Toolkit.

Prerequisites

  • Visual Studio Code.
  • NodeJS supported versions: >=20.
  • NPM latest version.
  • Microsoft 365 work or organization account.
  • Azure account and subscription.

Install Agents Toolkit for Visual Studio Code

You can install Agents Toolkit using Extensions in Visual Studio Code or install it from the Visual Studio Code Marketplace.

Visual Studio Code

  1. Launch Visual Studio Code.

  2. Select View > Extensions or Ctrl+Shift+X. You can also open extensions by selecting the extensions :::image type="icon" source="../assets/images/toolkit-v2/toolkit-fundamentals/vsc-ext-icon.png" border="false"::: icon from the Visual Studio Code activity bar.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/install toolkit-1_2.png" alt-text="Screenshot shows the Extensions option under View.":::

    The EXTENSIONS: MARKETPLACE pane appears.

  3. Enter Microsoft 365 Agents Toolkit in the search box.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/toolkit-search.PNG" alt-text="Screenshot show the Agents Toolkit listed in the search result.":::

    Agents Toolkit appears in the search result.

  4. Select Microsoft 365 Agents Toolkit, and then from Agents Toolkit extension page that appears in the right pane, select Install.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/toolkit-ga.PNG" alt-text="Screenshot show the Agents Toolkit.":::

    After successful installation, Agents Toolkit icon appears in the Visual Studio Code activity bar.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/toolkit-activity-bar.png" alt-text="Screenshot shows the Agents Toolkit icon in the activity bar.":::

[!div class="nextstepaction"] I ran into an issue

Marketplace

  1. Go to Visual Studio Code Marketplace in a web browser.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/install-marketplace.png" alt-text="Screenshot shows the Agents Toolkit Marketplace screen.":::

  2. Select Install.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/install-toolkit1.png" alt-text="Screenshot shows the Install option.":::

  3. In the pop-up window, select Open.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/select-open_1.png" alt-text="Screenshot shows a pop-up window to open Visual Studio Code.":::

    Visual Studio Code opens with Agents Toolkit extension page.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/toolkit-in-vsc.png" alt-text="Screenshot shows how to select Agents Toolkit in Visual Studio Code."

  4. Select Install.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/toolkit-ga.png" alt-text="Screenshot shows the selection of Install option in Agents Toolkit.":::

    After successful installation, Agents Toolkit icon appears in the Visual Studio Code activity bar.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/toolkit-activity-bar.png" alt-text="Screenshot shows the Agents Toolkit icon in the activity bar after installation.":::

[!div class="nextstepaction"] I ran into an issue

Install a different release version

By default, Visual Studio Code automatically keeps Agents Toolkit up-to-date. If you want to install a different release version, follow these steps:

  1. Select Extensions :::image type="icon" source="../assets/images/toolkit-v2/extension icon.png" border="false"::: from the Visual Studio Code activity bar.

  2. Enter Microsoft 365 Agents Toolkit in the search box.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/toolkit-search1.png" alt-text="Screenshot shows the Agents Toolkit search and the result.":::

  3. Select Microsoft 365 Agents Toolkit.

  4. On the Agents Toolkit page, select the dropdown next to Uninstall.

  5. Select Install Specific Version... from the dropdown list.

    :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/install-another-version.png" alt-text="Screenshot shows the option to select other versions of Visual Studio Code.":::

  6. Select the required version to install.

    Agents Toolkit installs the selected version.

[!div class="nextstepaction"] I ran into an issue

Install a prerelease version

Agents Toolkit for Visual Studio Code extension is available in a prerelease version. To install Agents Toolkit prerelease version, follow these steps:

  1. Open Visual Studio Code.
  2. Select Extensions :::image type="icon" source="../assets/images/toolkit-v2/toolkit-fundamentals/extension icon.png" border="false" alt-text="Screenshot shows the extension icon."::: from the Visual Studio Code activity bar.
  3. Enter Microsoft 365 Agents Toolkit in the search box.
  4. Click the dropdown arrow next to Uninstall.
    • If you're already on the pre-release track, choose Install Specific Version.... You'll see a list of available pre-release versions.
    • If you're on the stable track, the Install Specific Version... option shows only stable versions.

Note

The Install Pre-Release Version option may not appear depending on the update track of your currently installed Microsoft 365 Agents Toolkit extension. Use Install Specific Version... to manually select a version.

[!div class="nextstepaction"] I ran into an issue

Next step

[!div class="nextstepaction"] Create a new Teams agent or app

See also