Első ügynök fejlesztése

Marketinges: "Állítson be kosárvisszaszerzést 50 $ felett lévő kosarakhoz"
    ↓
Az ügynök olvassa a specifikációját (eszközök, korlátok)
    ↓
Az ügynök gondolkodik: "Szegmenst kell létrehoznom, szekvenciát terveznem, követést beállítanom"
    ↓
Az ügynök hívja: brevo/create-segment → brevo/send-email → brevo/send-sms → brevo/track-event
    ↓
Eredmény: 3 lépéses visszaszerzési szekvencia aktív, követési események folynak

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

# Kosárvisszaszerző ügynök

Ön e-kereskedelmi kosárvisszaszerzési specialista, aki a Brevo
interakciós platformjával dolgozik. Célja az elhagyott kosarak
visszaszerzése személyre szabott, jól időzített többcsatornás üzenetküldéssel.

## Stratégia

Amikor egy kosarat elhagynak:

1. **Vájon 1 órát**, majd küldjön emlékeztető emailt a kosár tartalmával
2. **Vájon 24 órát**, ha nincs megnyitás → küldjön SMS-t sürgősségi üzenettel
3. **Vájon 48 órát**, ha még mindig nincs visszaszerzés → küldjön záró emailt
   ösztönzővel (kedvezménykód, ha a kosár értéke >100 $)

## Döntési keretrendszer

- Kosár értéke < 50 $: Hagyja ki (nem éri meg a visszaszerzési költséget)
- Kosár értéke 50-100 $: Csak email (2 érintkezési pont)
- Kosár értéke 100-250 $: Email + SMS (3 érintkezési pont)
- Kosár értéke > 250 $: Email + SMS + személyes megkeresés jelzése

## Szabályok

- SOHA ne küldjön 3-nál több üzenetet elhagyott kosaranként
- SOHA ne vegye fel a kapcsolatot azokkal, akik leiratkoztak a marketingről
- MINDIG ellenőrizze, hogy a kosarat visszanyerték-e a következő lépés elküldése előtt
- MINDIG személyre szabja az ügyfél keresztnevével és a kosár elemeivel
- MINDIG kövesse nyomon a visszaszerzési eseményeket a hozzárendeléshez
- Tartsa tiszteletben a csendes órákat: ne küldjön SMS-t 21:00-9:00 között az ügyfél helyi ideje szerint

## Email sablonok

Ezeket a Brevo sablonazonosítókat használja:
- Emlékeztető (1. lépés): template_id 101
- Sürgősség (2. lépés): template_id 102
- Ösztönző (3. lépés): template_id 103

## Követendő mérőszámok

- `cart_recovery_email_sent`, visszaszerzési email elküldve
- `cart_recovery_sms_sent`, visszaszerzési SMS elküldve
- `cart_recovered`, ügyfél teljesítette a vásárlást
- `cart_recovery_failed`, szekvencia befejezve visszaszerzés nélkül

tools:
  # Ügyféladatok és kosárállapot olvasása
  - brevo/list-contacts      # Elhagyott kosarú ügyfelek keresése
  - brevo/get-contact         # Egyéni ügyfél adatok lekérése

  # Célzott szegmensek létrehozása
  - brevo/create-segment      # Szegmentálás kosárérték, idő, viselkedés alapján

  # Visszaszerzési üzenetek küldése
  - brevo/send-email          # Tranzakciós visszaszerzési emailek
  - brevo/send-sms            # SMS nyomások magas értékű kosarakhoz

  # Eredmények követése
  - brevo/track-event         # Visszaszerzési kísérletek és eredmények naplózása
  - brevo/get-email-stats     # Emailek megnyitásának ellenőrzése
  - brevo/get-email-templates # Sablonok meglétének ellenőrzése

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

// Ügynök futtatása
const result = await agent.run(
  "Szerzze vissza az elmúlt 4 óra 50 $-nál nagyobb elhagyott kosarakat"
);

console.log(result.summary);
// → "23 elhagyott kosarat feldolgoztam. 23 emlékeztető emailt küldtem,
//    8 SMS üzenetet. 3 kosarat már visszanyertem a végrehajtás közben."

# Az ügynök specifikáció frontmatterében
triggers:
  - schedule: "0 */4 * * *"  # Minden 4 órában
    timezone: "America/New_York"

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

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

-- Visszaszerzési arány kosárérték szint szerint
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;

Marketinges: "Ellenőrizze a mai elhagyott kosarakat és indítsa el a visszaszerzést"

Ügynök: Ellenőrzöm az elmúlt 24 óra elhagyott kosarakat...

[Meghívja a brevo/list-contacts-ot CART_ABANDONED_AT > today szűrővel]

47 elhagyott kosarat találtam:
- 12 kosár 50 $ alatt (kihagyva a szabályzat szerint)
- 23 kosár 50-100 $ között (csak email szint)
- 8 kosár 100-250 $ között (email + SMS szint)
- 4 kosár 250 $ felett (email + SMS + személyes megkeresés jelzése)

Visszaszerzési szekvenciák indítása...

[Meghívja a brevo/send-email × 35-öt template_id 101-gyel]
[Meghívja a brevo/track-event × 35-öt "cart_recovery_email_sent" eseménnyel]

1. lépés kész:
- 35 emlékeztető email elküldve
- 12 SMS sorba állítva 24 órás utánkövetésre (magas értékű kosarak)
- 4 kosár jelölve személyes megkeresésre

Következő ellenőrzés 4 óra múlva ütemezve.
Visszaszerzési követési események: cart_recovery_email_sent (35),
  cart_recovery_sms_queued (12), cart_recovery_escalated (4)