Adapty Mail 智能体技能
adapty-mail 技能让你可以在 AI 编码工具中运行 Adapty Mail 项目。它通过 Adapty Mail MCP 服务器 以你的身份登录并运行。它可以启动流程、翻译营销活动内容、引导你完成发送域名的 DNS 配置与验证、查看营销活动和 A/B 测试结果,以及排查某用户未收到邮件的原因。
The MCP server alone gives your agent the tools. The skill adds what an agent gets wrong without it:
- 连接服务器:验证服务器是否已连接并登录。如果未连接,会为你提供客户端的配置步骤。
- 邮件还是 Adapty 其他功能:流程、市场细分和用户画像在 Adapty Mail 与 Adapty 应用内付费墙中含义不同。该技能会在做任何修改前先确认你指的是哪一个。
- 只能在看板中完成的操作:当请求需要填写公司地址、开启网页结账或数据发送时,它会告知你,并提供相关说明页面的链接。
- 上线后的工作:效果分析、A/B 测试、送达率以及追踪丢失的邮件。
没有您的确认,任何内容都不会发送给真实用户。保存流程即开始发送,保存时的市场细分列表将替换整个流程,因此该技能会首先展示流程的完整面貌:每个市场细分、每个活动,以及所有已移除的内容。删除、取消订阅,以及 A/B 测试的启动和结束,同样需要您的确认。
安装技能
adapty-mail 技能是 adapty-skills 插件 的一部分。要安装该插件,请在终端中运行:
npx adapty skills install
重启你的 agent 以加载技能。其他安装方式请参阅插件 README。
该技能需要 Adapty Mail MCP 服务器。如果你的 AI 助手尚未连接,请让它连接 Adapty Mail。技能会为你的客户端提供连接命令,你在 Adapty Mail 看板中确认连接即可。每个客户端的详细步骤请参阅使用 AI 助手管理 Adapty Mail。
你可以这样提问
- “连接 Adapty Mail,告诉我我的项目缺少什么。”
- “为订阅已到期的用户设置赢回优惠流程。”
- “将我的账单问题活动翻译成德语和西班牙语。”
- “添加我们的域名作为发送域,并引导我完成 DNS 记录配置。”
- “上个月哪个活动的转化效果最好?”
- “我在从未购买过的用户流程上的 A/B 测试已经运行了三周。哪个实验变体应该胜出?”
- “为什么这个用户没有收到我们的试用到期邮件?“
调用了 6 个 Adapty Mail 工具
whoamiproject_listcontainer_listcampaign_listsegment_metasegment_create
我已创建了一个德国市场细分,并将其置于您”未购买”流程中”所有用户”的上方,这样其他用户仍会收到原来的内容。
你的流程目前有两行:付费试用用户进入 Trial nudge,其他所有人进入 Welcome series。德国行插入在它们之间。在德国的付费试用用户仍然会进入 Trial nudge,因为行是从上到下依次检查的。
Flow: Never purchased, marketing
1. Paid trial users → Trial nudge (unchanged)
2. Germany → Welcome series DE (new)
3. All users → Welcome series (moved from 2)
Removed: nothing保存后会立即发送给真实用户。确认保存吗?
- 是,保存流程
- 否,先修改一些内容
工作原理
- 连接。 技能会验证 MCP 服务器是否正常响应,并确认您已登录。
- 了解现状。 技能会找到您的项目,并读取已有的配置信息:品牌、公司地址、发送域、活动、流程,以及数据最后到达的时间。它会复用现有内容。
- 制定计划。 在开始执行前,技能会列出只能由您在看板中完成的操作。
- 执行。 技能通过服务器工具逐步操作,并向您展示每一步的结果。凡是会向真实用户发送邮件或无法撤销的操作,都会等待您的确认。
为什么邮件未发送
当你询问某个用户时,该技能会读取其用户画像及行为旅程,然后按顺序逐一排查以下原因,找到第一个能解释问题的原因后即停止:
- 该用户画像已被屏蔽:已退订、邮件退回、投诉举报或地址验证失败。详见退订与屏蔽。
- 该用户已在另一个营销流程中。
- 该用户已完成购买,因此序列按预期结束。
- 在域名预热期间,发送限制导致邮件被延迟。
- 触发器从未触发。原因可能是没有购买事件到达 Adapty Mail,或者用户画像在设置完成前就已进入。
- 流程中没有任何市场细分匹配该用户。
- 双重确认订阅已开启,但该用户尚未确认地址。
- 该邮件仍在按用户所在时区安排的发送窗口中等待发送。
调用了 3 个只读 Adapty Mail 工具
profile_listprofile_getprofile_journey
该地址已于 10 月 12 日取消订阅,因此 Adapty Mail 不再向其发送任何营销邮件。
取消订阅来自您”试用期已到期”活动第二封邮件中的链接。试用期于 10 月 15 日到期,此后该流程从未为此用户启动。购买确认邮件及其他事务性邮件仍可正常送达该地址。
只有 Adapty 支持团队才能解除抑制,且只有取消订阅的用户本人才能提出申请。