Teams AI Library v2 is a suite of packages used to develop on Microsoft Teams. Rebuilt from the ground up with improved developer experience in mind, it's never been easier to build powerful agents and applications for the hundreds of millions Microsoft Teams users.

Quickstart

The Teams CLI makes it easy to bootstrap your first agent. First, install the CLI via NPM:

npm install -g @microsoft/teams.cli@preview

Next, use the CLI to create your agent:

teams new quote-agent --template echo

For more information, follow our quick start guide.

Overview

Microsoft Teams has a robust developer ecosystem with a broad suite of capabilities, now unified via Teams AI v2. Whether you are building AI-powered agents, message extensions, embedded web applications, or Graph, Teams AI v2 has you covered.

Here is a simple example, which responds to incoming messages with information retrieved from Graph.

import { App } from '@microsoft/teams.apps';
import { DevtoolsPlugin } from '@microsoft/teams.dev';

const app = new App({
  plugins: [new DevtoolsPlugin()],
});

// Listen for incoming messages
app.on('message', async ({ api, isSignedIn, send, signin }) => {
  if (!isSignedIn) {
    await signin(); // initiates Entra login flow
    return;
  }
  const me = await api.user.me.get();
  await send(`Hello, ${me.displayName} from Earth!`);
});

// Start your application
(async () => {
  await app.start();
})();

⭐ What's new?

Streamlined Developer Experience

We’ve refined the developer experience so you can concentrate on building your app’s logic — not wrestling with integrations.

Effortless Integration

We’ve simplified complex integration workflows to help you deliver a richer, more seamless user experience.

Accelerate Your Workflow

Get your application up and running in under 30 seconds with our lightning-fast CLI—so you can spend more time on what really matters.

🔎 Navigation Tips

We encourage you to use the left sidebar to navigate to your desired section.

Can't find what you're searching for? Use the search button above.