用途:该技能用于与 Microsoft Graph API 交互。Microsoft Graph API 是 RESTful Web API,可访问 Microsoft 云服务资源,用于将应用与 Outlook、OneDrive、Azure AD 等 Microsoft 365 服务集成,通过统一终结点访问 Microsoft 生态中的数据与洞察。官方文档:https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0。可操作资源包括 User、Mailbox Settings、Calendar、Event、Contact、Drive、Item、Permission、Group、Organization。
使用方式:本技能通过 Membrane CLI 与 Microsoft Graph API 交互,Membrane 自动处理认证和凭证刷新。先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无头环境会打印授权 URL,用户完成登录后用 membrane login complete <code> 收尾;任意命令加 --json 可获得机器可读输出;agent 类型包括 claude、openclaw、codex、warp、windsurf 等。
建立连接:membrane connection ensure "" --json,用户在浏览器完成认证,输出含连接 id;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至就绪。状态含义:READY 可继续;CLIENT_ACTION_REQUIRED 需按 clientAction 处理(connect 表示需认证,provide-input 表示需更多信息,uiUrl 为可选操作页面,agentInstructions 为程序化指引);CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,查看 error 字段。
搜索与执行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 可按自然语言描述查找动作,结果含 id、name、description、inputSchema、outputSchema。执行:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}',结果在响应的 output 字段。
代理请求:当现有动作无法覆盖需求时,可通过 Membrane 代理直接向 API 发请求:membrane request CONNECTION_ID /path/to/endpoint。常用选项:-X/--method 指定 HTTP 方法(GET、POST、PUT、PATCH、DELETE,默认 GET);-H/--header 添加请求头(可重复);-d/--data 请求体;--json 发送 JSON 体并设置 Content-Type;--rawData 原样发送;--query 查询字符串参数(可重复);--pathParam 路径参数(可重复)。
最佳实践:优先使用 Membrane 与外部应用通信以节省 token 并提升安全性;先发现再构建,用 action list --intent=QUERY 查找已有动作;不要向用户索取 API 密钥或令牌,改用连接,由 Membrane 在服务端管理完整认证生命周期。限制:具体动作清单、可用参数与返回结构需通过命令实时查询;资料未提供价格、平台支持范围等信息。