Microsoft Agent 365 SDK 與 CLI

初次接觸 Agent 365?

如果您剛開始使用,請選擇最適合您的路徑:

我想要… 從此處開始
借助 AI 輔助快速上手 AI 導引設定 — AI 程式碼撰寫 Agent (GitHub Copilot、Claude Code 或 OpenAI Codex) 會透過單一指示檔案,引導您完成安裝、設定、部署及發佈。
逐步操作實作範例 快速入門 — 選擇您慣用語言的範例 (Node.js、Python 或 .NET),建置可運作的 Agent。
深入之前先了解完整的工作流程 開始使用 Agent 365 進行開發 — 一份指南涵蓋 Agent 類型、階段、設定與發佈。
了解該建置哪種類型的 Agent Agent 類型 — 說明 Agent 類型及其身分識別模型。
啟用 Google Vertex AI 或 Amazon Bedrock Agent 註冊這些 Agent 不需要任何開發工作,系統會透過 Google 與 Amazon API 自動提取 Agent。 不需要整合 SDK、不需要藍圖,也不需要變更程式碼。 註冊後,您可以使用 Agent 365 SDK 逐步新增可觀察性、Work IQ 工具存取權及其他功能。 如需入門資訊,請參閱註冊 Google Vertex AI 與 Amazon Bedrock Agent

Agent 365 SDK

使用 Agent 365 SDK,為以任何 Agent SDK 或平台建置的 Agent,擴充企業級身分識別、可觀察性、通知、安全性,以及受控管的 Microsoft 365 資料存取權。

提示

正在尋找預先建置的 Agent? 如需推出時已預先整合的 Agent,請參閱 Agent 365 中可用的生態系統合作夥伴 Agent

Agent 具有唯一的身分識別。 使用者會在企業慣用的應用程式 (例如 Teams、Word、Outlook 等) 中,以常見手勢 (例如 @mentions) 叫用 Agent。 Agent 會展現可觀察的行為以建立信任,並透過安全的工具與資料存取權,執行可稽核的動作。

透過 Agent 365 SDK,Agent 可以:

  • 使用以 Entra 為基礎的 Agent Identity,搭配自己的使用者資源 (例如信箱),進行安全驗證並控管對工具與資料的存取權。
  • 接收並回應來自 Teams、Outlook、Word 註解及電子郵件的通知,就像 Microsoft 365 應用程式中的真人使用者一樣。
  • 透過 Open Telemetry 取得完整的可觀察性,讓 Agent 互動、推斷事件及工具使用情形可供稽核與追蹤。
  • 叫用受控管的 Model Context Protocol (MCP) 伺服器,在系統管理員控管下存取 Microsoft 365 工作負載 (例如 Mail、行事曆、SharePoint、Teams)。
  • 在 IT 核准的藍圖系統內運作,確保每個 Agent 執行個體都會繼承合規性、治理及安全性原則。

深入了解 Agent 365 SDK

Agent 365 CLI

Agent 365 CLI 是 Agent 365 在整個 Agent 開發生命週期中的命令列骨幹,可為企業就緒的 Agent 自動化設定、身分識別、組態設定、MCP 整合、發佈及 Azure 部署。

透過 Agent 365 CLI,開發人員可以:

  • 建立 Agent 藍圖及其所需的所有支援資源。
  • 管理 Agent 隨附與自訂的 Work IQ 工具、權限及工具組。
  • 將 Agent 程式碼部署至 Azure。
  • 將 Agent 應用程式套件發佈至 Microsoft 系統管理中心。
  • 清除 CLI 建立的 Agent 藍圖、身分識別及其他 Azure 資源。

深入了解 Agent 365 CLI

Agent 365 Agent 開發生命週期

Agent 365 可搭配任何 Agent SDK 或平台建置的 Agent 使用。 這包括 Copilot Studio 與 Azure AI Foundry 等低程式碼平台。 也支援 Microsoft Agent Framework、Microsoft Agents SDK、OpenAI Agents SDK、Claude Code SDK 及 LangChain SDK 等專業程式碼選項。 Agent 365 也可搭配裝載於任何端點的 Agent 程式碼使用,不論是 Azure、Amazon Web Services (AWS)、Google Cloud Platform (GCP) 或其他雲端提供者。

重要

若要充分了解 Agent 365 SDK 與 CLI 如何協同運作,請檢閱開始使用 Agent 365 進行開發中所述的工作流程

Agent 365 Agent 藍圖

在處理 Agent 365 Agent 的執行個體之前,建議先了解 Agent 365 Agent 藍圖的意義。 這個概念源自 Microsoft Entra Agent 藍圖,是一種經 IT 核准、預先設定的 Agent 類型定義,本質上是可用來建立合規 Agent 的企業「範本」。 它會定義 Agent 的功能、所需的 Work IQ 工具存取權、安全性與合規性限制、稽核需求、生命週期中繼資料,以及任何相關聯的治理原則範本,例如 DLP、外部存取限制或記錄規則。 藍圖在租用戶中啟用後,使用者即可在 Microsoft 365 系統管理中心,向系統管理員申請以該 Agent 藍圖建立的新 Agent 執行個體。 每個 Agent 執行個體都會繼承其藍圖的規則,確保郵件、行事曆、Teams、SharePoint 存取,以及 Agent 觸及的任何其他 Microsoft 365 工作負載,都能維持一致的治理。 這可防止影子/失控 Agent,強制執行可觀察性,並讓每個 Agent 都以安全、以 Entra 為基礎的身分識別與權限模型為根基。

Agent 365 SDK 有何不同?

Agent 365 SDK 與 Microsoft Agent Framework 或 Microsoft Copilot Studio 等 Agent 架構不同,因為它不會建立或裝載 Agent。 相反地,無論底層堆疊為何,它都會透過新增企業功能來增強您已建置的 Agent,例如以 Entra 為基礎的 Agent 身分識別、受控管的 Work IQ 工具存取權、以 OpenTelemetry (OTel) 為基礎的可觀察性、透過 Activity 通訊協定發出的通知,以及以 Agent 識別碼為驅動的治理。

雖然名稱非常相似,但它並不會取代 Microsoft 365 Agents SDK 及其提供的裝載、活動通訊協定和身分識別功能。 相反地,Agent 365 SDK 會在以此 SDK 或其他平台建置的 Agent 之上,疊加治理、合規性及生命週期控制,藉此加以輔助。

圖表顯示如何為現有 Agent 啟用 Agent 365

Agent 365 SDK 與 Agent 生態系統

此表格摘要說明分層的 Agent 架構,顯示 Agent 365 SDK 如何在您的 Agent 邏輯,以及您所選架構提供的 LLM 協調流程執行階段之上,新增企業功能。

圖層 角色 提供者
企業功能 身分識別、通知、可觀察性、工具組 Agent 365 SDK
Agent 邏輯 提示、工作流程、推理 您以程式碼實作的內容
LLM 協調流程執行階段 模型叫用與工具協調流程 您選擇的 Agent SDK/架構

後續步驟