Ügynök specifikáció formátum

A Tajo ügynökök markdown fájlokban vannak definiálva. Minden fájl tartalmaz YAML frontmattert (azonosság, eszközök, korlátok) és markdown törzset (utasítások, stratégia, szabályok). Ez a formátum a multi-ügynök orchestrációs rendszerekben használt éles ügynök mintákon alapul.

Fájlszerkezet

---
name: agent-name
description: Mit csinál ez az ügynök (max 160 karakter)
version: 1.0.0
temperature: 0.2
max_tokens: 4096
tools:
  - brevo_contacts
  - brevo_email_campaign_management
  - brevo_sms_campaigns
triggers:
  - event: cart_abandoned
  - schedule: "0 */4 * * *"
permissions:
  - contacts:read
  - email:send
  - sms:send
---

# Ügynök neve

Természetes nyelvű utasítások az ügynöknek...

Frontmatter mezők

Kötelező mezők

Mező	Típus	Leírás
`name`	string	Egyedi azonosító kebab-case formátumban (pl. `cart-recovery-agent`)
`description`	string	Mit csinál ez az ügynök (max 160 karakter)
`version`	string	Szemantikus verzió (pl. `1.0.0`)
`tools`	tömb	Brevo MCP szerver modulok, amelyekhez az ügynök hozzáférhet

Viselkedési mezők

Mező	Típus	Alapértelmezett	Leírás
`temperature`	float	`0.3`	LLM hőmérséklet. Alacsonyabb = determinisztikusabb. 0.1-0.2 adatműveletekhez, 0.3-0.5 kampánytervezéshez
`max_tokens`	egész	`4096`	Maximális válaszhossz menetetenként
`model`	string	`claude-sonnet-4-6`	Használandó LLM modell

Kiváltó mezők

Mező	Típus	Alapértelmezett	Leírás
`triggers`	tömb	`[]`	Esemény, ütemezés vagy webhook, amely aktiválja az ügynököt
`triggers[].event`	string	-	Esemény neve (pl. `cart_abandoned`, `customer_created`)
`triggers[].schedule`	string	-	Cron kifejezés (pl. `0 9 * * *` napi 9-kor)
`triggers[].webhook`	string	-	Webhook elérési út (pl. `/agents/cart-recovery/trigger`)
`triggers[].conditions`	tömb	`[]`	A kiváltóhoz szűrési feltételek
`triggers[].debounce`	string	-	Debounce ablak (pl. `5m`, `1h`)

Engedély mezők

Mező	Típus	Alapértelmezett	Leírás
`permissions`	tömb	`[]`	Szükséges engedélyhatókörök az audit naplóhoz
`related_agents`	tömb	`[]`	Ügynökazonosítók, amelyekre ez az ügynök delegálhat
`escalation`	string	-	Hová irányítsa, ha az ügynök bizonytalan (`human`, `supervisor-agent`)

Eszközök: Leképezés Brevo MCP szerverekre

A tools mező a Brevo MCP szerver modul nevekre hivatkozik. Minden modul egy konkrét végpontra képez le a mcp.brevo.com-on:

tools:
  # Kapcsolatok és szegmentálás
  - brevo_contacts                    # /v1/brevo_contacts/mcp
  - brevo_lists                       # /v1/brevo_lists/mcp
  - brevo_segments                    # /v1/brevo_segments/mcp
  - brevo_attributes                  # /v1/brevo_attributes/mcp

  # Kampányok és üzenetküldés
  - brevo_email_campaign_management   # /v1/brevo_email_campaign_management/mcp
  - brevo_templates                   # /v1/brevo_templates/mcp
  - brevo_sms_campaigns               # /v1/brevo_sms_campaigns/mcp
  - brevo_whatsapp_campaigns          # /v1/brevo_whatsapp_campaigns/mcp

  # Analitika
  - brevo_campaign_analytics          # /v1/brevo_campaign_analytics/mcp

  # Értékesítési CRM
  - brevo_deals                       # /v1/brevo_deals/mcp
  - brevo_companies                   # /v1/brevo_companies/mcp
  - brevo_tasks                       # /v1/brevo_tasks/mcp
  - brevo_pipelines                   # /v1/brevo_pipelines/mcp
  - brevo_notes                       # /v1/brevo_notes/mcp

Tip

Használja az ügynöknek szükséges minimális eszközkészletet. Kevesebb eszköz = jobb AI gondolkodás és gyorsabb válaszok. Lásd a Brevo MCP szerver oldalt az összes elérhető modulért.

Kiváltók

Eseménykiváltók

Aktiválja az ügynököt, amikor valami történik a rendszerben:

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

Ütemezési kiváltók

Futtassa az ügynököt ismétlődő ütemezéssel:

triggers:
  - schedule: "0 9 * * MON"        # Minden hétfőn 9:00-kor
    timezone: "America/New_York"
  - schedule: "0 */4 * * *"        # Minden 4 órában
  - schedule: "0 0 1 * *"          # Minden hónap első napján

Webhook kiváltók

Hívja meg az ügynököt HTTP-n keresztül:

triggers:
  - webhook: /agents/win-back/trigger
    method: POST
    authentication: api_key

Markdown törzs: Utasítások

Az ügynök specifikáció törzse természetes nyelvű utasítások. Írja úgy, mintha egy képzett marketingest tájékoztatna:

Szerkezet

# Ügynök neve

Kontextus bekezdés – mit csinál ez az ügynök és miért.

## Stratégia

Lépésről lépésre megközelítés, amelyet az ügynöknek követnie kell.

## Döntési keretrendszer

Szabályok döntéshozatalhoz (pl. melyik csatornát használja a kosárérték alapján).

## Szabályok

Kemény korlátok – dolgok, amelyeket az ügynöknek MINDIG vagy SOHA nem szabad tennie.

## Sablonok

Hivatkozások Brevo sablonazonosítókra, SMS szövegekre, WhatsApp sablonokra.

## Mérőszámok

Követendő események a siker méréséhez.

Hatékony utasítások írása

Legyen specifikus a stratégiával kapcsolatban, ne csak a célokkal:

## Rossz
Aktiválja újra a lemorzsolódott ügyfeleket.

## Jó
Amikor egy ügyfél 90+ napja nem vásárolt:
1. Ellenőrizze az utolsó 3 rendelésüket termék kategória preferenciák szempontjából
2. Hozzon létre személyre szabott kedvezményt az átlagos rendelési érték alapján (10% ha AOV >100 $, 15% ha <100 $)
3. Küldjön emailt az előnyben részesített kategóriájukra hivatkozó tárgyssorral
4. Várjon 72 órát – ha nincs megnyitás, küldjön SMS-t kedvezménykóddal
5. Várjon 7 napot – ha nincs vásárlás, jelölje mélyen lemorzsolódottként és állítsa le a szekvenciát

Definiáljon biztosítékokat explicit módon:

## Szabályok
- SOHA ne küldjön 3-nál több üzenetet szekvenciánként
- SOHA ne vegye fel a kapcsolatot azokkal, akik leiratkoztak
- MINDIG ellenőrizze, hogy az ügyfél konvertált-e a következő lépés elküldése előtt
- MINDIG tartsa tiszteletben a csendes órákat (nincs SMS 21:00-9:00 között helyi idő szerint)
- Ha bizonytalan egy döntésben, eszkalálja emberi felülvizsgálatra

Multi-ügynök láncok

Összetett munkafolyamatokhoz láncoljon össze több ügynököt. Minden ügynök egy fázist kezel, a kontextust átadva a következőnek:

name: quarterly-retention-campaign
steps:
  - agent: customer-intelligence
    input: |
      Elemezze az ügyfélszegmenseket a Q2 megtartási kampányhoz.
      Cél: {task}

      Azonosítsa:
      1. Veszélyeztetett ügyfelek (csökkenő vásárlási frekvencia)
      2. VIP ügyfelek (top 10% LTV szerint)
      3. Visszaszerzési jelöltek (90+ nap az utolsó rendelés óta)

  - agent: campaign-designer
    input: |
      Tervezzen megtartási kampányokat ezekhez a szegmensekhez:
      {previous}

      Hozzon létre differenciált megközelítéseket szegmensenként:
      - Veszélyeztetett: enyhe ösztönzés termékajánlásokkal
      - VIP: kizárólagos korai hozzáférés vagy hűségjutalom
      - Visszaszerzési: agresszív kedvezmény sürgősséggel

  - agent: campaign-executor
    input: |
      Hajtsa végre ezeket a kampányokat a Brevo-n keresztül:
      {previous}

      Használja a szegmens preferenciáknak megfelelő csatornákat.
      Állítson be A/B teszteket tárgyssorokhoz.
      Ütemezze az optimális időpontokra.

  - agent: campaign-reporter
    input: |
      Generáljon megtartási kampány indítási riportot:
      {previous}

      Foglalja bele: megcélzott szegmensek, létrehozott kampányok,
      várható elérés, A/B teszt konfigurációk.

Lánc változók

Változó	Leírás
`{task}`	Az eredeti cél/kérés
`{previous}`	Az előző lépés kimenete
`{step_N}`	Az N. lépés kimenete (0-indexált)
`{artifacts_dir}`	Könyvtár fájl kimenetekhez

Előre felépített ügynök specifikációk

Kampány orchestrátor

---
name: campaign-orchestrator
description: Design and execute multi-channel campaigns from natural language prompts
version: 2.0.0
temperature: 0.3
tools:
  - brevo_contacts
  - brevo_segments
  - brevo_email_campaign_management
  - brevo_templates
  - brevo_sms_campaigns
  - brevo_whatsapp_campaigns
  - brevo_campaign_analytics
triggers:
  - webhook: /agents/campaign/trigger
    method: POST
---

# Kampány orchestrátor

Ön többcsatornás marketing kampányspecialista.
Egy kampányterv alapján tervezze, hozza létre és indítsa el
a kampányokat email, SMS és WhatsApp csatornákon a Brevo-n keresztül.

## Folyamat
1. Elemezze a kampánytervet (célközönség, üzenet, cél, időterv)
2. Hozza létre vagy azonosítsa a célszegmenst a Brevo-ban
3. Válassza a legjobb csatornát/csatornákat a célközönség preferencia adatai alapján
4. Hozzon létre kampány tartalmat meglévő sablonokból vagy újak létrehozásával
5. Konfigurálja a küldési ütemezést és az A/B teszteket
6. Indítsa el és riportálja a kezdeti kézbesítési mérőszámokat

## Csatorna kiválasztás
- Email: alapértelmezett minden kampányhoz
- SMS: adja hozzá időérzékeny ajánlatokhoz vagy kosárvisszaszerzéshez
- WhatsApp: adja hozzá társalgásalapú kampányokhoz vagy magas értékű szegmensekhez

## Szabályok
- MINDIG nézze meg előre a kampányokat küldés előtt
- SOHA ne küldjön leiratkozott kapcsolatoknak
- MINDIG állítson be kampány hozzárendelés követést
- Maximum 2 A/B teszt variáns kampányonként

Ügyfél intelligencia ügynök

---
name: customer-intelligence
description: Autonomous segmentation, RFM scoring, and churn prediction
version: 1.5.0
temperature: 0.2
tools:
  - brevo_contacts
  - brevo_segments
  - brevo_attributes
  - brevo_lists
  - brevo_campaign_analytics
triggers:
  - schedule: "0 6 * * MON"
    timezone: "UTC"
---

# Ügyfél intelligencia ügynök

Elemezze a Brevo ügyféladatokat, hogy cselekvőképes szegmenseket
és betekintéseket generáljon a marketing csapatok számára.

## Heti elemzés
1. Kapcsolati aktivitás adatok lekérése kampányanalitikából
2. RFM pontszámok kiszámítása (Recency, Frequency, Monetary)
3. Szegmens eltolódások azonosítása (ügyfelek szintek közötti mozgása)
4. Lemorzsolódási kockázatok jelzése (csökkenő interakció 4+ héten át)
5. Szegmens ajánlások generálása a közelgő kampányokhoz

## Szegmens definíciók
- Bajnokok: R=5, F=5, M=5, legutóbbi, gyakori, magas értékű
- Hűségesek: R>=3, F>=4, M>=3, következetes vásárlók
- Veszélyeztetett: R<=2, F>=3, M>=3, hűségesek voltak, most halványulnak
- Hibernáltak: R=1, F>=2, M>=2, régen aktívak
- Újak: első vásárlás az elmúlt 30 napban

## Kimenet
Készítsen markdown riportot:
- Szegmens méretek és heti változások
- Top 10 veszélyeztetett ügyfél LTV szerint
- Javasolt műveletek szegmensenként
- Javasolt kampánytémák a hétre

Telepítés

Ügynök programmatikus futtatása

import { TajoAgent } from "@tajo/agent-sdk";

const agent = new TajoAgent({
  specPath: "./agents/cart-recovery-agent.md",
  brevoToken: process.env.BREVO_MCP_TOKEN,
  model: "claude-sonnet-4-6",
  // Csak az ügynök tools mezőjében felsorolt MCP szerverek csatlakoztatása
  autoConnectServers: true,
});

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

console.log(result.summary);
console.log(result.toolCalls);    // Teljes audit napló
console.log(result.metrics);      // Követett események

Futtatás Claude Code-dal

# Mutassa az ügynök specifikációját és hagyja a Claude-ot végrehajtani
claude "Futtassa a ./agents/cart-recovery-agent.md-ben definiált ügynököt a mai elhagyott kosarakhoz"

Cron-alapú ütemezés

# Futtassa az ügyfél intelligencia ügynököt minden hétfőn 6:00-kor
0 6 * * MON claude --print "Futtassa a ./agents/customer-intelligence.md heti elemzését" >> /var/log/tajo-agents.log 2>&1

Következő lépések

Brevo MCP szerver, Elérhető eszközök és szerver konfiguráció
Első ügynök fejlesztése, Gyakorlati oktatóanyag
Skill referencia, Ügynökökkel kombinálható Tajo Skillek
MCP architektúra áttekintés, Hogyan illeszkedik minden össze

Ügynök specifikáció formátum