On this page

Budování prvního agenta

Tento průvodce vás provede vytvořením Agenta obnovy košíku, AI agenta monitorujícího opuštěné košíky a orchestrujícího personalizovanou sekvenci obnovy přes e-mail, SMS a WhatsApp pomocí MCP nástrojů Brevo.

Předpoklady

Účet Brevo s API klíčem (získejte zde)
Nakonfigurovaný Brevo MCP server (průvodce nastavením)
Claude Desktop, Claude Code nebo jiný MCP-kompatibilní klient
E-mailové šablony vytvořené v Brevo pro obnovu košíku

Jak agenti fungují

Agent je markdown soubor definující:

Identitu, co agent dělá a jeho omezení
Nástroje, ke kterým MCP nástrojům má přístup
Instrukce, jak by měl uvažovat a jednat
Omezení, co nikdy nesmí dělat

Při volání agent používá LLM k uvažování o cíli, výběru vhodných nástrojů a provádění akcí proti API Brevo.

Marketér: "Nastavte obnovu košíku pro košíky nad $50"
    ↓
Agent čte svou specifikaci (nástroje, omezení)
    ↓
Agent uvažuje: "Musím vytvořit segment, navrhnout sekvenci, nastavit sledování"
    ↓
Agent volá: brevo/create-segment → brevo/send-email → brevo/send-sms → brevo/track-event
    ↓
Výsledek: Aktivní 3-kroková sekvence obnovy, probíhající sledovací události

Krok 1: Definujte agenta

Vytvořte soubor 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
---

# Agent obnovy košíku

Jste specialista na obnovu košíků v e-commerce,
pracující s engagementovou platformou Brevo. Vaším cílem je obnovovat
opuštěné košíky prostřednictvím personalizovaného, dobře načasovaného vícekanálového přístupu.

## Strategie

Při opuštění košíku:

1. **Počkejte 1 hodinu**, pak odešlete připomínkový e-mail s obsahem košíku
2. **Počkejte 24 hodin**, pokud nebylo otevřeno → odešlete SMS s naléhavostí
3. **Počkejte 48 hodin**, pokud stále nebyla provedena obnova → odešlete závěrečný e-mail
   s stimulem (slevový kód, pokud hodnota košíku > $100)

## Rozhodovací rámec

- Hodnota košíku &lt;$50: Přeskočte (nestojí za náklady na obnovu)
- Hodnota košíku $50-$100: Pouze e-mail (2 kontaktní body)
- Hodnota košíku $100-$250: E-mail + SMS (3 kontaktní body)
- Hodnota košíku > $250: E-mail + SMS + příznak pro osobní oslovení

## Pravidla

- NIKDY neposílejte více než 3 zprávy na opuštěný košík
- NIKDY nekontaktujte zákazníky odhlášené z marketingu
- VŽDY ověřte, zda byl košík obnoven před odesláním dalšího kroku
- VŽDY personalizujte s křestním jménem zákazníka a položkami v košíku
- VŽDY sledujte události obnovy pro atribuci
- Dodržujte tiché hodiny: bez SMS mezi 21:00-9:00 místního času zákazníka

Krok 2: Zaregistrujte nástroje

Agent potřebuje přístup ke specifickým MCP nástrojům Brevo. Pole tools ve frontmatter definuje, které nástroje může agent volat. Když agent běží, může volat pouze tyto nástroje, vše ostatní je blokováno.

Krok 4: Otestujte agenta

S Claude Code

# Nasměrujte Claude Code na vaši specifikaci agenta
claude --mcp brevo "Run the cart recovery agent for abandoned carts in the last 4 hours"

S Claude Desktop

Po nakonfigurování Brevo MCP serveru se zeptejte Claude:

Spusťte mého agenta obnovy košíku. Zkontrolujte opuštěné košíky nad $50 za poslední 4 hodiny a proveďte sekvenci obnovy.

Programové spuštění

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

// Spusťte agenta
const result = await agent.run(
  "Recover abandoned carts over $50 from the last 4 hours"
);

console.log(result.summary);

Krok 5: Naplánujte agenta

Na základě cron

# Ve frontmatter vaší specifikace agenta
triggers:
  - schedule: "0 */4 * * *"  # Každé 4 hodiny
    timezone: "America/New_York"

Spouštěný událostí

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

Další kroky

Formát specifikace agenta, Úplná reference markdown agenta
Předem vytvořené agenty, Marketingoví agenti připravení k použití
Přehled dovedností, Všechny dostupné MCP nástroje
Brevo MCP server, Schémata nástrojů a oprávnění

Budování prvního agenta