Gmail

• 您希望 AI 代理代表您讀取、分類或回覆 Gmail 郵件。
• 您需要自動化電子郵件工作流程，例如草擬回覆、套用標籤或刪除郵件。
• 您希望使用 Gmail 搜尋運算子（例如 is:unread、has:attachment、from:）查詢收件匣，而無需自行設定 OAuth 整合。
• 您正在建立多步驟代理管線，需要在採取進一步行動之前擷取電子郵件內容。

• 您需要與 Gmail 以外的第三方應用程式整合 — 請改用 api-gateway skill。
• 您需要存取 Gmail 以外的 Google 服務（例如 Google 日曆、Google 雲端硬碟）— 此 skill 僅限於 Gmail。

驗證由 Maton 的閘道器負責處理。您只需在 ctrl.maton.ai 完成一次 Google 帳戶連結，後續所有 API 呼叫都會自動取得有效的 OAuth Token。無需自行管理更新 Token 或 OAuth 範圍。

支援列出與讀取郵件、發送郵件、列出與擷取對話串、管理標籤、將郵件移至垃圾桶，以及建立或發送草稿。閘道透過原生 Gmail API 路徑直接代理至 gmail.googleapis.com。

使用 Gmail 原生的 q 參數，搭配 is:unread、from:、subject:、has:attachment 以及日期範圍等運算子，無需額外的解析邏輯即可精確篩選訊息。

在單一 Maton API 金鑰下管理多個 Gmail 連線。透過 Maton-Connection 標頭指定每次請求所使用的帳戶，或讓閘道器自動預設使用您的主要有效連線。

透過單一 API 呼叫，對任意郵件新增或移除 Gmail 標籤（STARRED、UNREAD、INBOX 等），實現收件匣自動化整理工作流程。

一個 AI 代理程式使用 q=is:unread 列出未讀郵件，讀取每封郵件的內容，對其進行分類、套用標籤，並將低優先級的電子郵件標記為已讀——全程無需任何人工介入。

根據提示或觸發條件（例如新的潛在客戶表單提交），代理程式會建立一封包含個人化回覆的 Gmail 草稿，並透過「傳送草稿」端點將其儲存以供人工審核，或立即傳送。

代理程式透過寄件人或主旨關鍵字查詢 Gmail 郵件，擷取訊息內容，並提取結構化資料（例如發票明細、訂單確認資訊），以供後續處理或儲存使用。

代理程式依排程擷取完整的 Gmail 郵件串，對對話歷史進行摘要整理，並提取待辦事項——適用於監控客戶支援郵件串或專案討論。