技能 Microsoft 365 Agents SDK (Python)
📦

Microsoft 365 Agents SDK (Python)

安全 🔑 環境變數

使用 Python 建構 Microsoft 365 AI 代理人

組織需要能與 Microsoft 365 無縫整合的 AI 代理人。此技能提供生產就緒的模式,使用官方 Microsoft Agents SDK 建構 Teams 機器人與 Copilot Studio 代理人。

支援: Claude Codex Code(CC)
🥉 72 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「Microsoft 365 Agents SDK (Python)」。 設定基本的 Teams 機器人以回應用使用者訊息

預期結果:

  • 代理人應用程式已使用 aiohttp CloudAdapter 初始化
  • 已為活動類型註冊訊息處理器:message
  • 已註冊對話更新處理器:membersAdded
  • 伺服器運行於 localhost:3978,附有 JWT 授權中介軟體

正在使用「Microsoft 365 Agents SDK (Python)」。 為 Microsoft Graph 存取新增 OAuth 認證

預期結果:

  • MsalConnectionManager 已使用 Azure AD 設定進行設定
  • 已為受保護路由註冊認證處理器 'GRAPH'
  • 權杖取得流程已準備好進行互動式或無聲認證
  • 受保護端點 /me 使用 Bearer 權杖傳回使用者個人資料

安全審計

安全
v1 • 2/25/2026

This is a prompt-only instructional skill that provides code examples for building Microsoft 365 agents. Static analysis detected no security issues. The skill contains legitimate SDK usage patterns for aiohttp hosting, MSAL authentication, and Copilot Studio integration. Environment variable usage follows security best practices.

0
已掃描檔案
0
分析行數
1
發現項
1
審計總數

風險因素

🔑 環境變數 (1)
審計者: claude

品質評分

38
架構
100
可維護性
87
內容
50
社群
100
安全
74
規範符合性

你能建構什麼

企業 Teams 機器人開發

建構用於 Teams 的內部公司機器人,處理人力資源查詢、IT 支援工單或入職工作流程,並整合 Graph API。

Copilot Studio 代理人整合

建立自訂 AI 代理人,連線至 Copilot Studio 引擎以取得專業領域知識和企業資料存取。

多渠道代理人部署

部署單一代理人應用程式,透過標準化路由服務多個渠道,包括 Teams、網頁聊天和自訂用戶端。

試試這些提示

基本代理人設定
建立一個具有 aiohttp 託管的 Microsoft 365 代理人,回應 'hello' 和 'help' 訊息。包含基本對話更新處理程序和錯誤處理。
OAuth 保護的訊息處理器
新增受認證保護的路由以擷取使用者的 Microsoft Graph 個人資料並顯示其名稱。使用 MSAL 連線管理員進行權杖取得。
使用 Azure OpenAI 的串流回應
實作串流回應處理器,使用 Azure OpenAI 生成創意內容。包含敏感性標籤和回饋迴路設定。
Copilot Studio 用戶端整合
建立使用用戶端 SDK 連線至 Copilot Studio 的獨立指令碼。包含權杖取得和對話管理。

最佳實務

  • 僅在開發時使用 MemoryStorage。切換至 BlobStorage 或 CosmosDB 進行生產部署以確保資料持久化。
  • 使用 dotenv 將所有機密保存在環境變數中。切勿將憑證提交至原始碼控制。
  • 實作串流回應時,在 finally 區塊中呼叫 end_stream() 以確保適當的連線清理。

避免

  • 請勿使用舊的 microsoft.agents 匯入語法。一律對當前 SDK 版本使用 microsoft_agents(底線分隔)。
  • 避免在原始碼中直接硬編碼用戶端 ID、機密或租用戶 ID。一律使用環境變數。
  • 生產環境中切勿跳過 JWT 授權中介軟體。一律在 aiohttp Application 設定中包含 jwt_authorization_middleware。

常見問題

Microsoft Agents SDK 需要什麼 Python 版本?
Microsoft Agents SDK for Python 需要 Python 3.8 或更高版本。建議使用 Python 3.10+ 以獲得與所有功能的最佳相容性。
如何在 Azure AD 中註冊我的代理人應用程式?
前往 Azure Portal > Azure Active Directory > App registrations。建立新註冊,記錄 Application (client) ID 和 Tenant ID。為您的代理人端點新增重新導向 URI。
我可以僅將此技能用於 Microsoft Teams 嗎?
可以。雖然 SDK 支援多個渠道,但您可以透過設定適當的活動處理程序和 Teams 專屬中介軟體,將代理人專門設定為用於 Teams。
AgentApplication 和 CloudAdapter 之間有什麼區別?
CloudAdapter 處理 HTTP 請求/回應週期和訊息路由。AgentApplication 管理對話狀態、訊息處理器和應用程式層級邏輯。它們在託管管道中協同運作。
如何在代理人中啟用串流回應?
使用 context.streaming_response 方法:set_feedback_loop(True)、set_generated_by_ai_label(True)、queue_text_chunk() 進行增量更新,以及 end_stream() 完成。
此技能是否與 Claude、Codex 和 Claude Code 相容?
可以,此技能專為與 Claude、Codex 和 Claude Code 搭配使用而設計。所有提示範本和程式碼範例均可在這些 AI 助理平台上運作。

開發者詳情

檔案結構

📄 SKILL.md