用途:该技能用于让 AI 代理通过 Membrane CLI 与 SendGrid 交互,管理邮件营销与投递相关数据。SendGrid 是云端邮件投递平台,用于发送事务性与营销邮件、跟踪邮件表现并保障投递可靠性。官方文档:https://developers.sendgrid.com/
主要能力:覆盖邮件发送(send-email、send-email-with-template)、事务性模板管理(创建、获取、分页列出模板)、营销联系人管理(创建/获取/列出/删除联系人列表,按 ID 获取、搜索、增改、删除联系人,搜索使用 SendGrid Query Language)、发件人身份管理,以及抑制列表处理(退信、垃圾举报、全局退订的列出与删除)。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest;再登录:membrane login --tenant --clientName=<agentType>,无交互环境会打印授权 URL,完成后执行 membrane login complete <code>。连接 SendGrid:membrane connection ensure "https://sendgrid.com/" --json,用户在浏览器完成认证;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。动作未覆盖时可用代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query、--pathParam 等选项。任意命令加 --json 可获得机器可读输出。
适用场景:需要以代理方式批量管理 SendGrid 联系人、模板、抑制列表或发送邮件的自动化流程。
限制:认证与凭据刷新由 Membrane 服务端处理,不应向用户索取 API 密钥;具体动作参数以 inputSchema 为准;资料未提供价格、配额或平台支持范围等信息。