Margaret — il tuo assistente AI

Margaret è l’assistente AI integrato in Switchbord. Aprila dall’icona nella barra laterale (o con la scorciatoia da tastiera mostrata nella barra superiore) e chiedile qualsiasi cosa, da “riassumi questa conversazione” a “crea un modello per la mia campagna di winback”.

​

Cosa può fare Margaret oggi

​

Contesto basato sulla pagina

Margaret sa in quale pagina ti trovi e cosa hai selezionato. In una conversazione della posta in arrivo, vede il profilo del contatto, gli ultimi sei messaggi e l’assegnatario — senza bisogno di incollare il contesto. Nell’editor dei modelli, vede il corpo della bozza corrente. Nell’editor delle journey, vede la forma del grafo e il nodo selezionato. Pagine che pubblicano contesto:

• Posta in arrivo — conversazione selezionata, contatto, ultimi messaggi, assegnatario
• Modelli — bozza corrente, categoria, lingua
• Journeys — stato del grafo, nodo selezionato, trigger/azioni
• Campagne — bozza in composizione, nome del modello, dimensione del pubblico
• Contatti — contatto selezionato, filtri, dimensione dell’elenco
• Impostazioni — scheda corrente

Anche le risposte degli strumenti ricevono questo contesto, così le risposte di Margaret restano ancorate alla tua area di lavoro e all’elemento visualizzato.

​

Comandi slash

Digita / come primo carattere nel composer di Margaret per aprire un menu rapido delle azioni operative più comuni. Il popover è controllabile da tastiera: usa ↑ / ↓ per spostarti tra i comandi, Enter o Tab per selezionarne uno, ed Esc per chiuderlo. I comandi slash sono una scorciatoia, non una restrizione — puoi sempre digitare il prompt completo tu stesso. Non appena digiti uno spazio dopo /, il popover si chiude e il composer tratta il tuo input come un messaggio normale.

​

Memoria dell’area di lavoro

Margaret dispone di una memoria persistente a livello di area di lavoro. Dille un fatto una volta e potrà richiamarlo in qualsiasi thread futuro. Le voci di memoria vivono nella stessa tabella workspace_knowledge_entries delle tue note FAQ/policy (da Impostazioni → AI). Le voci scritte da Margaret sono etichettate memory così puoi distinguerle a colpo d’occhio. Cose utili da memorizzare:

• Fatti stabili che avranno rilevanza nei thread futuri (soglie di prezzo, nomi di filiali, numeri di policy).
• Formulazioni preferite o linee guida di tono (“chiama sempre la filiale di Firenze FI”).
• Convenzioni a livello di contatto o segmento non presenti nel tuo CRM.

Non usare la memoria per stati temporanei di attività (ad es. “l’utente mi ha chiesto di inviare una campagna domani”). Per questo servono i thread.

​

Selezione del modello

Clicca sul menu a tendina del modello nell’intestazione di Margaret per passare tra i modelli supportati. Ogni provider ha i suoi punti di forza:

• Claude Sonnet / Opus — ideale per scrittura creativa e ragionamento lungo
• GPT-5 / serie o — ideale per pianificazione complessa
• Gemini 2.5 — contesto ampio, veloce
• DeepSeek R1 — open, ragionamento solido
• Claude Haiku / GPT-4o — il più rapido, senza ragionamento estesso

La tua selezione persiste tra le sessioni (localStorage).

​

Controlli di ragionamento (Thinking)

Vicino al menu a tendina del modello, il selettore Thinking ti permette di decidere quanto Margaret debba ragionare prima di rispondere:

• Auto — lascia che si applichi il comportamento predefinito del modello. (Consigliato per la chat quotidiana.)
• Off — disabilita il ragionamento. Il più rapido, il meno costoso.
• Fast — impegno basso. Utile per ricerche rapide.
• Balanced — impegno medio. Predefinito per la maggior parte dei modelli capaci di ragionamento.
• Deep — impegno elevato. Da usare per analisi complesse, piani multi-step, scritture difficili.

Il menu a tendina è disabilitato (con tooltip) quando il modello selezionato non supporta il ragionamento estesso. Il ragionamento estesо consuma più token e richiede più tempo — i token di ragionamento sono fatturati come token di output. L’impostazione “Deep” può moltiplicare il costo di una risposta normale di circa 2-5×. Usala con criterio.

​

Bozze e approvazioni

Quando chiedi a Margaret di creare, aggiornare o inviare qualcosa, non esegue mai l’operazione in silenzio. Il flusso è:

1. Margaret spiega in una frase cosa sta per fare.
2. Propone una bozza — il corpo di un modello, un grafo di journey, una risposta a un messaggio.
3. Tu revisioni la bozza direttamente in chat.
4. Clicchi Approva per confermare o Rifiuta per scartare.

Questo vale per modelli, journeys, campagne, note sui contatti, messaggi in uscita e qualsiasi altra cosa che modifica dati.

​

Prompt utili da provare

• “Chi è questo contatto e di cosa abbiamo parlato?” (in una conversazione della posta in arrivo)
• “Scrivi una bozza di risposta in italiano chiedendo la data di partenza preferita.”
• “Crea un modello utility chiamato document_reminder che chiede un documento mancante con il nome del cliente e il tipo di documento come variabili.”
• “Progetta una journey di lead-capture che si attiva sulla parola chiave ‘preventivo’ e raccoglie nome, telefono, email.”
• “Qual è la nostra politica di cancellazione?” (recupera dalla knowledge base dell’area di lavoro)
• “Trova i contatti con tag vip che non hanno avuto un inbound negli ultimi 60 giorni.”

​

Ricerca nella Knowledge Base

Margaret può cercare in una knowledge base per area di lavoro composta da voci FAQ con titoli, corpi e tag. Queste voci sono gestite in Impostazioni → AI → Knowledge Base. Quando un utente pone una domanda che non riguarda i dati specifici del proprio account (ad es. “Qual è la vostra politica di cancellazione?”), Margaret usa la ricerca semantica per trovare le voci più rilevanti e le usa per fondare la sua risposta.

​

Strumenti CRM

Margaret ha accesso diretto ai dati dei tuoi clienti. Può:

• Trovare contatti per nome, numero di telefono o email.
• Ottenere i dettagli di un contatto, incluse conversazioni recenti, campi personalizzati e tag.
• Aggiornare le informazioni di un contatto, come nomi o valori di campi personalizzati (richiede approvazione).
• Applicare/rimuovere tag ai contatti per la segmentazione (richiede approvazione).

​

Sincronizzazione KB con ElevenLabs

Se usi ElevenLabs per gli agenti vocali, Margaret può aiutarti a mantenere la loro knowledge sincronizzata con Switchbord. Puoi chiederle di “Sincronizzare la nostra KB con ElevenLabs” per avviare una sincronizzazione (vedi la guida KB di ElevenLabs per i dettagli).

​

Contesto dell’area di lavoro — knowledge base

Margaret può cercare in una knowledge base per area di lavoro: voci FAQ con titolo, corpo e tag. Popolata durante la configurazione iniziale; gli operatori aggiungono voci in Impostazioni → AI. L’assistente usa queste voci per ancorare le risposte alle politiche effettive della tua organizzazione. Le voci di memoria dell’area di lavoro di Margaret condividono la stessa tabella, etichettate memory.

​

Limitazioni

• La memoria cross-thread di Margaret è opt-in tramite writeWorkspaceMemory — non ricorda ancora automaticamente tutto ciò che hai discusso in un thread precedente. La condensazione automatica completa è nella roadmap.
• Il caricamento di file e il multimodale (immagini) non sono ancora supportati.
• La modalità vocale non è disponibile.
• La suite di valutazioni è in fase di sviluppo — sono possibili occasionali allucinazioni; rivedi sempre le bozze prima dell’approvazione.

​

Osservabilità

Ogni turno di Margaret viene registrato in llm_usage (provider, modello, token, latenza). Una dashboard dedicata /settings/ai-observability è pianificata come follow-up (BORD-328b). Le approvazioni e le mutazioni già producono righe nel log di audit collegate al tuo id utente.

​

Roadmap

Vedi l’epic Linear BORD-323 (Margaret v2). Consegnato fino ad ora:

• BORD-324 — correzioni di base (selettore modello, accessibilità, gestione errori) ✅
• BORD-325 — controlli di ragionamento via OpenRouter ✅
• BORD-326 — contesto di pagina / grounding ✅
• BORD-327 — artefatti in bozza + approvazioni HITL native ✅
• BORD-328 — comandi slash, memoria dell’area di lavoro, eval harness ✅

In corso o pianificato:

• BORD-328b — dashboard /settings/ai-observability (posticipata dal 328)
• BORD-322 — integrazione della knowledge base ElevenLabs (caricamenti)