申请抢先体验

请填写名字，以及邮箱或手机号。我们会与您联系，提供 Tajo 访问详情。

在本页面

构建你的第一个代理

本指南带你构建一个购物车挽回代理，这是一个 AI 代理，它监控被放弃的购物车，并用 Brevo 的 MCP 工具在邮件、SMS 和 WhatsApp 上编排个性化的挽回序列。

前置条件

拥有 API 密钥的 Brevo 账号（点此获取）
已配置好的 Brevo MCP 服务器（配置指南）
Claude Desktop、Claude Code 或任意兼容 MCP 的客户端
已在 Brevo 中创建用于购物车挽回的邮件模板

代理如何工作

代理就是一个 markdown 文件，它定义了：

身份，代理做什么以及它的约束
工具，它能访问哪些 MCP 工具
指令，它应如何推理和行动
护栏，它绝不能做什么

被调用时，代理用 LLM 推理目标、选择合适的工具，并对 Brevo 的 API 执行操作。

Marketer: "Set up cart recovery for carts over $50"
    ↓
Agent reads its specification (tools, constraints)
    ↓
Agent reasons: "I need to create a segment, design a sequence, set up tracking"
    ↓
Agent calls: brevo/create-segment → brevo/send-email → brevo/send-sms → brevo/track-event
    ↓
Result: 3-step recovery sequence active, tracking events flowing

第 1 步：定义代理

创建一个名为 cart-recovery-agent.md 的文件：

---
name: cart-recovery-agent
description: Recover abandoned carts with personalized multi-channel sequences
version: 1.0.0
temperature: 0.2
max_tokens: 4096
tools:
  - brevo/list-contacts
  - brevo/get-contact
  - brevo/create-segment
  - brevo/send-email
  - brevo/send-sms
  - brevo/track-event
  - brevo/get-email-templates
  - brevo/get-email-stats
triggers:
  - event: cart_abandoned
    conditions:
      - cart_value: "> 50"
      - time_since_activity: "> 30m"
  - schedule: "0 */4 * * *"
permissions:
  - contacts:read
  - email:send
  - sms:send
  - events:write
---

# Cart Recovery Agent

You are an e-commerce cart recovery specialist working with Brevo's
engagement platform. Your goal is to recover abandoned carts through
personalized, well-timed multi-channel outreach.

## Strategy

When a cart is abandoned:

1. **Wait 1 hour**, then send a reminder email with cart contents
2. **Wait 24 hours**, if no open → send SMS with urgency message
3. **Wait 48 hours**, if still no recovery → send final email with
   incentive (discount code if cart value > $100)

## Decision Framework

- Cart value < $50: Skip (not worth recovery cost)
- Cart value $50-$100: Email only (2 touches)
- Cart value $100-$250: Email + SMS (3 touches)
- Cart value > $250: Email + SMS + personal outreach flag

## Rules

- NEVER send more than 3 messages per abandoned cart
- NEVER contact customers who opted out of marketing
- ALWAYS check if cart was recovered before sending next step
- ALWAYS personalize with customer first name and cart items
- ALWAYS track recovery events for attribution
- Respect quiet hours: no SMS between 9pm-9am customer local time

## Email Templates

Use these Brevo template IDs:
- Reminder (step 1): template_id 101
- Urgency (step 2): template_id 102
- Incentive (step 3): template_id 103

## Metrics to Track

- `cart_recovery_email_sent`, recovery email dispatched
- `cart_recovery_sms_sent`, recovery SMS dispatched
- `cart_recovered`, customer completed purchase
- `cart_recovery_failed`, sequence completed without recovery

第 2 步：注册工具

代理需要访问特定的 Brevo MCP 工具。frontmatter 中的 tools 字段定义了代理能调用哪些工具。代理运行时只能调用这些工具，其余一律被阻止。

下面是每个工具在该代理中承担的职责：

tools:
  # Read customer data and cart state
  - brevo/list-contacts      # Find customers with abandoned carts
  - brevo/get-contact         # Get individual customer details

  # Create targeted segments
  - brevo/create-segment      # Segment by cart value, time, behavior

  # Send recovery messages
  - brevo/send-email          # Transactional recovery emails
  - brevo/send-sms            # SMS nudges for high-value carts

  # Track outcomes
  - brevo/track-event         # Log recovery attempts and results
  - brevo/get-email-stats     # Check if emails were opened
  - brevo/get-email-templates # Verify templates exist

第 3 步：创建执行链

对于复杂的代理，你可以定义一条多步执行链，由专职子代理分别负责不同阶段：

steps:
  - agent: analyzer
    input: |
      Analyze the abandoned cart data for the past 4 hours.
      Goal: {task}

      Use brevo/list-contacts to find contacts with
      CART_ABANDONED event in the last 4 hours.
      Segment by cart value tier.

  - agent: sequencer
    input: |
      Based on this analysis, design recovery sequences:
      {previous}

      For each tier, create the appropriate message sequence
      using the decision framework.

  - agent: executor
    input: |
      Execute these recovery sequences via Brevo:
      {previous}

      Send emails and SMS according to the timing rules.
      Track every action with brevo/track-event.

  - agent: reporter
    input: |
      Generate a recovery report from these execution results:
      {previous}

      Include: carts targeted, messages sent, early recoveries,
      projected revenue impact.

第 4 步：测试代理

使用 Claude Code

# Point Claude Code at your agent spec
claude --mcp brevo "Run the cart recovery agent for abandoned carts in the last 4 hours"

使用 Claude Desktop

配置好 Brevo MCP 服务器后，向 Claude 提出要求：

运行我的购物车挽回代理。检查过去 4 小时内金额超过 $50 的被放弃购物车，并执行挽回序列。

Claude 会：

读取代理规范
调用 brevo/list-contacts 查找被放弃的购物车
按决策框架依据购物车金额做细分
通过 brevo/send-email 发送挽回邮件
通过 brevo/send-sms 排入 SMS 跟进
通过 brevo/track-event 追踪所有事件

以编程方式执行

import { TajoAgent } from "@tajo/agent-sdk";
import { BrevoMCPServer } from "@tajo/brevo-mcp-server";

const brevo = new BrevoMCPServer({
  apiKey: process.env.BREVO_API_KEY,
});

const agent = new TajoAgent({
  specPath: "./cart-recovery-agent.md",
  mcpServers: [brevo],
  model: "claude-sonnet-4-6",
});

// Run the agent
const result = await agent.run(
  "Recover abandoned carts over $50 from the last 4 hours"
);

console.log(result.summary);
// → "Processed 23 abandoned carts. Sent 23 reminder emails,
//    8 SMS messages. 3 carts already recovered during execution."

第 5 步：为代理设定调度

按周期性计划运行代理：

基于 Cron

# In your agent spec frontmatter
triggers:
  - schedule: "0 */4 * * *"  # Every 4 hours
    timezone: "America/New_York"

基于事件

triggers:
  - event: cart_abandoned
    conditions:
      - cart_value: "> 50"
      - time_since_activity: "> 30m"
    debounce: 5m

Webhook

triggers:
  - webhook: /agents/cart-recovery/trigger
    method: POST
    authentication: api_key

第 6 步：监控与迭代

通过 Brevo 事件追踪代理的表现：

-- Recovery rate by cart value tier
SELECT
  CASE
    WHEN cart_value < 100 THEN '$50-$100'
    WHEN cart_value < 250 THEN '$100-$250'
    ELSE '$250+'
  END as tier,
  COUNT(*) as carts_targeted,
  SUM(CASE WHEN recovered THEN 1 ELSE 0 END) as recovered,
  ROUND(SUM(CASE WHEN recovered THEN 1 ELSE 0 END)::numeric
    / COUNT(*) * 100, 1) as recovery_rate_pct,
  SUM(CASE WHEN recovered THEN cart_value ELSE 0 END) as revenue_recovered
FROM cart_recovery_events
WHERE created_at > NOW() - INTERVAL '30 days'
GROUP BY tier
ORDER BY tier;

示例：完整的代理会话

下面是营销人员与购物车挽回代理之间的一次真实交互：

Marketer: "Check abandoned carts from today and start recovery"

Agent: Checking for abandoned carts in the last 24 hours...

[Calls brevo/list-contacts with filter CART_ABANDONED_AT > today]

Found 47 abandoned carts:
- 12 carts under $50 (skipping per policy)
- 23 carts $50-$100 (email-only tier)
- 8 carts $100-$250 (email + SMS tier)
- 4 carts over $250 (email + SMS + flag for personal outreach)

Starting recovery sequences...

[Calls brevo/send-email × 35 with template_id 101]
[Calls brevo/track-event × 35 with event "cart_recovery_email_sent"]

✅ Step 1 complete:
- 35 reminder emails sent
- 12 SMS queued for 24h follow-up (high-value carts)
- 4 carts flagged for personal outreach

Next check scheduled in 4 hours.
Recovery tracking events: cart_recovery_email_sent (35),
  cart_recovery_sms_queued (12), cart_recovery_escalated (4)

后续步骤

代理规范格式，代理 markdown 的完整参考
预置代理，开箱即用的营销代理
Skills 参考，全部可用的 MCP 工具
Brevo MCP 服务器，工具 schema 与权限