Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το όνομά σας και ένα email ή έναν αριθμό τηλεφώνου. Θα σας στείλουμε πληροφορίες για την πρόσβαση στο Tajo.

Σε αυτή τη σελίδα

Δημιουργήστε τον πρώτο σας πράκτορα

Αυτός ο οδηγός σάς καθοδηγεί στη δημιουργία ενός πράκτορα ανάκτησης καλαθιού, ενός πράκτορα AI που παρακολουθεί τα εγκαταλελειμμένα καλάθια και ενορχηστρώνει μια εξατομικευμένη αλληλουχία ανάκτησης σε email, SMS και WhatsApp με τα εργαλεία MCP του Brevo.

Προϋποθέσεις

  • Λογαριασμός Brevo με κλειδί API (αποκτήστε ένα εδώ)
  • Διαμορφωμένος διακομιστής MCP Brevo (οδηγός ρύθμισης)
  • Claude Desktop, Claude Code ή οποιοσδήποτε πελάτης συμβατός με MCP
  • Πρότυπα email δημιουργημένα στο Brevo για την ανάκτηση καλαθιού

Πώς λειτουργούν οι πράκτορες

Ένας πράκτορας είναι ένα αρχείο markdown που ορίζει:

  1. Ταυτότητα, τι κάνει ο πράκτορας και ποιοι είναι οι περιορισμοί του
  2. Εργαλεία, σε ποια εργαλεία MCP έχει πρόσβαση
  3. Οδηγίες, πώς πρέπει να σκέφτεται και να δρα
  4. Δικλίδες ασφαλείας, τι δεν πρέπει ποτέ να κάνει

Όταν κληθεί, ο πράκτορας χρησιμοποιεί ένα LLM για να σκεφτεί τον στόχο, να επιλέξει τα κατάλληλα εργαλεία και να εκτελέσει ενέργειες μέσω του API Brevo.

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: Καταχωρίστε τα εργαλεία

Ο πράκτορας χρειάζεται πρόσβαση σε συγκεκριμένα εργαλεία MCP του Brevo. Το πεδίο tools στο frontmatter ορίζει ποια εργαλεία μπορεί να καλέσει ο πράκτορας. Όταν ο πράκτορας εκτελείται, μπορεί να καλέσει μόνο αυτά τα εργαλεία, καθετί άλλο μπλοκάρεται.

Να τι κάνει το καθένα από αυτά τα εργαλεία στο πλαίσιο αυτού του πράκτορα:

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: Δημιουργήστε την αλυσίδα εκτέλεσης

Για πιο σύνθετους πράκτορες, μπορείτε να ορίσετε μια αλυσίδα εκτέλεσης πολλών βημάτων, όπου εξειδικευμένοι υποπράκτορες αναλαμβάνουν διαφορετικές φάσεις:

chain.yaml
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

Terminal window
# 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

Μόλις διαμορφωθεί ο διακομιστής MCP Brevo, ζητήστε από το Claude:

Εκτέλεσε τον πράκτορα ανάκτησης καλαθιού μου. Έλεγξε για εγκαταλελειμμένα καλάθια άνω των 50 $ τις τελευταίες 4 ώρες και εκτέλεσε την αλληλουχία ανάκτησης.

Το Claude θα:

  1. Διαβάσει την προδιαγραφή του πράκτορα
  2. Καλέσει το brevo/list-contacts για να εντοπίσει τα εγκαταλελειμμένα καλάθια
  3. Τμηματοποιήσει με βάση την αξία καλαθιού χρησιμοποιώντας το πλαίσιο αποφάσεων
  4. Στείλει email ανάκτησης μέσω του brevo/send-email
  5. Βάλει σε ουρά τις επακόλουθες αποστολές SMS μέσω του brevo/send-sms
  6. Παρακολουθήσει όλα τα συμβάντα μέσω του 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)

Επόμενα βήματα

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το όνομά σας και ένα email ή έναν αριθμό τηλεφώνου. Θα σας στείλουμε πληροφορίες για την πρόσβαση στο Tajo.

αυτόματη αναγνώριση
AI Βοηθός

Γεια! Ρωτήστε με οτιδήποτε για την τεκμηρίωση.