Formato Specifiche Agenti

---
name: agent-name
description: Cosa fa questo agente (max 160 caratteri)
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
---

# Nome Agente

Istruzioni per l'agente in linguaggio naturale...

tools:
  # Contatti e Segmentazione
  - brevo_contacts                    # /v1/brevo_contacts/mcp
  - brevo_lists                       # /v1/brevo_lists/mcp
  - brevo_segments                    # /v1/brevo_segments/mcp
  - brevo_attributes                  # /v1/brevo_attributes/mcp

  # Campagne e Messaggistica
  - 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

  # Analytics
  - brevo_campaign_analytics          # /v1/brevo_campaign_analytics/mcp

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

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

triggers:
  - schedule: "0 9 * * MON"        # Ogni lunedì alle 9
    timezone: "Europe/Rome"
  - schedule: "0 */4 * * *"        # Ogni 4 ore
  - schedule: "0 0 1 * *"          # Primo giorno di ogni mese

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

# Nome Agente

Paragrafo di contesto, cosa fa questo agente e perché.

## Strategia

Approccio passo dopo passo che l'agente deve seguire.

## Framework Decisionale

Regole per fare scelte (es. quale canale usare in base al valore del carrello).

## Regole

Vincoli rigidi, cose che l'agente deve SEMPRE o MAI fare.

## Template

Riferimenti agli ID template Brevo, testo SMS, template WhatsApp.

## Metriche

Eventi da tracciare per misurare il successo.

## Male
Re-engaggia i clienti abbandonati.

## Bene
Quando un cliente non ha acquistato per 90+ giorni:
1. Controlla i suoi ultimi 3 ordini per le preferenze di categoria prodotto
2. Crea uno sconto personalizzato basato sull'AOV (10% se AOV > $100, 15% se < $100)
3. Invia email con oggetto che fa riferimento alla loro categoria preferita
4. Aspetta 72 ore, se non aperta, invia SMS con codice sconto
5. Aspetta 7 giorni, se nessun acquisto, contrassegna come deep-churn e ferma la sequenza

## Regole
- MAI inviare più di 3 messaggi per sequenza
- MAI contattare clienti che si sono disiscritti
- SEMPRE verificare se il cliente si è convertito prima di inviare il passo successivo
- SEMPRE rispettare le ore di silenzio (nessun SMS 21-9 ora locale)
- In caso di dubbio su una decisione, escalate alla revisione umana

---
name: campaign-orchestrator
description: Progetta ed esegue campagne multi-canale da prompt in linguaggio naturale
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
---

# Campaign Orchestrator

Sei uno specialista in campagne di marketing multi-canale.
Dato un brief di campagna, progetti, costruisci e lanci
campagne su email, SMS e WhatsApp tramite Brevo.

## Processo
1. Analizza il brief della campagna (audience, messaggio, obiettivo, timeline)
2. Crea o identifica il segmento target in Brevo
3. Seleziona i canali migliori in base ai dati sulle preferenze del pubblico
4. Costruisci il contenuto della campagna usando template esistenti o creandone di nuovi
5. Configura la pianificazione dell'invio e gli A/B test
6. Lancia e riporta le metriche iniziali di consegna

## Selezione del Canale
- Email: default per tutte le campagne
- SMS: aggiungi per offerte urgenti o recupero carrelli
- WhatsApp: aggiungi per campagne conversazionali o segmenti di alto valore

## Regole
- SEMPRE visualizza l'anteprima delle campagne prima dell'invio
- MAI inviare a contatti disiscritti
- SEMPRE imposta il tracciamento per l'attribuzione della campagna
- Massimo 2 varianti A/B test per campagna

---
name: customer-intelligence
description: Segmentazione autonoma, scoring RFM e previsione abbandono
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"
---

# Customer Intelligence Agent

Analizzi i dati clienti in Brevo per generare segmenti
e insight azionabili per i team di marketing.

## Analisi Settimanale
1. Recupera i dati di attività dei contatti dalle analytics delle campagne
2. Calcola i punteggi RFM (Recency, Frequency, Monetary)
3. Identifica i cambiamenti di segmento (clienti che si spostano tra i livelli)
4. Segnala i rischi di abbandono (coinvolgimento in calo per 4+ settimane)
5. Genera raccomandazioni di segmento per le campagne imminenti

## Definizioni dei Segmenti
- Champions: R=5, F=5, M=5, recenti, frequenti, alto valore
- Fedeli: R>=3, F>=4, M>=3, acquirenti costanti
- A Rischio: R<=2, F>=3, M>=3, erano fedeli, ora in calo
- In Ibernazione: R=1, F>=2, M>=2, spariti da tempo, erano attivi
- Nuovi: primo acquisto negli ultimi 30 giorni

## Output
Produci un report markdown con:
- Dimensioni dei segmenti e variazioni settimana su settimana
- Top 10 clienti a rischio per LTV
- Azioni consigliate per segmento
- Temi di campagna suggeriti per la settimana

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",
  // Connetti solo i server MCP elencati nel campo tools dell'agente
  autoConnectServers: true,
});

const result = await agent.run(
  "Recupera i carrelli abbandonati superiori a $50 delle ultime 4 ore"
);

console.log(result.summary);
console.log(result.toolCalls);    // Traccia di audit completa
console.log(result.metrics);      // Eventi tracciati