Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Teams Toolkit has significant updates in Visual Studio (VS) 17.14. If you're working on VS versions from 17.10 to 17.13, and now you want to upgrade to 17.14, you may want to migrate your projects to make it compatible with VS 17.14.
The key updates that have impacted this migration are:
Teams Toolkit evolves to Microsoft 365 Agents Toolkit
Teams Toolkit changes it's name to Microsoft 365 Agents Toolkit, reflecting our broader commitment to support development across Microsoft 365 Copilot, Microsoft Teams, and Microsoft 365 apps. This new name better represents our expanded capabilities and focus on enabling developers to build intelligent agents and apps across the Microsoft 365 ecosystem.
Enable one-click debug experience
In previous versions of Teams Toolkit, when users debug any solution generated, they need to use the command Prepare Teams App Dependency
before debugging the project. This command triggers the toolkit to create essential resources for debugging, such as registering required app ID or updating the app manifest.
To enhance the debugging experience and make it easier and quicker, we have removed this step and enabled one-click debugging experience. Now, you can directly click the debug button without any preparation steps. However, if you've made edits to your app manifest between two debug events and need to update your app, there remains an option to do that.
The new debug experience introduces the following two debug types, offered by selecting from different debug profiles:
Debug with updating app: Select the default profile
[Your Target Launch Platform] (browser)
that runs to prepare Teams App dependencies step in debugging. This is usually used when you are in the first time to run the project or you have made edits to your app manifest before launching app again.Debug without updating app: Choose the second profile
[Your Target Launch Platform] (browser) (skip update app)
to skip prepare Teams App dependencies step, make a quick launch to your target platform directly. This is usually used for a second time to launch the project, when you only made edits to your application but not edit your app manifest.
Prerequisites
Before starting the migration process, ensure that you've the following:
- A Teams project with new project structure that's created using Agents Toolkit for Visual Studio version 17.13 or earlier.
- Visual Studio version 17.14 or later with Microsoft 365 Agents Toolkit installed.
Migration process
Perform the following steps to migrate to one-click F5 experience:
Open
Configuration Manager
window by clicking Build > Configuration Manager... in VS.In
Configuration Manager
window, check thedeploy
stage for M365Agent/TeamsApp project for prepare Teams App dependencies to be executed when deploying.(Optional) Create Microsoft Teams (browser) (skip update app) debug profile. Follow Microsoft Teams (browser) debug profile to add following contents:
In
launchSettings.json
under M365Agent/TeamsApp project, add following contents:"Microsoft Teams (browser) (skip update app)": { "commandName": "Project", "environmentVariables": { "UPDATE_TEAMS_APP": "false" }, "launchUrl": "https://teams.microsoft.com/l/app/${{TEAMS_APP_ID}}?installAppPackage=true&webjoin=true&appTenantId=${{TEAMS_APP_TENANT_ID}}&login_hint=${{TEAMSFX_M365_USER_NAME}}" },
In
{{solutionName}}.slnLaunch.user
file at the same level as the solution file, add the content according to the files oflaunchSettings.json
:[ { "Name": "Microsoft Teams (browser) (skip update app)", "Projects": [ { "Path": "M365Agent\\M365Agent.atkproj", "Name": "M365Agent\\M365Agent.atkproj", "Action": "StartWithoutDebugging", "DebugTarget": "Microsoft Teams (browser) (skip update app)" }, { "Path": "tab\\tab.csproj", "Name": "tab\\tab.csproj", "Action": "Start", "DebugTarget": "Start Project" } ] } ]
If your project contains debug profile for Microsoft 365 Agents Playground (previously known as Teams App Test Tool), you'll need to add following environment variable in
launchSettings.json
under M365Agents/TeamsApp project:"UPDATE_TEAMS_APP": "false"
An example after updating could be:
"Microsoft 365 Agents Playground (browser)": { "commandName": "Project", "environmentVariables": { "UPDATE_TEAMS_APP": "false", "DEFAULT_CHANNEL_ID": "emulator" }, "launchTestTool": true, "launchUrl": "http://localhost:56150", }
Platform Docs