前言¶
處理 Outlook 郵件時,常見的重複勞動是:登錄網頁或客戶端,逐封讀信、判斷類型、歸類到文件夾,再手動記下「多久之內必須回覆」。當郵件量上升,或者要把回覆時效納入流程時,手工處理既慢又容易漏。下面介紹的 Skill 把這部分工作交給程序:通過 Microsoft Graph API 讀取和發送郵件,把處理後的消息移動到文件夾,並在本地 SQLite 裏記錄回覆 SLA。它不做營銷式的「全自動辦公」,只把已覈實的幾個動作串起來。
這是什麼¶
這是一個面向 Microsoft Graph 的郵件自動化 Skill,座標 @user_3c6cb52e/outlook-email-automation,版本 1.0.0,來源爲 community,由發佈者 user_3c6cb52e 維護,分類爲 office-efficiency。它解決的問題是:在腳本或 Agent 環境中以程序化方式讀取郵箱、回覆郵件、移動消息,並留存回覆時效記錄,而不是依賴人工在網頁端逐條操作。標籤包含 requires_api_key=true,說明啓用前需要準備 API key 類憑證。
核心能力¶
根據 Skill 簡介,已覈實的能力有三項。
1、身份驗證。使用 MSAL 對 Microsoft Graph API 進行身份驗證,不使用腳本內硬編碼的長期 token。
2、讀取與回覆郵件。通過 GET /me/messages 讀取郵件,通過 POST /me/sendMail 發送回覆,覆蓋「讀取、分類、回覆」這條主鏈路。
3、整理與時效跟蹤。把處理後的消息移動到文件夾中,並在本地 SQLite 存儲中跟蹤回覆 SLA。
授權範圍爲 Mail.ReadWrite 和 Calendars.ReadWrite。前者對應郵件讀寫,後者在簡介中被列爲權限之一,用於日曆相關能力。
權限與前置條件¶
啓用前需要確認三件事。
1、Microsoft Graph 應用註冊。需要在 Azure AD 中註冊應用,授予 Mail.ReadWrite 與 Calendars.ReadWrite,並確認租戶與用戶範圍符合目標郵箱。
2、身份驗證材料。Skill 使用 MSAL,因此需要客戶端 ID、租戶、客戶端密鑰或設備代碼流所需參數。具體採用哪種授權模式,以 Skill 包內 SKILL.md 爲準。
3、API key 憑證。標籤 requires_api_key=true 表明該 Skill 需要 API key。字段名稱與讀取順序未在已抓取資料中給出,此處不臆造,使用前應以 Skill 包內 SKILL.md 的配置說明爲準。
安裝與啓用¶
已抓取資料包含 Skill 座標與發佈信息,但沒有給出官方安裝命令、安裝目錄或配置文件路徑。爲避免編造,這裏只寫可覈實的部分。
座標:
@user_3c6cb52e/outlook-email-automation
發佈信息:版本 1.0.0,來源 community,分類 office-efficiency。
如果你使用的是支持 SkillHub 生態的客戶端,建議把上述座標作爲檢索入口,在客戶端內完成啓用;具體命令隨客戶端不同而不同,未覈實到的部分不在此列出。啓用後,把 Microsoft Graph 應用註冊信息與 API key 填入 Skill 指定的配置位置。
典型用法¶
以下接口用法來自 Skill 簡介,屬於已覈實的調用面,不是完整可運行腳本。
讀取郵件:
GET /me/messages
這一調用對應「讀取郵箱」這一步,返回當前用戶郵箱中的消息,供後續分類與回覆使用。
發送回覆:
POST /me/sendMail
這一調用對應「回覆郵件」,請求體需由 Skill 封裝,具體字段以 SKILL.md 爲準。
時效記錄:
SQLite(本地存儲)
Skill 將回復 SLA 記錄在本地 SQLite 中。數據庫文件路徑、表結構與字段未在已抓取資料中給出,使用前應在包內確認。
適用場景與注意¶
適合的場景:需要程序化讀取和回覆 Outlook 郵件、把已處理郵件按規則移動到文件夾、並把回覆時效納入跟蹤的自動化任務。
需要注意的地方:
1、憑證安全。該 Skill 需要 API key 與 Microsoft Graph 應用憑證,不要把密鑰寫入公開倉庫或提交記錄。
2、權限範圍。Mail.ReadWrite 允許讀寫郵箱,Calendars.ReadWrite 允許讀寫日曆。上線前按最小必要範圍複覈。
3、SLA 是本地記錄。回覆時效存於本地 SQLite,屬於 Skill 自身狀態,不等同於企業級工單或審計系統。
4、信息缺口。安裝命令、配置字段、數據庫結構未在已抓取資料中出現,本稿不補齊這些細節,使用時應回到 Skill 包內核對。
結尾¶
這個 Skill 的價值在於把 Microsoft Graph 的郵件讀取、回覆、文件夾整理與本地 SLA 記錄接到同一條鏈路上,減少在網頁端重複操作。如果你已經在用 MSAL 對接 Graph,它可以作爲郵件處理這一環的現成入口。
官方地址:https://api.skillhub.cn/user_3c6cb52e/outlook-email-automation