Importare i prompt

Come importare

1. Apri la pagina Prompt del sito e premi Importa.
2. Trascina un file sulla finestra, o clicca sfoglia. Sono accettati i file che terminano in .csv, .tsv o .txt.
3. Controlla l’anteprima. Mostra le prime cinque righe e una riga come “12 nuovi · 3 già tracciati”. A questo punto nulla è ancora salvato.
4. Premi Importa.

Scarica il modello nella finestra ti dà un file con l’intestazione giusta e due righe di esempio.

Importare non chiede nulla a nessun assistente e non costa nulla. I nuovi prompt vengono posti la prossima volta che avvii una scansione.

Colonne

Un file ha fino a tre colonne. Solo il prompt è obbligatorio.

prompt,category,intent
"Which email marketing platform is best for a small online shop?",choosing a tool,commercial
"How do I improve the deliverability of my newsletters?",deliverability,informational
"What does email automation cost for 10,000 contacts?",pricing; choosing a tool,commercial

• Le celle possono essere separate da virgole, punti e virgola o tabulazioni. Teddit capisce quale dal file, quindi un CSV salvato da Excel in qualsiasi regione, o un export separato da tabulazioni, funziona così com’è.
• Metti una cella tra virgolette doppie quando contiene il separatore, il prompt prima di tutto. Senza le virgolette, il testo dopo di esso viene letto come colonna successiva. Una virgoletta doppia dentro una cella tra virgolette si scrive due volte: "".
• Un prompt per riga. Una cella tra virgolette può estendersi su più righe.
• Il file può essere UTF-8 o nelle codifiche più vecchie usate da Excel (come Windows-1251 per il cirillico), oppure il “Testo Unicode” di Excel.
• Le righe vuote vengono ignorate, e gli spazi intorno a una cella vengono rimossi.
• Vengono capite altre due parole di intento, perché gli strumenti per le parole chiave le usano: research viene salvato come commercial, e learn and solve come informational.

Con e senza riga di intestazione

La prima riga viene letta come intestazione quando una delle sue celle nomina la colonna del prompt: prompt, query, keyword, question e nomi simili, in inglese, ucraino o russo. Maiuscole e minuscole non contano.

• Con un’intestazione, le colonne vengono trovate per nome: la colonna del prompt, poi le colonne categoria e intento ovunque si trovino. L’ordine è libero, e qualsiasi altra colonna viene ignorata. Un export da uno strumento per le parole chiave di solito funziona così com’è.
• Senza un’intestazione, ogni riga è un prompt e le colonne vengono lette per posizione: prima il prompt, seconda la categoria, terzo l’intento, lo stesso ordine di un export.

Un file con una sola colonna e senza intestazione è semplicemente un elenco di prompt, uno per riga. Metti tra virgolette i prompt che contengono una virgola.

Più categorie per un prompt

Scrivi le categorie in una cella, separate da un punto e virgola o da una barra verticale:

prompt,category
"What does email automation cost for 10,000 contacts?",pricing; choosing a tool
"Which tools send both email and SMS campaigns?",channels | choosing a tool

• In un file separato da punti e virgola, metti una cella del genere tra virgolette doppie.
• Un prompt può avere fino a otto categorie. Quelle dopo l’ottava vengono scartate.
• Una categoria ripetuta nella cella viene tenuta una volta. “Prezzi” e “prezzi” sono la stessa categoria; viene tenuta la grafia scritta per prima.
• Una categoria che non esiste ancora viene creata dall’importazione.
• La prima categoria nella cella è quella per cui l’elenco ordina.

Duplicati e prompt che già tracci

Una riga corrisponde a un prompt esistente quando il testo è esattamente lo stesso, lettera per lettera.

L’anteprima conta questi casi prima che qualcosa venga salvato: nuovi, già tracciati e saltati.

Lo stato dei prompt importati

I prompt importati con la finestra Importa sono attivi. Fanno parte della prossima scansione.

I prompt importati tramite l’API REST o lo strumento MCP import_queries sono bozze a meno che la chiamata non chieda active. Una bozza non viene scansionata. Quando un sito ha bozze, l’elenco Prompt mostra una scheda Bozza; spunta lì i prompt e attiva Attivo per renderli attivi.

Ogni prompt importato ricorda il testo con cui è stato importato. Tramite l’API o l’MCP puoi far riscrivere in seguito brevi query di ricerca come domande complete (rewrite_queries). La riscrittura tocca solo i prompt importati il cui testo non è stato modificato da allora.

Esportazione

Premi CSV nella pagina Prompt. Scegli tutti i prompt o una categoria e scarica il file. Si chiama prompts-<domain>-<date>.csv e ha una riga per prompt.

Un file esportato può essere importato di nuovo così com’è, nello stesso sito o in un altro. Le colonne Prompt, Category e Intent vengono trovate per nome e le altre colonne vengono ignorate.

Le stesse righe sono disponibili come JSON dall’API (GET /api/projects/:id/prompts) e dallo strumento MCP list_prompts. L’API accetta anche i filtri dell’elenco sull’indirizzo di esportazione; vedi Endpoint.