MCP & Architettura Agentica
MCP & Architettura Agentica
Tajo è un livello di orchestrazione agentico per Brevo. Invece di costruire manualmente campagne, segmenti e automazioni, descrivi quello che vuoi in linguaggio naturale e gli agenti IA eseguono sull’intero stack di coinvolgimento Brevo.
Tip
Il Model Context Protocol (MCP) è uno standard aperto che consente ai modelli IA di interagire con strumenti e API esterne. Tajo espone l’intera API Brevo come strumenti MCP, in modo che qualsiasi LLM possa orchestrare autonomamente il coinvolgimento dei clienti.
Architettura
Lo stack agentico di Tajo ha tre livelli:
+--------------------------------------------------+| Interfaccia Linguaggio Naturale || "Recupera i clienti che non hanno ordinato in || 90 giorni con una sequenza email+SMS in 3 step"|+--------------------------------------------------+ | v+--------------------------------------------------+| Agenti IA (Orchestrazione) || Campaign Orchestrator | Customer Intelligence || Win-Back Agent | Cart Recovery Agent || ─── Gli agenti compongono Skill in base agli obiettivi ─── |+--------------------------------------------------+ | v+--------------------------------------------------+| Skill (Strumenti MCP) || brevo/send-email | brevo/create-contact || brevo/track-event | brevo/send-whatsapp || ─── Atomiche, deterministiche, supportate da API ─── |+--------------------------------------------------+ | v+--------------------------------------------------+| API Brevo (Coinvolgimento) || Email | SMS | WhatsApp | CRM | Automazione |+--------------------------------------------------+Livello 1: Skill (Strumenti MCP)
Le Skill sono unità di automazione atomiche che wrappano gli endpoint dell’API Brevo. Ogni skill ha trigger, azioni e permessi definiti. Quando esposte tramite MCP, le skill diventano strumenti che qualsiasi modello IA può invocare.
name: send-campaign-emailversion: 1.0.0mcp_tool: brevo/send-emaildescription: Invia un'email transazionale o di campagna tramite Brevo
triggers: - event: agent_request - event: cart_abandoned
actions: - brevo/send-email
brevoEndpoints: - POST /v3/smtp/email
permissions: - email:sendVisualizza tutte le Skill | Specifiche Formato Skill
Livello 2: Agenti (Orchestrazione)
Gli Agenti sono orchestratori basati su LLM che compongono più skill per raggiungere un obiettivo di marketing. Ogni agente è definito in un file markdown con frontmatter che specifica le sue capacità, strumenti e vincoli.
---name: win-back-agentdescription: Re-engaggia i clienti persi con sequenze multi-canale personalizzatetemperature: 0.3max_tokens: 4096tools: - brevo/list-contacts - brevo/create-segment - brevo/send-email - brevo/send-sms - brevo/track-event---
Sei uno specialista nel recupero clienti. Dato una soglia di abbandonoe un segmento di clienti, progetta ed esegui una sequenza di re-engagement.
## Le Tue Capacità1. Interroga i dati clienti e identifica i segmenti abbandonati2. Crea segmenti mirati basati sulla cronologia acquisti3. Progetta sequenze multi-step email + SMS4. Traccia il coinvolgimento e adatta la strategia5. Riporta i tassi di recupero e l'impatto sui ricaviFormato Specifiche Agenti | Creare il Primo Agente
Livello 3: Interfaccia Linguaggio Naturale
Il livello superiore traduce l’intento del marketer in azioni degli agenti. Un marketer dice:
“Crea una campagna di win-back per i clienti che non hanno acquistato in 90 giorni. Inizia con un’email che offre il 15% di sconto, seguita da un SMS dopo 3 giorni se non aperta, poi un messaggio WhatsApp finale con una raccomandazione di prodotto personalizzata.”
Il livello di orchestrazione:
- Seleziona il Win-Back Agent
- L’agente interroga i contatti Brevo tramite la skill
brevo/list-contacts - Crea un segmento tramite la skill
brevo/create-segment - Progetta la sequenza in 3 step usando le skill
brevo/send-email,brevo/send-sms,brevo/send-whatsapp - Imposta il tracciamento degli eventi tramite la skill
brevo/track-event - Monitora e riporta i risultati
Perché MCP?
Il Model Context Protocol offre a Tajo tre vantaggi fondamentali:
| Vantaggio | Descrizione |
|---|---|
| Indipendente dal modello | Funziona con Claude, GPT, Gemini, LLM open-source, qualsiasi modello che supporta MCP |
| Componibile | Le skill si uniscono come mattoncini. Gli agenti decidono quali usare a runtime |
| Osservabile | Ogni chiamata allo strumento viene registrata con input, output e decisioni. Traccia di audit completa |
| Sicuro | Strumenti con scope di permessi. Gli agenti accedono solo a ciò a cui sono autorizzati |
Per Iniziare
-
Configura il Server MCP Brevo
Connetti il tuo account Brevo ed esponi gli strumenti API tramite MCP.
-
Crea il tuo primo agente
Crea un agente di marketing che orchestra le skill Brevo.
-
Distribuisci e monitora
Esegui gli agenti secondo una pianificazione o attivali dagli eventi.
Agenti Preconfigurati
Tajo include agenti di marketing pronti all’uso:
| Agente | Scopo | Skill Utilizzate |
|---|---|---|
| Campaign Orchestrator | Progetta ed esegue campagne multi-canale dal linguaggio naturale | send-email, send-sms, send-whatsapp, create-segment |
| Customer Intelligence | Segmentazione autonoma, scoring RFM, previsione abbandono | list-contacts, create-segment, track-event |
| Win-Back Agent | Re-engaggia i clienti persi con sequenze personalizzate | list-contacts, create-segment, send-email, send-sms |
| Cart Recovery Agent | Recupera i carrelli abbandonati con nudge multi-canale tempestivi | track-event, send-email, send-sms |
| Data Sync Agent | Sincronizzazione bidirezionale tra qualsiasi piattaforma e Brevo | create-contact, update-contact, track-event |
| WhatsApp Commerce Agent | Commercio conversazionale tramite WhatsApp Business | send-whatsapp, track-event, list-contacts |
Passi Successivi
- Configurazione Server MCP Brevo, Connetti Brevo come strumenti MCP
- Formato Specifiche Agenti, Definisci agenti personalizzati
- Creare il Primo Agente, Tutorial passo dopo passo
- Riferimento Skill, Sfoglia tutti gli strumenti MCP disponibili