Изграждане на първия ви агент

Маркетолог: "Настройте възстановяване на количка за колички над $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
---

# Агент за възстановяване на количка

Вие сте специалист по възстановяване на колички в електронната търговия,
работещ с ангажиращата платформа на Brevo. Вашата цел е да възстановявате
изоставени колички чрез персонализиран, добре изчислен многоканален подход.

## Стратегия

При изоставяне на количка:

1. **Изчакайте 1 час**, след това изпратете напомнящ имейл със съдържанието на количката
2. **Изчакайте 24 часа**, при липса на отваряне → изпратете SMS с съобщение за спешност
3. **Изчакайте 48 часа**, при все още липса на възстановяване → изпратете финален имейл с
   стимул (код за отстъпка ако стойността на количката > $100)

## Рамка за вземане на решения

- Стойност на количката <$50: Пропуснете (не си струва разходите за възстановяване)
- Стойност на количката $50-$100: Само имейл (2 допирни точки)
- Стойност на количката $100-$250: Имейл + SMS (3 допирни точки)
- Стойност на количката > $250: Имейл + SMS + флаг за личен подход

## Правила

- НИКОГА не изпращайте повече от 3 съобщения на изоставена количка
- НИКОГА не се свързвайте с клиенти, отписали се от маркетинг
- ВИНАГИ проверявайте дали количката е възстановена преди изпращане на следващата стъпка
- ВИНАГИ персонализирайте с собственото им на клиента и артикулите в количката
- ВИНАГИ проследявайте събитията за възстановяване за атрибутиране
- Спазвайте тихите часове: без SMS между 21:00-9:00 местно време на клиента

## Шаблони за имейл

Използвайте тези ID на шаблони в Brevo:
- Напомняне (стъпка 1): template_id 101
- Спешност (стъпка 2): template_id 102
- Стимул (стъпка 3): template_id 103

## Метрики за проследяване

- `cart_recovery_email_sent`, изпратен имейл за възстановяване
- `cart_recovery_sms_sent`, изпратен SMS за възстановяване
- `cart_recovered`, клиентът е завършил покупката
- `cart_recovery_failed`, поредицата приключи без възстановяване

tools:
  # Четете клиентски данни и статус на количката
  - brevo/list-contacts      # Намиране на клиенти с изоставени колички
  - brevo/get-contact         # Вземане на детайли за отделен клиент

  # Създаване на насочени сегменти
  - brevo/create-segment      # Сегментиране по стойност на количката, времe, поведение

  # Изпращане на съобщения за възстановяване
  - 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);
// → "Processed 23 abandoned carts. Sent 23 reminder emails,
//    8 SMS messages. 3 carts already recovered during execution."

# Във frontmatter на вашата спецификация на агент
triggers:
  - schedule: "0 */4 * * *"  # На всеки 4 часа
    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

-- Процент на възстановяване по ниво на стойността на количката
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;

Маркетолог: "Проверете изоставените колички от днес и стартирайте възстановяването"

Агент: Проверка за изоставени колички в последните 24 часа...

[Извиква brevo/list-contacts с филтър CART_ABANDONED_AT > днес]

Намерени 47 изоставени колички:
- 12 колички под $50 (пропускат се по политика)
- 23 колички $50-$100 (ниво само за имейл)
- 8 колички $100-$250 (ниво имейл + SMS)
- 4 колички над $250 (имейл + SMS + флаг за личен подход)

Стартиране на поредици за възстановяване...

[Извиква brevo/send-email × 35 с template_id 101]
[Извиква brevo/track-event × 35 със събитие "cart_recovery_email_sent"]

✅ Стъпка 1 завършена:
- 35 напомнящи имейла изпратени
- 12 SMS-а поставени в опашка за проследяване след 24ч (колички с висока стойност)
- 4 колички маркирани за личен подход

Следваща проверка планирана след 4 часа.
Проследяващи събития: cart_recovery_email_sent (35),
  cart_recovery_sms_queued (12), cart_recovery_escalated (4)