> ## Documentation Index > Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt > Use this file to discover all available pages before exploring further. # Margaret — il tuo assistente AI > Margaret ti aiuta a gestire conversazioni WhatsApp, contatti, modelli, journeys e campagne all'interno di Switchbord. Si basa su ciò che stai visualizzando, risponde alle domande e crea bozze che tu confermi. 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 Spiega qualsiasi funzionalità di Switchbord, cosa fa un'impostazione o come realizzare un workflow. Trova un contatto per nome, telefono o email. Mostra le sue conversazioni recenti, il valore a vita e le note. Quando sei in una conversazione della posta in arrivo, chiedi "rispondi chiedendo le date preferite" — Margaret scrive una bozza contestuale. "Crea un modello per gli auguri di compleanno con il nome del cliente" — Margaret propone una bozza che puoi revisionare. Descrivi un flusso in linguaggio naturale e Margaret ne disegna il grafo. Interroga le voci FAQ e le note interne dell'area di lavoro. ## 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. Quando chiedi "rispondi a questo cliente" in una conversazione della posta in arrivo, Margaret seleziona automaticamente la conversazione giusta. Non è necessario incollare un ID. 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. | Comando | Cosa fa | | ---------------- | ----------------------------------------------------------------------------------------------------------- | | `/new-template` | Precompila il composer con *"Crea un nuovo modello chiamato …"* così puoi nominare il modello direttamente. | | `/find-contact` | Precompila *"Trova contatto …"* — digita il nome, il telefono o l'email. | | `/draft-journey` | Precompila *"Crea una journey per …"* per abbozzare un'automazione multi-step a partire da una descrizione. | | `/help` | Chiede a Margaret con cosa può aiutarti — utile per i nuovi membri del team. | | `/clear` | Avvia un nuovo thread di chat (equivale al pulsante "nuova chat"). | 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. *"Margaret, ricorda che la nostra soglia VIP è 5.000 EUR di spesa lifetime."* Margaret propone una card di approvazione con un titolo e un corpo. Clicca **Approva** per salvare. *"Ti ricordi qual è la nostra soglia VIP?"* Margaret cerca nella knowledge base dell'area di lavoro e cita la nota salvata nella sua risposta. 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. Scrivere nella memoria dell'area di lavoro è un'operazione **riservata agli admin** e sempre soggetta ad approvazione. Margaret descrive cosa sta per salvare prima che appaia la card di approvazione, così puoi verificarne il testo. 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. Quando Margaret ragiona, vedrai nella trascrizione un blocco "Thinking…" comprimibile che si aggiorna in tempo reale. Si comprime automaticamente non appena inizia la risposta finale. Cliccalo per espanderlo e rivedere il suo ragionamento. 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. Margaret non invierà mai un messaggio WhatsApp né confermerà una modifica al database senza la tua approvazione esplicita. Se una chiamata a uno strumento potesse avere una conseguenza inattesa, chiederà prima un chiarimento. ## 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](/it/features/elevenlabs-kb) 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](#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)