Addestra Atlas sulla knowledge base

Cosa può ingerire Atlas

Aggiungi le fonti dalla configurazione della knowledge base nella dashboard. Ce ne sono tre:

• Pagina singola. Punta Atlas a un URL e scansionerà la pagina (e qualche livello configurabile più in profondità). Ideale per documentazione di aiuto, FAQ e pagine di prodotto che già mantieni sul tuo sito.
• Canale Discord. Importa la cronologia dei messaggi da un canale Discord: utile quando il tuo team di supporto ha già risposto alle stesse domande in pubblico e vuoi che Atlas impari da quelle risposte.
• Repository GitHub. Collega un repository e un percorso opzionale; Atlas indicizza ogni file Markdown (.md, .mdx) che vi trova. Ottimo per i team di engineering che tengono la documentazione nello stesso posto del codice.

Strutturare le voci

Fonti piccole e mirate funzionano meglio di un'unica pagina gigante. Un centro assistenza con un articolo separato per argomento (“Politica di rimborso”, “Cancellazioni”, “Disponibilità per regione”) rende ad Atlas molto più facile estrarre risposte pulite rispetto a un unico mega-documento “Tutto quello che devi sapere”. Atlas cita nella risposta la fonte che ha usato, quindi fonti granulari rendono anche le citazioni più utili.

Lasciare che lo staff insegni al volo

Quando lo staff corregge una bozza di Atlas prima di inviarla, la correzione viene acquisita come voce Q&A e aggiunta alla knowledge base. Da quel momento compete con le altre fonti alla successiva domanda simile, classificata per rilevanza e per voti della community, così le buone correzioni salgono da sole nel tempo. Nessun job di riaddestramento da eseguire; le nuove voci sono ricercabili immediatamente.

Cosa non inserire

• Segreti, password, chiavi API, dati dei clienti.
• Politiche superate. Atlas tratta ogni voce come attuale.
• Note su incidenti in corso. Per quelle usa invece le risposte predefinite.

Controlli di qualità

Apri di tanto in tanto la lista della knowledge base nella dashboard e scorrila in cerca di voci obsolete. Se una risposta è cambiata (prezzi, politiche, regioni supportate), modifica o rimuovi la voce così Atlas smette di citare la versione superata. Riscansiona le voci basate su URL dopo grandi modifiche alla documentazione, così l'indice riflette ciò che i tuoi clienti troveranno davvero sul tuo sito.

Gestisci la knowledge base con strumenti di IA

MCP è un collegamento sicuro che consente a Claude Code o Codex di lavorare con la knowledge base di TicketCord dopo l'accesso e la tua autorizzazione. Puoi fare richieste con parole semplici invece di passare tra tutte le schermate della dashboard.

Prima di collegarti

• Devi essere il proprietario dell'account TicketCord. Lo staff con accesso alla dashboard non può creare un collegamento MCP.
• Il tuo piano attivo deve includere l'accesso alla knowledge base.
• Installa Claude Code o la CLI di Codex e assicurati di poter accedere a TicketCord.
• Un collegamento può raggiungere tutti i server che possiedi ora o aggiungerai in futuro. Ogni richiesta indica comunque un bot e un server specifici. TicketCord ricontrolla proprietà e piano a ogni richiesta.

Collega Claude Code o Codex

1. Nella dashboard, seleziona un bot e un server. Apri Knowledge Base > Configurazione e trova Collega strumenti di IA.
2. Per Claude Code, esegui claude mcp add --transport http ticketcord https://ticketcord.com/api/mcp --scope user, poi claude mcp login ticketcord.
3. Per Codex, esegui codex mcp add ticketcord --url https://ticketcord.com/api/mcp, poi codex mcp login ticketcord.
4. TicketCord si apre nel browser. Accedi, leggi l'avviso sull'accesso all'intero account e i permessi richiesti di lettura, scrittura ed eliminazione. Scegli quindi Consenti accesso o Nega.
5. Quando compare Autenticazione completata, chiudi la scheda e torna allo strumento di IA. Prova: Elenca le mie knowledge base di TicketCord.

Cosa puoi chiedere

• Elencare le knowledge base e controllare impostazioni, fonti, stato dell'indicizzazione e voci.
• Cercare per significato e restituire brevi passaggi pertinenti con nome della fonte e livello di confidenza.
• Aggiungere, modificare, attivare, disattivare, reindicizzare o eliminare pagine web, canali Discord e fonti GitHub già collegate.
• Creare e modificare voci, esaminare quelle in attesa e approvarle, rifiutarle o eliminarle.
• Aggiornare le impostazioni modificabili dalla dashboard per dettagli del prodotto, trigger, visualizzazione, qualità, aggiornamenti, comportamento, feedback, apprendimento dai ticket e Auto Support.

Richieste utili da provare

• Elenca le mie knowledge base e mostra quali non hanno fonti pronte.
• Cerca la nostra politica di rimborso e riassumila indicando le fonti.
• Trova le voci che citano i vecchi prezzi. Mostrale prima e non modificare nulla.
• Aggiungi https://docs.example.com come fonte della documentazione e avvia l'indicizzazione.
• Mostra le voci in attesa e consiglia se approvarle o rifiutarle prima di apportare modifiche.
• Mostrami la risposta attuale per reimpostare la password, poi aiutami ad aggiornarla.

Permessi, sicurezza e accesso

• L'accesso in lettura consente di visualizzare e cercare le conoscenze. La scrittura consente di modificare impostazioni, fonti e voci. L'eliminazione può rimuovere definitivamente fonti e voci.
• Per le modifiche rischiose, chiedi allo strumento di IA di mostrare ciò che ha trovato e spiegare l'azione prevista prima di cambiare qualcosa.
• L'eliminazione è definitiva. TicketCord ricontrolla i tuoi permessi a ogni richiesta, anche dopo l'approvazione del collegamento.
• Se il piano scade o perde l'accesso alla knowledge base, il collegamento viene sospeso. Può tornare a funzionare dopo il passaggio a un piano idoneo, a meno che non sia stato revocato o sia scaduto l'accesso di rinnovo.
• Revoca subito un collegamento dalla scheda Collega strumenti di IA nella configurazione della knowledge base.
• Il collegamento o scollegamento di un account GitHub avviene ancora solo nella dashboard. Non inserire mai password, chiavi API, segreti o dati dei clienti nella knowledge base.