بناء أول وكيل لك

المسوّق: "أعدّ استرداد السلة لسلات تتجاوز $50"
    ↓
يقرأ الوكيل مواصفاته (الأدوات، القيود)
    ↓
يستدل الوكيل: "أحتاج إنشاء شريحة، تصميم تسلسل، إعداد التتبع"
    ↓
يستدعي الوكيل: brevo/create-segment → brevo/send-email → brevo/send-sms → brevo/track-event
    ↓
النتيجة: تسلسل استرداد من 3 خطوات نشط، أحداث التتبع تتدفق

---
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

tools:
  # قراءة بيانات العميل وحالة السلة
  - brevo/list-contacts      # العثور على العملاء بسلات متروكة
  - brevo/get-contact         # الحصول على تفاصيل العميل الفردي

  # إنشاء شرائح موجّهة
  - brevo/create-segment      # التقسيم حسب قيمة السلة، الوقت، السلوك

  # إرسال رسائل الاسترداد
  - brevo/send-email          # رسائل بريد استرداد تحويلية
  - brevo/send-sms            # رسائل SMS للسلات ذات القيمة العالية

  # تتبع النتائج
  - brevo/track-event         # تسجيل محاولات الاسترداد ونتائجها
  - brevo/get-email-stats     # التحقق من فتح الرسائل
  - brevo/get-email-templates # التحقق من وجود القوالب

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",
});

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

console.log(result.summary);

# في frontmatter مواصفات وكيلك
triggers:
  - schedule: "0 */4 * * *"  # كل 4 ساعات
    timezone: "America/New_York"

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
FROM cart_recovery_events
WHERE created_at > NOW() - INTERVAL '30 days'
GROUP BY tier
ORDER BY tier;