# Microsoft Graph 搜索技巧当要求搜索 OneDrive、Teams、Outlook 或其他 Microsoft 365 服务时，请使用curl 命令与 Microsoft Graph API 交互。 ## 🔒 安全第一的设计 **一条关键规则：克劳德永远不会向您展示您的令牌。** 简单的工作流程： 1.Claude为您打开Graph Explorer 2.您将令牌粘贴到聊天中（没问题） 3. Claude 在curl 命令中使用它，但**从不回显它** ** ** ## 第 1 步：获取访问令牌 **简单的 3 步流程：** 1. **Claude 打开 Graph Explorer**（自动） # macOS：打开“https://developer.microsoft.com/en-us/graph/graph-explorer” # Linux: xdg-open "https://developer.microsoft.com/en-us/graph/graph-explorer" # Windows：启动“https://developer.microsoft.com/en-us/graph/graph-explorer” 2. **您从浏览器获取令牌：** * 使用您的 Microsoft 帐户登录 * 单击“访问令牌”选项卡（或个人资料图标） * 复制访问令牌 * **在聊天中粘贴**（粘贴就可以了） 3. **克劳德默默地使用它：** * 替换curl命令中的“TOKEN” * 进行API调用 * **永远不会显示回来** **代币注释：** * 69-90 分钟后过期，需要时更换新的 * 克劳德将在会话中存储它 ** ** ## 步骤 2：使用 Graph API 进行搜索获得令牌后，将这些端点与curl一起使用： ### 统一搜索（推荐）一次搜索多个服务：卷曲 -X POST 'https://graph.microsoft.com/v1.0/search/query' \ -H '授权：不记名令牌' \ -H '内容类型：application/json' \ -d'{ “请求”：[ { “entityTypes”：[“driveItem”，“message”，“chatMessage”]， “查询”：{ "queryString": "在此处搜索术语" }, “来自”：0， “尺寸”：25 } ] }' **实体类型：** * `driveItem` \- OneDrive 和 SharePoint 文件 * `消息` \- Outlook 电子邮件 * `chatMessage` \- 团队消息 * `event` \- 日历事件 * `person` \- 人员/联系人 * `list` \- SharePoint 列表 * `listItem` \- SharePoint 列表项 * `site` \- SharePoint 网站 ### OneDrive 和 SharePoint 文件 **搜索文件：** 卷曲 'https://graph.microsoft.com/v1.0/me/drive/root/search(q='"'"'搜索词'"'"')' \ -H '授权：不记名令牌' **列出 OneDrive 根目录中的文件：** 卷曲'https://graph.microsoft.com/v1.0/me/drive/root/children'\ -H '授权：不记名令牌' **与我共享的文件：** 卷曲'https://graph.microsoft.com/v1.0/me/drive/sharedWithMe'\ -H '授权：不记名令牌' **最近的文件：** 卷曲'https://graph.microsoft.com/v1.0/me/drive/recent'\ -H '授权：不记名令牌' ### Outlook 电子邮件 **搜索电子邮件：** 卷曲 'https://graph.microsoft.com/v1.0/me/messages?$search="搜索词"' \ -H '授权：不记名令牌' **列出收件箱电子邮件（前 10 名）：** 卷曲 'https://graph.microsoft.com/v1.0/me/messages?$top=10&$select=subject,from,receivedDateTime' \ -H '授权：不记名令牌' **按发件人过滤：** 卷曲 'https://graph.microsoft.com/v1.0/me/messages?$filter=from/emailAddress/address eq '"'"'sender@example.com'"'"'' \ -H '授权：不记名令牌' ### 微软团队 **列出我的团队：** 卷曲'https://graph.microsoft.com/v1.0/me/joinedTeams'\ -H '授权：不记名令牌' **获取团队频道：** 卷曲'https://graph.microsoft.com/v1.0/teams/TEAM_ID/channels'\ -H '授权：不记名令牌' **获取频道消息：** 卷曲'https://graph.microsoft.com/v1.0/teams/TEAM_ID/channels/CHANNEL_ID/messages'\ -H '授权：不记名令牌' **我最近的聊天记录：** 卷曲'https://graph.microsoft.com/v1.0/me/chats'\ -H '授权：不记名令牌' ### 日历 **列出日历事件：** 卷曲'https://graph.microsoft.com/v1.0/me/calendar/events'\ -H '授权：不记名令牌' **搜索事件：** 卷曲 'https://graph.microsoft.com/v1.0/me/events?$search="会议主题"' \ -H '授权：不记名令牌' ** ** ## 查询参数 **常用查询参数：** * `$search="keywords"` \- 使用关键字搜索 * `$filter=property eq 'value'` \- 过滤结果 * `$select=field1,field2` \- 选择特定字段 * `$top=N` \- 限制为 N 个结果 * `$orderby=field desc` \- 对结果进行排序 * `$skip=N` \- 跳过 N 个结果（分页） ** ** ## 搜索示例 ###“查找我最近的 Excel 文件” 卷曲 'https://graph.microsoft.com/v1.0/me/drive/root/search(q='"'"'.xlsx'"'"')' \ -H '授权：不记名令牌' ###“搜索约翰发送的有关预算的电子邮件” 卷曲 'https://graph.microsoft.com/v1.0/me/messages?$search="from:johnbudget"' \ -H '授权：不记名令牌' ###“查找与我共享的包含‘提案’的文件” 卷曲 -X POST 'https://graph.microsoft.com/v1.0/search/query' \ -H '授权：不记名令牌' \ -H '内容类型：application/json' \ -d'{ “请求”：[{ “entityTypes”：[“driveItem”]， “查询”：{“queryString”：“提案”}， “来自”：0， “尺寸”：25 }] }' ###“显示提及‘发布’的我的团队消息” 卷曲 -X POST 'https://graph.microsoft.com/v1.0/search/query' \ -H '授权：不记名令牌' \ -H '内容类型：application/json' \ -d'{ “请求”：[{ "entityTypes": ["chatMessage"], “查询”：{“queryString”：“发布”}， “来自”：0， “尺寸”：25 }] }' ** ** ## 响应处理图形 API 返回 JSON。如果需要的话使用`jq`来解析：卷曲 '...' | jq '.value[] | {名称：.name，createdDateTime：.createdDateTime}' ** ** ## 错误处理常见错误： * **401 Unauthorized** ：令牌过期或无效 - 获取新令牌 * **403 Forbidden** ：缺少权限 - 用户需要在 Graph Explorer 中授予同意 * **429 请求过多**：速率受限 - 等待并重试 * **404 Not Found** : 资源不存在 * **400 Bad Request** ：无效的查询语法 - 检查 API 文档 ### 何时查阅文档在以下情况下使用 WebFetch 查找文档： 1. **发生错误** \-检查错误码参考 2. **不确定端点** \- 查找特定于服务的 API 文档 3. **查询不起作用** \- 查看查询参数指南 4. **权限被拒绝** \- 检查权限参考 5. **新要求** \- 搜索特定 API 端点 **示例：** # 如果您收到 403 错误并且不确定需要什么权限： WebFetch“https://learn.microsoft.com/en-us/graph/permissions-reference” “搜索 OneDrive 文件需要什么权限？” # 如果需要查找特定端点： WebFetch“https://learn.microsoft.com/en-us/graph/api/resources/driveitem” “如何在 OneDrive 中按文件类型过滤文件？” ** ** ## 文档和参考 **需要时使用 WebFetch 查阅这些文档：** ### 核心文档 * **图形 API 概述**： * **图形浏览器**：（交互式测试） * **API参考**： ### 搜索API * **搜索概述**： * **搜索查询 API** ： ### 特定于服务的 API * **OneDrive/文件 API** ： * **驱动器项目（文件）** ： * **Outlook/邮件 API** ： * **团队/聊天 API** ： * **日历/事件 API** ： ### 故障排除 * **错误代码**： * **权限参考**： * **限制/速率限制**： * **最佳实践**： ### 查询参数 * **查询参数指南**： * **OData 查询选项**： ** ** ## 所需权限 Graph Explorer 令牌通常包括： * `Files.Read.All` \- 读取 OneDrive 文件 * `Mail.Read` \- 阅读电子邮件 * `Chat.Read` \- 读取团队聊天记录 * `ChannelMessage.Read.All` \- 读取团队频道 * `Calendars.Read` \- 读取日历如果请求失败并返回 403，则用户需要同意 Graph Explorer 中的其他权限。 ** ** ## 最佳实践 1. **从统一搜索开始**（`/search/query`）进行跨服务搜索 2. **当您了解服务时，使用特定端点**以获得更好的性能 3. **使用`$top`参数限制结果**（默认值通常是10） 4. **使用“$select”仅选择需要的字段**以减少响应大小 5. **使用 `$skip` 和 `@odata.nextLink` 处理大型结果集的分页** 6. **令牌安全**：从不回显或打印令牌 - 它授予对用户数据的访问权限 ** ** ## 输出格式清楚地呈现结果： 📁 OneDrive“季度报告”搜索结果找到3个文件： 1.Q4-2024-报告.xlsx 修改时间：2024-12-15 路径：/文档/报告 🔗 [在 OneDrive 中查看] 2.季度总结最终报告.docx 修改时间：2024-12-10 路径：/文档/报告 🔗 [在 OneDrive 中查看] 3.Q4-演示文稿.pptx 修改时间：2024-12-05 路径：/共享/团队报告 🔗 [在 OneDrive 中查看] ** ** ## 常见查询 ###“在 OneDrive 中查找我的文件” → 打开 Graph Explorer，获取令牌，使用 `/me/drive/root/children` 或搜索端点 ###“在我的电子邮件中搜索 X” → 打开 Graph Explorer，获取令牌，使用 `/me/messages?$search="X"` ###“显示与我共享的文件” → 打开 Graph Explorer，获取令牌，使用 `/me/drive/sharedWithMe` ###“查找有关 X 的 Teams 消息” → 打开 Graph Explorer，获取 token，使用“chatMessage”实体类型进行统一搜索 ###“我有哪些会议？” → 打开 Graph Explorer，获取令牌，使用 `/me/calendar/events` ** ** ## 工作流程总结当用户要求搜索 Microsoft 365 时： 1. **打开浏览器**自动到Graph Explorer 2. **等待用户的令牌**（他们将其粘贴到聊天中） 3. **运行curl命令**将TOKEN替换为用户的令牌 4. **解析并以可读格式呈现**结果 5. **处理错误**（过期令牌=再次打开浏览器） 6. **使用WebFetch**如果遇到问题可以查阅文档 ** ** ## 重要提示 * **令牌流** \- 您将令牌粘贴到聊天中（这很好），Claude 永远不会将其显示回来 * **令牌将在 69-90 分钟后过期** \- 如果搜索停止工作，用户将需要刷新 * **适用速率限制** \- Microsoft Graph 有限制 * **权限有所不同** \- 某些操作需要管理员同意 * **存在 Beta 端点**，但使用 `/v1.0/` 来保持稳定性 * **搜索语法**因实体类型而异 - 有些支持 KQL（关键字查询语言） * **Graph Explorer 非常适合测试** \- 用户可以先在那里尝试查询 * **使用WebFetch获取文档** \- 当卡住或遇到错误时，查找相关文档 * **文档很全面** \- 大多数问题可以通过查看官方 Microsoft Learn 文档来解决 ** ** **最后更新：** 2026-01-11 **安全声明：** 一条规则：Claude 永远不会向您展示您的令牌。将其粘贴到聊天中，克劳德在curl命令中默默地使用它。

女士图搜索

包含技能