Microsoft 365 Agents SDK (Python)
使用 Python 建構 Microsoft 365 AI 代理人
組織需要能與 Microsoft 365 無縫整合的 AI 代理人。此技能提供生產就緒的模式,使用官方 Microsoft Agents SDK 建構 Teams 機器人與 Copilot Studio 代理人。
下載技能 ZIP
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
開啟並開始使用
測試它
正在使用「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 權杖傳回使用者個人資料
安全審計
安全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.
風險因素
🔑 環境變數 (1)
品質評分
你能建構什麼
企業 Teams 機器人開發
建構用於 Teams 的內部公司機器人,處理人力資源查詢、IT 支援工單或入職工作流程,並整合 Graph API。
Copilot Studio 代理人整合
建立自訂 AI 代理人,連線至 Copilot Studio 引擎以取得專業領域知識和企業資料存取。
多渠道代理人部署
部署單一代理人應用程式,透過標準化路由服務多個渠道,包括 Teams、網頁聊天和自訂用戶端。
試試這些提示
建立一個具有 aiohttp 託管的 Microsoft 365 代理人,回應 'hello' 和 'help' 訊息。包含基本對話更新處理程序和錯誤處理。
新增受認證保護的路由以擷取使用者的 Microsoft Graph 個人資料並顯示其名稱。使用 MSAL 連線管理員進行權杖取得。
實作串流回應處理器,使用 Azure OpenAI 生成創意內容。包含敏感性標籤和回饋迴路設定。
建立使用用戶端 SDK 連線至 Copilot Studio 的獨立指令碼。包含權杖取得和對話管理。
最佳實務
- 僅在開發時使用 MemoryStorage。切換至 BlobStorage 或 CosmosDB 進行生產部署以確保資料持久化。
- 使用 dotenv 將所有機密保存在環境變數中。切勿將憑證提交至原始碼控制。
- 實作串流回應時,在 finally 區塊中呼叫 end_stream() 以確保適當的連線清理。
避免
- 請勿使用舊的 microsoft.agents 匯入語法。一律對當前 SDK 版本使用 microsoft_agents(底線分隔)。
- 避免在原始碼中直接硬編碼用戶端 ID、機密或租用戶 ID。一律使用環境變數。
- 生產環境中切勿跳過 JWT 授權中介軟體。一律在 aiohttp Application 設定中包含 jwt_authorization_middleware。