Cloud & AI · Sep 2020 — Mar 2024

Microsoft 365 Agents Toolkit

“用于在 Microsoft 365 中构建 AI 智能体的专业开发工具集”

VS Code 市场 GitHub

443K+

Installs

40+

Templates

Languages

Years Evolving

问题陈述

为 M365 构建需要太多胶水代码

为 Microsoft 365 生态系统构建智能体和应用的专业开发者面临着碎片化的 SDK、认证配置、云端配置和多目标表面部署的复杂局面。

认证复杂性

为 Teams、Outlook 和 Copilot 跨平台配置 Microsoft Entra ID 单点登录需要深厚的身份认证专业知识。一个错误配置就会阻塞整个应用。

多表面扩散

智能体必须在 Copilot、Teams、Outlook、Office 加载项和外部渠道上运行。每个表面都有不同的清单格式、API 和测试要求。

云端配置

部署智能体需要创建 Azure Bot Service、Functions、存储账户和应用注册 -- 在开发、预发布和生产环境之间各不相同的手动步骤。

样板代码开销

每个新项目都从零开始：接入 SDK、配置清单、设置 CI/CD 流水线，以及实现每次都相同的错误处理模式。

用户画像

核心用户

企业应用开发者

构建与 Microsoft 365 集成的业务线智能体和应用的专业开发者。使用 TypeScript 或 C# 开发，需要完整的源代码控制和 CI/CD 集成，交付到企业租户。

几分钟内搭建新智能体项目，而非数天
使用热重载和安全隧道在本地调试
通过自动化资源配置部署到 Azure

次要用户

AI 智能体构建者

为 Microsoft 365 Copilot 创建声明式或自定义引擎智能体的开发者。需要定义智能体指令、连接知识源、接入 MCP 工具并发布给用户。

构建带自定义操作的 Copilot 声明式智能体
将 MCP 服务器集成为智能体工具源
与特定用户或整个租户共享智能体

扩展用户

平台工程师

负责 M365 智能体在开发、预发布和生产环境部署的 CI/CD 流水线、环境管理和治理。需要 CLI 工具和流水线模板。

使用 GitHub Actions 或 Azure DevOps 自动化部署
大规模管理特定环境配置
支持政府云 (GCC-M) 要求

用户旅程

从创意到已发布的智能体

脚手架

从 40 多个 JS、TS、Python 或 C# 模板中选择。工具包生成项目结构、清单、认证配置和 SDK 接入。

痛点: 每个新项目都需要数天的样板搭建

构建与调试

使用热重载在本地开发，通过安全隧道连接 Bot 端点，使用 Agents Playground 进行交互式测试，无需部署。

痛点: 不部署就无法在本地测试 Bot

配置与部署

一键 Azure 资源配置，创建 Bot Service、Functions 和存储。使用特定环境配置部署到云端。

痛点: 每个环境都需要在 Azure 门户中手动操作

发布与共享

发布到 Teams 应用商店或与特定用户共享声明式智能体。生成 CI/CD 流水线实现自动化发布。

痛点: 复杂的应用商店提交和租户分发

用户故事

As 企业应用开发者

I want to 用一条命令搭建带 SSO 认证的 Teams Bot

So that 可以专注于业务逻辑，而不是花数天在认证配置和样板代码上。

As AI 智能体构建者

I want to 为 Microsoft 365 Copilot 创建一个通过 MCP 连接公司 API 的声明式智能体

So that 员工可以向 Copilot 提问，并获得基于我们专有数据和服务的回答。

As 平台工程师

I want to 为多环境智能体部署生成 GitHub Actions 流水线

So that 团队可以通过受治理的自动化发布流程交付智能体更新。

As Python 开发者

I want to 使用 Azure OpenAI 构建带自定义 LLM 编排的自定义引擎智能体

So that 可以在 Teams 中提供 AI 驱动的助手，而不受限于声明式提示。

As 政府承包商

I want to 将智能体部署到使用合规 Azure 资源的 GCC-M 租户

So that 我的机构可以使用 AI 智能体，同时满足联邦安全和合规要求。

功能特性

Core

40+ 项目模板

声明式智能体、自定义引擎智能体、Teams Bot、选项卡、消息扩展、Office 加载项和 Copilot 连接器 -- 支持 TypeScript、JavaScript、Python 和 C#。

4 种语言 x 10+ 场景

MCP Server 集成

将 Model Context Protocol 服务器作为工具源连接到声明式智能体。智能体可以通过标准化工具接口调用外部 API、数据库和服务。

自 v6.6.0 正式发布

Agents Playground

用于交互式 Bot 调试的本地测试环境，支持热重载和安全隧道。无需部署到 Azure 或旁加载到 Teams 即可测试智能体。

零部署本地测试

Infra

Azure 资源配置

一键创建 Azure Bot Service、Functions、存储账户和应用注册。支持开发、预发布和生产环境的特定配置。

从 IDE 到云端一键完成

Core

简化 SSO 认证

零配置的 Microsoft Entra ID 集成，支持 Teams、Outlook 和 Copilot 跨平台单点登录。处理令牌交换、同意流程和多租户场景。

认证配置从数天缩短到几分钟

Infra

CI/CD 流水线

生成 GitHub Actions 和 Azure DevOps 流水线模板，实现自动化构建、测试和部署。CLI (atk) 支持流水线脚本的无头执行。

GitHub Actions + Azure DevOps

技术架构

Developer Interface

VS Code Extension

vscode-extension

Visual Studio

dotnet-sdk

CLI (atk)

cli package

↓

Commands, scaffolding, provisioning requests

Shared Core

fx-core

Business Logic

Spec Parser

OpenAPI → Extensions

MCP Server

Tool Integration

↓

Templates, SDK wiring, manifest generation

Agent Runtimes

Microsoft Agents SDK

Multi-Channel

Teams AI Library V2

Teams Bots

Azure OpenAI

LLM Orchestration

↓

Agent deployment, bot registration

Cloud Infrastructure

Azure Bot Service

Bot Registration

Azure Functions

Compute

Azure Storage

State & Assets

Microsoft Entra ID

Auth & SSO

↓

Published agents & apps

Microsoft 365 Surfaces

M365 Copilot

Declarative Agents

Microsoft Teams

Bots, Tabs, Extensions

Outlook

Add-ins, Agents

Office Apps

Add-ins

TypeScriptC# / .NETPythonJavaScriptpnpm MonorepoMCP ProtocolAzure Bot ServiceAzure FunctionsMicrosoft Entra IDGitHub Actions

多表面覆盖

单个智能体可以发布到 Microsoft 365 Copilot、Teams、Outlook、Office 加载项以及 Web、邮件和短信等外部渠道 -- 全部基于一个代码库和统一清单。

专业代码定位

填补了无代码（Agent Builder）和低代码（Copilot Studio）之间的空白，为专业开发者提供完整的 IDE 集成、源代码控制和 CI/CD -- 是微软唯一为 M365 智能体提供此类能力的工具。

五年演进

2021 年以 Teams Toolkit 的名称诞生，在 Build 2025 大会上更名以反映其扩展范围。单体仓库架构（fx-core 在 VS Code、Visual Studio 和 CLI 之间共享）确保了所有开发者界面的行为一致性。