OfficeDev/microsoft-365-agents-toolkit

Microsoft 365 Agents Toolkit

是什麼 – 一組開發者工具（VS Code 擴充、Visual Studio 擴充與 CLI），協助您建立、執行、除錯與部署 Microsoft 365 Copilot、Microsoft Teams 及 Office 增強功能的 代理 與其他擴充功能。此工具包整合了專案架構、驗證助手、無伺服器函式整合與 CI/CD 模板，讓您專注於應用程式的 AI 驅動邏輯，而非基礎設施的細節。

核心元件

套件	功能
vscode-extension	IDE 插件，為 Visual Studio Code 加入向導、熱重新載入、安全隧道與一個「代理沙盒」環境。
cli	相同功能的命令列版本，適合鍵盤導向工作流程或 CI 管道。
sdk	輕量級程式庫，為客戶端與伺服器端程式碼抽象 Microsoft 365 驗證。
api	類型定義與合約，讓第三方外掛程式可擴充此工具包。
fx-core	IDE 與 CLI 共用的實作（專案層級設定、生命週期管理等）。
function-extension	用於新增 Azure Functions 的助手，可自動將其整合至 Teams 應用並支援驗證。
spec-parser	從 OpenAPI 規格生成基於 API 的訊息擴充程式碼與 Adaptive Card 模板。

主要功能

• 支援 Copilot 代理、Teams 聊天機器人、標籤頁、訊息擴充與 Office 增強功能的端對端專案架構。
• 整合 Microsoft 365 資源的單一登入（SSO）驗證。
• 支援熱重新載入與安全隧道的全端除錯，以及用於快速迭代的「代理沙盒」。
• 透過 Azure Functions 實現無伺服器後端，並內建驗證處理。
• 支援 CI/CD – 提供預先設定的 GitHub Actions 與 Azure DevOps 管道。
• 跨語言支援 – 透過 CLI/VS Code 擴充支援 JavaScript/TypeScript，透過 Visual Studio 擴充支援 .NET。

典型使用情境

1. 建立一個 Microsoft 365 Copilot 代理，能從 SharePoint、Outlook 或自訂 API 取得資料，並回應自然語言查詢。
2. 建立一個 Teams 聊天機器人，利用 Teams AI 套件，可在本機透過熱重新載入執行，再發布。
3. 新增一個自訂訊息擴充（例如 Adaptive Card UI），其介面可從 OpenAPI 描述自動產生。
4. 使用 Azure Functions 為 Teams 應用部署無伺服器後端，無需撰寫樣板驗證程式碼。

快速入門

• VS Code：從 Marketplace 安裝 Microsoft 365 Agents Toolkit 擴充，並執行「建立新專案」向導。
• Visual Studio：安裝對應擴充，使用 .NET 代理的專案範本。
• CLI：npm install -g @microsoft/m365agentstoolkit-cli，然後執行 m365 init 建立新專案，m365 run 啟動本機除錯，m365 deploy 部署至 Azure。
• 詳細文件請至 https://aka.ms/teamsfx-docs 查閱。

社群與支援

• 問題與功能需求： https://github.com/OfficeDev/TeamsFx/issues
• 問題提問：Stack Overflow 標籤 teams-toolkit
• 直接回饋：ttkfeedback@microsoft.com

授權與治理

• 此倉儲遵循 Microsoft 的現代生命週期政策，並包含外部貢獻的貢獻者授權協議（CLA）。預設會收集遙測資料，可在 VS Code 常見問題解答中找到退出方式。

---

以上所有資訊均直接取自倉儲的 README。