OfficeDev/microsoft-365-agents-toolkit

Microsoft 365 Agents Toolkit

What it is – A set of developer tools (VS Code extension, Visual Studio extension, and a CLI) that help you create, run, debug and deploy agents and other extensions for Microsoft 365 Copilot, Microsoft Teams, and Office add‑ins. The toolkit bundles scaffolding, authentication helpers, server‑less function integration, and CI/CD templates so you can focus on the AI‑driven logic of your app rather than the plumbing.

Core components

Package	Role
vscode-extension	IDE plug‑in that adds wizards, hot‑reload, secure tunnelling and a playground inside Visual Studio Code.
cli	Command‑line version of the same features – useful for keyboard‑centric workflows or CI pipelines.
sdk	Light‑weight library that abstracts Microsoft 365 authentication for both client‑side and server‑side code.
api	Type definitions and contracts that let third‑party plugins extend the toolkit.
fx-core	Shared implementation used by the IDE and CLI (project‑level configuration, lifecycle management, etc.).
function-extension	Helper for adding Azure Functions that are automatically wired into a Teams app with auth support.
spec-parser	Generates API‑based message‑extension code and Adaptive Card scaffolding from an OpenAPI spec.

Key capabilities

• End‑to‑end scaffolding for Copilot agents, Teams chat bots, tabs, message extensions and Office add‑ins.
• Integrated authentication (single‑sign‑on) for Microsoft 365 resources.
• Full‑stack debugging with hot‑reload and secure tunnelling, plus a “Agents Playground” for rapid iteration.
• Serverless back‑ends via Azure Functions, with built‑in auth handling.
• CI/CD support – ready‑made GitHub Actions and Azure DevOps pipelines.
• Cross‑language support – JavaScript/TypeScript via the CLI/VS Code extension and .NET via the Visual Studio extension.

Typical use‑cases

1. Building a Copilot‑for‑Microsoft‑365 agent that can retrieve data from SharePoint, Outlook, or custom APIs and respond to natural‑language queries.
2. Creating a Teams chatbot that leverages the Teams AI library and can be run locally with hot‑reload before publishing.
3. Adding a custom message‑extension (e.g., an Adaptive Card UI) that is generated automatically from an OpenAPI description.
4. Deploying a server‑less backend for a Teams app using Azure Functions without writing boiler‑plate auth code.

Getting started

• VS Code: Install the Microsoft 365 Agents Toolkit extension from the Marketplace and run the “Create New Project” wizard.
• Visual Studio: Install the corresponding extension and use the project templates for .NET agents.
• CLI: npm install -g @microsoft/m365agentstoolkit-cli then m365 init to scaffold a new project, m365 run to start local debugging, and m365 deploy to push to Azure.
• Detailed docs are at https://aka.ms/teamsfx-docs.

Community & support

• Issues & feature requests: https://github.com/OfficeDev/TeamsFx/issues
• Questions: Stack Overflow tag teams-toolkit
• Direct feedback: ttkfeedback@microsoft.com

License & governance

• The repository follows Microsoft’s Modern Lifecycle Policy and includes a Contributor License Agreement for external contributions. Telemetry is collected by default, with opt‑out instructions in the VS Code FAQ.

---

All information above is taken directly from the repository’s README.