Outlook

• 您希望 AI 代理从用户的 Outlook 或 Microsoft 365 邮箱中读取、分类或发送电子邮件。
• 您需要自动化日历日程安排——创建、列出或删除包含参与者的事件。
• 您希望以编程方式查询或更新用户的 Outlook 联系人。
• 您需要针对 Microsoft Graph 邮件和日历端点提供完整的 OData 查询支持（筛选、排序、分页、字段选择）。

• 您需要与 Outlook 以外的第三方应用集成 — 请改用 api-gateway skill。
• 您需要连接非 Microsoft 电子邮件提供商（Gmail、IMAP 等）— 此 skill 仅适用于 Outlook/Microsoft 365。

与 Microsoft 的身份验证完全由 Maton 的网关处理。您的代理只需要一个 MATON_API_KEY；OAuth 令牌会在每次代理请求发送至 graph.microsoft.com 时自动注入。

列出、阅读、创建草稿、发送、更新（例如标记为已读）、移动和删除邮件。支持按文件夹、已读状态及其他 OData 谓词进行筛选，同时支持 Text 和 HTML 两种正文内容类型。

创建、列出和删除邮件文件夹，包括子文件夹。已知文件夹名称（Inbox、Drafts、SentItems、DeletedItems、Archive、JunkEmail）可直接用作文件夹 ID。

列出日历、通过日期范围筛选器检索即将到来的事件、创建包含与会者和时区的事件，以及删除事件——所有操作均通过 Microsoft Graph 日历端点完成。

列出、检索、创建和删除 Outlook 联系人，包括设置姓名和电子邮件地址。

使用标准 OData 参数——$top、$skip、$select、$filter、$orderby 和 $search——对任意受支持端点的结果进行分页、排序和筛选。

AI 代理使用 $filter=isRead eq false 轮询收件箱中的未读邮件，对其进行摘要或分类，将其标记为已读，并将相关邮件移动到特定文件夹——全程无需任何手动 OAuth 配置。

当用户请求安排会议时，代理通过托管代理向 Microsoft Graph 日历端点发送请求，创建包含正确时间、时区和参与者信息的日历事件。

代理可以直接从用户的 Outlook 账户发送事务性或通知类电子邮件，适用于由外部事件触发的自动报告、提醒或跟进消息。

在工作流程中，助手可以检查某人是否存在于用户的 Outlook 联系人中，如果不存在则创建新的联系人条目——使地址簿与业务往来保持同步。