اپنا پہلا ایجنٹ بنانا
اپنا پہلا ایجنٹ بنانا
یہ گائیڈ آپ کو کارٹ ریکوری ایجنٹ بنانے کے عمل سے گزارتی ہے, ایک AI ایجنٹ جو ترک شدہ کارٹس کی نگرانی کرتا ہے اور Brevo کے MCP ٹولز استعمال کر کے ای میل، SMS اور WhatsApp میں ذاتی نوعیت کی ریکوری سیکوینس آرکیسٹریٹ کرتا ہے۔
ضروریات
- Brevo اکاؤنٹ API کلید کے ساتھ (یہاں سے حاصل کریں)
- Brevo MCP سرور ترتیب دیا ہوا (سیٹ اپ گائیڈ)
- Claude Desktop، Claude Code، یا کوئی MCP مطابق کلائنٹ
- Brevo میں کارٹ ریکوری کے لیے ای میل ٹیمپلیٹس بنائی ہوئی
ایجنٹس کیسے کام کرتے ہیں
ایجنٹ ایک markdown فائل ہے جو تعریف کرتی ہے:
- شناخت, ایجنٹ کیا کرتا ہے اور اس کی پابندیاں
- ٹولز, کون سے MCP ٹولز تک رسائی ہے
- ہدایات, کیسے استدلال اور عمل کرنا ہے
- باڑیں, کیا کبھی نہیں کرنا چاہیے
مرحلہ 1: ایجنٹ کی تعریف کریں
cart-recovery-agent.md نامی فائل بنائیں:
---name: cart-recovery-agentdescription: Recover abandoned carts with personalized multi-channel sequencesversion: 1.0.0temperature: 0.2max_tokens: 4096tools: - 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-statstriggers: - 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'sengagement platform. Your goal is to recover abandoned carts throughpersonalized, well-timed multi-channel outreach.
## Strategy
When a cart is abandoned:
1. **Wait 1 hour**, then send a reminder email with cart contents2. **Wait 24 hours**, if no open → send SMS with urgency message3. **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: ٹولز رجسٹر کریں
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 # تصدیق کریں کہ ٹیمپلیٹس موجود ہیںمرحلہ 3: ایجنٹ ٹیسٹ کریں
Claude Desktop کے ساتھ
Brevo MCP سرور ترتیب دینے کے بعد، Claude سے پوچھیں:
میرا کارٹ ریکوری ایجنٹ چلائیں۔ پچھلے 4 گھنٹوں میں $50 سے زیادہ کے ترک شدہ کارٹس چیک کریں اور ریکوری سیکوینس چلائیں۔
پروگرامیٹک ایگزیکیوشن
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);مرحلہ 4: ایجنٹ شیڈول کریں
triggers: - schedule: "0 */4 * * *" # ہر 4 گھنٹے timezone: "America/New_York"اگلے اقدامات
- ایجنٹ مواصفات فارمیٹ, ایجنٹ markdown کے لیے مکمل ریفرنس
- تیار شدہ ایجنٹس, استعمال کے لیے تیار مارکیٹنگ ایجنٹس
- اسکلز ریفرنس, تمام دستیاب MCP ٹولز
- Brevo MCP سرور, ٹول اسکیمے اور اجازتیں