On this page

Ihren ersten Agent erstellen

Diese Anleitung führt Sie durch die Erstellung eines Warenkorb-Wiederherstellungs-Agents – ein KI-Agent, der abgebrochene Warenkörbe überwacht und eine personalisierte Wiederherstellungssequenz über E-Mail, SMS und WhatsApp mit Brevos MCP-Tools orchestriert.

Voraussetzungen

Brevo-Konto mit API-Schlüssel (hier erhalten)
Brevo MCP-Server konfiguriert (Einrichtungsanleitung)
Claude Desktop, Claude Code oder einen MCP-kompatiblen Client
In Brevo erstellte E-Mail-Vorlagen für die Warenkorbwiederherstellung

Funktionsweise von Agents

Ein Agent ist eine Markdown-Datei, die folgendes definiert:

Identität, was der Agent tut und seine Einschränkungen
Tools, auf welche MCP-Tools er zugreifen kann
Anweisungen, wie er denken und handeln soll
Leitplanken, was er niemals tun soll

Bei Aufruf nutzt der Agent ein LLM, um über das Ziel nachzudenken, geeignete Tools auszuwählen und Aktionen gegen Brevos API auszuführen.

Marketer: "Warenkorbwiederherstellung für Warenkörbe über $50 einrichten"
    ↓
Agent liest seine Spezifikation (Tools, Einschränkungen)
    ↓
Agent denkt: "Ich muss ein Segment erstellen, eine Sequenz entwerfen, Tracking einrichten"
    ↓
Agent ruft auf: brevo/create-segment → brevo/send-email → brevo/send-sms → brevo/track-event
    ↓
Ergebnis: 3-stufige Wiederherstellungssequenz aktiv, Tracking-Events fließen

Schritt 1: Agent definieren

Eine Datei namens cart-recovery-agent.md erstellen:

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

Schritt 2: Tools registrieren

Der Agent benötigt Zugriff auf bestimmte Brevo MCP-Tools. Das tools-Feld im Frontmatter definiert, welche Tools der Agent aufrufen kann. Wenn der Agent läuft, kann er nur diese Tools aufrufen – alles andere ist gesperrt.

Was jedes Tool im Kontext dieses Agents tut:

tools:
  # Kundendaten und Warenkorb-Status lesen
  - brevo/list-contacts      # Kunden mit abgebrochenen Warenkörben finden
  - brevo/get-contact         # Einzelne Kundendetails abrufen

  # Gezielte Segmente erstellen
  - brevo/create-segment      # Nach Warenkorbwert, Zeit, Verhalten segmentieren

  # Wiederherstellungsnachrichten senden
  - brevo/send-email          # Transaktionelle Wiederherstellungs-E-Mails
  - brevo/send-sms            # SMS-Nudges für hochwertige Warenkörbe

  # Ergebnisse verfolgen
  - brevo/track-event         # Wiederherstellungsversuche und Ergebnisse protokollieren
  - brevo/get-email-stats     # Prüfen, ob E-Mails geöffnet wurden
  - brevo/get-email-templates # Sicherstellen, dass Vorlagen existieren

Schritt 3: Ausführungskette erstellen

Für komplexe Agents können Sie eine mehrstufige Ausführungskette definieren, bei der spezialisierte Sub-Agents verschiedene Phasen übernehmen:

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.

Schritt 4: Agent testen

Mit Claude Code

# Claude Code auf Ihre Agent-Spezifikation zeigen
claude --mcp brevo "Run the cart recovery agent for abandoned carts in the last 4 hours"

Mit Claude Desktop

Sobald der Brevo MCP-Server konfiguriert ist, Claude fragen:

Meinen Warenkorb-Wiederherstellungs-Agent ausführen. Nach abgebrochenen Warenkörben über $50 in den letzten 4 Stunden suchen und die Wiederherstellungssequenz ausführen.

Claude wird:

Die Agent-Spezifikation lesen
brevo/list-contacts aufrufen, um abgebrochene Warenkörbe zu finden
Nach Warenkorbwert über das Entscheidungsframework segmentieren
Wiederherstellungs-E-Mails über brevo/send-email senden
SMS-Follow-ups über brevo/send-sms in die Warteschlange stellen
Alle Events über brevo/track-event verfolgen

Programmatische Ausführung

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

// Agent ausführen
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."

Schritt 5: Agent planen

Den Agent nach einem wiederkehrenden Zeitplan ausführen:

Cron-basiert

# Im Frontmatter Ihrer Agent-Spezifikation
triggers:
  - schedule: "0 */4 * * *"  # Alle 4 Stunden
    timezone: "America/New_York"

Event-gesteuert

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

Schritt 6: Überwachen & Iterieren

Agent-Performance über Brevo-Events verfolgen:

-- Wiederherstellungsrate nach Warenkorbwert-Stufe
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;

Beispiel: Vollständige Agent-Sitzung

Eine echte Interaktion zwischen einem Marketer und dem Warenkorb-Wiederherstellungs-Agent:

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)

Nächste Schritte

Agent-Spezifikations-Format, Vollständige Referenz für Agent-Markdown
Vorgefertigte Agents, Sofort einsatzbereite Marketing-Agents
Skills-Referenz, Alle verfügbaren MCP-Tools
Brevo MCP-Server, Tool-Schemas und Berechtigungen

Ihren ersten Agent erstellen