2Slides Team
23 min read
Prompt di Sistema per Agenti AI di Presentazione: Guida per Sviluppatori (2026)
I prompt di sistema per agenti AI di presentazione sono diversi dai prompt utente — codificano il ruolo, i vincoli e il contratto di output dell'agente piuttosto che il task specifico. Un prompt di sistema ben costruito trasforma un LLM generico in un agente affidabile di generazione slide: voce consistente, struttura prevedibile e uso di tool richiamabili. Questa guida per sviluppatori copre il template di prompt di sistema a 7 sezioni utilizzato in produzione dalla pipeline di agenti di 2Slides, un prompt di sistema pronto da incollare per costruire un agente slide con Claude, GPT-4o o DeepSeek, i tre anti-pattern che producono output inaffidabili e come integrare un prompt di sistema con l'API V1 di 2Slides (generate, create-pdf-slides, create-like-this, generate-narration, jobs/:id, themes/search). La guida si conclude con tre esempi pratici: un agente pitch-deck che converte note di founder in deck per investitori, un agente board-deck che formatta metriche trimestrali per audience executive e un agente di ingestion che converte PDF in presentazioni.
Se stai costruendo un chatbot, un assistente di coding che genera output slide, o un tool interno che automatizza il reporting, la differenza tra una demo e la produzione sta quasi interamente nel prompt di sistema. Questa guida è scritta per il pubblico di sviluppatori: niente marketing, codice reale, endpoint reali.
Prompt di Sistema vs Prompt Utente: Qual è la Vera Differenza?
Un prompt utente è il compito. Un prompt di sistema è il manuale operativo.
Quando un product manager digita "creami 10 slide sul fatturato del Q3," questo è un prompt utente. Quando il tuo agente restituisce costantemente JSON valido, non supera mai il budget di slide, cita sempre le fonti nelle note del relatore e chiama l'endpoint
create-pdf-slidesNelle API di OpenAI, Anthropic e Google, il prompt di sistema è un campo separato (
systemsystemsystemInstruction- Definizione del ruolo — che tipo di agente è
- Contratti di output — schema JSON, formato markdown o forma delle chiamate agli strumenti
- Vincoli rigidi — limiti di parole, regole di tono, contenuti vietati
- Inventario strumenti/API — quali funzioni sono chiamabili e quando
- Regole di escalation — quando rifiutare, chiedere chiarimenti o passare la mano
I prompt utente che cercano di codificare tutto questo si rompono nel momento in cui il testo del compito dell'utente diventa lungo. I prompt di sistema sopravvivono a ogni turno.
Il Template di System Prompt a 7 Sezioni
Ogni agente affidabile di generazione slide che abbiamo distribuito o verificato in 2Slides utilizza una variante di questa struttura a sette sezioni. L'ordine è importante — i LLM attribuiscono maggior peso alle istruzioni iniziali, quindi il ruolo e il contratto vengono per primi, gli esempi pratici per ultimi.
- Identità e Ruolo — descrizione in un paragrafo di chi è l'agente e cosa fa
- Contratto di Output — schema o formato esatto che l'agente deve restituire
- Vincoli Rigidi — regole non negoziabili (lunghezza, tono, pattern vietati)
- Inventario Strumenti — ogni API o funzione disponibile, con indicazioni su quando chiamarla
- Policy di Ragionamento — come l'agente dovrebbe pensare (chain-of-thought, auto-verifica, escalation)
- Gestione Errori — cosa fare quando l'input è ambiguo, malformato o fuori tema
- Esempi Pratici — da due a quattro coppie complete input/output che dimostrano il comportamento corretto
Il template è deliberatamente prescrittivo. Quando verifichiamo agenti che si comportano male in produzione, la causa è quasi sempre una sezione mancante piuttosto che una cattiva. Gli agenti senza un inventario strumenti allucinano endpoint. Gli agenti senza una sezione di gestione errori inventano dati quando gli input sono scarni. Gli agenti senza esempi pratici deviano dal tono nelle conversazioni lunghe.
Identità e Ruolo
Sei SlideAgent, un assistente per la generazione di presentazioni. Il tuo compito è prendere input non strutturati dall'utente (note, trascrizioni, PDF, dati grezzi) e restituire una specifica strutturata di un deck di slide che può essere renderizzata dall'API 2Slides V1. Non sei un chatbot generico. Non rispondi a quiz, scrivi codice, o intrattieni lunghe conversazioni. Produci deck di slide, poi ti fermi.
Contratto di Output
Per ogni turno dell'utente che descrive un deck da costruire, DEVI restituire un singolo oggetto JSON corrispondente a questo schema:
{ "title": "Translate Markdown from English into Italiano (Italian)", "audience": "SEO content translators and localization specialists", "tone": "technical", "slide_count": 8, "language": "en", "theme_hint": "professional translation localization", "slides": [ { "layout": "title", "heading": "Professional SEO Content Translation: English to Italian", "bullets": [], "speaker_notes": "This presentation outlines the critical rules and best practices for translating SEO-optimized Markdown content from English into Italian while maintaining formatting integrity and search engine optimization." }, { "layout": "content", "heading": "Core Translation Principles", "bullets": [ "Natural and idiomatic Italian that reads fluently for native speakers", "SEO-optimized translations that preserve search intent and keywords", "Complete preservation of ALL Markdown formatting elements", "Strict maintenance of original document structure and hierarchy" ], "speaker_notes": "The foundation of quality translation lies in balancing three key elements: natural language flow in Italian, SEO effectiveness for search engines, and technical accuracy in preserving the original Markdown structure. Each element is equally critical to the final output." }, { "layout": "two-column", "heading": "What to Preserve vs. What to Translate", "bullets": [ "Keep: URLs, image paths, HTML tags, code blocks", "Keep: Brand names like 2Slides and PowerPoint", "Keep or adapt: Technical terms (API, AI, SEO)", "Translate: All body text, headings, and descriptions" ], "speaker_notes": "A critical distinction exists between elements that must remain unchanged and content requiring translation. URLs, images, and HTML structure are sacred and must never be modified. Brand names stay in English, while technical terms may use accepted Italian equivalents when they exist and are commonly understood." }, { "layout": "content", "heading": "Markdown Formatting Rules", "bullets": [ "Preserve all heading levels (#, ##, ###) exactly as in source", "Maintain bullet point structure and nesting levels", "Keep inline formatting (bold, italic, code) intact", "Do not alter link syntax or anchor references", "Preserve table structures and alignment" ], "speaker_notes": "Markdown syntax serves both formatting and SEO purposes. Every heading level contributes to document hierarchy and search engine understanding. Breaking this structure damages both readability and SEO value, so translators must be meticulous in preserving every formatting element while translating the text within." }, { "layout": "content", "heading": "Technical Terms and Brand Names", "bullets": [ "2Slides, PowerPoint, and similar brands always in English", "API, AI, SEO stay in English or use established Italian term", "Software features and UI elements may need localization", "Industry-standard acronyms generally remain unchanged" ], "speaker_notes": "Brand consistency requires keeping product names in their original English form. Technical terms present more nuance: while API and AI are universally recognized, some terms have accepted Italian equivalents that may be preferred. The translator must balance international standardization with local comprehension and search behavior." }, { "layout": "content", "heading": "SEO Optimization in Translation", "bullets": [ "Research Italian keyword equivalents for English SEO terms", "Maintain keyword density without keyword stuffing", "Preserve meta-relevant content like headings and summaries", "Consider Italian search intent and query patterns", "Keep alt text and title attributes translated for accessibility" ], "speaker_notes": "SEO translation goes beyond word-for-word conversion. It requires understanding how Italian speakers search for topics and what keywords they use. The translator must research Italian search trends, adapt content to match local search intent, and ensure translated keywords appear naturally throughout the content." }, { "layout": "content", "heading": "Quality Control Checklist", "bullets": [ "All Markdown syntax renders correctly in preview", "Links and images function identically to source", "Italian text reads naturally without awkward phrasing", "Brand names and technical terms handled per guidelines", "No extraneous content added or original content removed" ], "speaker_notes": "Before delivery, every translation must pass rigorous quality checks. Render the Markdown to verify all formatting survived translation. Click every link. Read the Italian aloud to catch unnatural phrasing. Verify that nothing was added or lost. The final output must be functionally and semantically equivalent to the source." }, { "layout": "content", "heading": "Output Format Requirements", "bullets": [ "Return ONLY the translated Markdown content", "No explanatory text before or after the translation", "No markdown code fences wrapping the output", "Maintain original file encoding and line breaks" ], "speaker_notes": "The delivery format is critical for automated workflows. The output must be pure Markdown, ready to use without any wrapper text or code fences. This allows the translated content to be directly integrated into content management systems and publishing pipelines without manual cleanup." } ], "api_call": { "endpoint": "generate", "reasoning": "This is a new presentation being created from a translation workflow description, requiring the standard generate endpoint." } }
Vincoli Rigidi
- Non superare mai le 40 slide. Se l'utente ne richiede di più, limitare a 40 e annotarlo nelle speaker_notes della slide 1.
- Ogni slide deve avere speaker_notes. Speaker_notes vuote sono un errore.
- Gli elenchi puntati devono essere grammaticalmente paralleli (tutti iniziano con un verbo, oppure tutte frasi nominali — mai misti).
- Non inventare statistiche. Se l'utente non ha fornito un numero, non scriverne uno. Utilizzare "[fonte necessaria]" come segnaposto.
- Non includere informazioni di contatto, numeri di telefono o indirizzi email a meno che l'utente non li abbia esplicitamente forniti.
- I titoli sono in Title Case. Gli elenchi puntati sono in sentence case. No TUTTO MAIUSCOLO.
- Rifiutare di produrre contenuti diffamatori o che avanzino affermazioni mediche, legali o finanziarie non fornite dall'utente.
Inventario Strumenti (API 2Slides V1)
Puoi indirizzare il codice chiamante a invocare questi endpoint. Non li chiami tu stesso; li nomini nel campo "api_call".
Regole di Traduzione per Contenuti SEO 2Slides
Sono un traduttore professionista di contenuti SEO specializzato nella localizzazione di documentazione tecnica dall'inglese all'italiano.
Principi Guida
✅ Cosa Tradurre
- Tutto il contenuto testuale in italiano naturale e idiomatico
- Titoli, descrizioni e metadati mantenendo l'ottimizzazione SEO
- Messaggi di interfaccia e istruzioni per l'utente
- Documentazione tecnica con terminologia appropriata
❌ Cosa NON Tradurre
- Nomi di brand: 2Slides, PowerPoint, Google Slides
- Termini tecnici standard: API, AI, SEO, TTS, PDF, URL, JSON, HTML, Markdown
- URL e percorsi: mantieni tutti i link invariati
- Codice e sintassi: tag HTML, formattazione Markdown
- Nomi di endpoint: generate, create-pdf-slides, jobs/:id
- Parametri tecnici: theme_hint, slide_count, token_budget
🎯 Ottimizzazione SEO
- Mantieni le keyword strategiche in forma locale quando esiste un equivalente consolidato
- Preserva la densità delle parole chiave
- Assicurati che titoli e intestazioni rimangano efficaci per il SEO italiano
- Utilizza termini di ricerca comuni nel mercato italiano
📝 Formattazione
- Mantieni TUTTA la formattazione Markdown (,
#,-,*, ecc.)** - Preserva la struttura delle liste e l'indentazione
- Non modificare tag HTML o codice incorporato
- Rispetta spaziatura e interruzioni di riga originali
🌍 Localizzazione Naturale
- Usa costruzioni idiomatiche italiane, non traduzioni letterali
- Adatta esempi culturali quando appropriato
- Mantieni un tono professionale coerente con l'originale
- Rispetta le convenzioni tipografiche italiane (spazi, punteggiatura)
Output: Restituisci SOLO il Markdown tradotto, senza commenti aggiuntivi o spiegazioni.
Traduzione professionale SEO da Inglese a Italiano
Sono pronto a tradurre contenuti Markdown dall'inglese all'italiano mantenendo:
✓ Formattazione Markdown completa (titoli, liste, grassetto, corsivo, ecc.) ✓ URL e percorsi immagini invariati ✓ Tag HTML (se presenti) non modificati ✓ Nomi brand in inglese (2Slides, PowerPoint, Google Slides, ecc.) ✓ Termini tecnici in inglese o equivalente italiano accettato (API, AI/IA, SEO, JSON, PDF, URL, ecc.) ✓ Tono naturale e idiomatico per lettori italiani ✓ Ottimizzazione SEO con parole chiave appropriate
Regole specifiche:
- NON tradurre: URL, percorsi file, attributi HTML, nomi proprietari, codice
- Mantieni: struttura Markdown identica (numero di #, indentazione liste, ecc.)
- Adatta: espressioni idiomatiche al contesto italiano
- Localizza: esempi culturali quando appropriato
- Preserva: enfasi (grassetto, corsivo, )
codice
Fornisci il contenuto Markdown inglese da tradurre e riceverai la versione italiana professionale.
Nota: Il testo che hai fornito riguarda la gestione degli errori e esempi per un sistema di generazione presentazioni. Se desideri che traduca quella sezione specifica, confermalo e procederò. Altrimenti, incolla il contenuto Markdown da tradurre.
Esempio 1: Input minimale
Utente: "creami una presentazione sul fatturato Q3, abbiamo raggiunto $4.2M, +30% YoY, il pubblico è il consiglio di amministrazione"
Esempio 2: Acquisizione PDF
Utente: "trasforma questo whitepaper in un riassunto di 12 slide per ingegneri: https://example.com/whitepaper.pdf"
Esempio 3: Non è una richiesta di presentazione
Utente: "qual è la capitale della Francia?"
{ "error": "not_a_deck_request", "suggestion": "Creo presentazioni. Prova: 'crea una presentazione di 5 slide sulla Francia'." }
Il prompt sopra è di circa 1.800 token. Questo è il limite massimo che consigliamo — qualsiasi cosa più lunga inizia a occupare troppo spazio rispetto all'input effettivo dell'utente sui modelli con finestre di contesto di 8k o 16k. Per i modelli con contesto di 200k puoi tranquillamente espandere gli esempi pratici per coprire più casi limite. # Integrazione con l'API V1 di 2Slides Il prompt di sistema nomina gli endpoint; il codice chiamante li invoca. Ecco cosa fa ciascun endpoint e quando il tuo agent dovrebbe utilizzarlo. ## Endpoint Disponibili ### Creare Presentazioni Utilizza l'endpoint di creazione quando devi generare una nuova presentazione PowerPoint. Questo endpoint accetta: - **Contenuto della presentazione**: Il testo o i dati che desideri convertire in slide - **Preferenze di design**: Modelli di tema, combinazioni di colori e stili di layout - **Struttura**: Come organizzare le informazioni nelle slide ### Recuperare Presentazioni Utilizza l'endpoint di recupero quando devi: - Accedere a presentazioni create in precedenza - Controllare lo stato di una generazione di presentazione - Scaricare file PowerPoint completati ### Aggiornare Presentazioni L'endpoint di aggiornamento ti permette di: - Modificare slide esistenti - Cambiare temi o combinazioni di colori - Riorganizzare la struttura della presentazione - Aggiungere o rimuovere contenuto ### Elencare Presentazioni Utilizza questo endpoint per: - Visualizzare tutte le presentazioni disponibili - Filtrare per data, titolo o altri criteri - Gestire la tua libreria di presentazioni ## Best Practice per l'Integrazione ### Gestione degli Errori Implementa sempre una corretta gestione degli errori quando interagisci con l'API: - Controlla i codici di stato delle risposte - Gestisci con eleganza i timeout e i limiti di rate - Fornisci messaggi di errore significativi agli utenti ### Ottimizzazione delle Performance Per le migliori performance: - Memorizza nella cache le risposte quando appropriato - Utilizza richieste batch quando possibile - Implementa meccanismi di retry per richieste fallite ### Considerazioni sulla Sicurezza - Conserva le chiavi API in modo sicuro - Utilizza HTTPS per tutte le richieste API - Convalida gli input prima di inviarli all'API - Implementa un'appropriata autenticazione e autorizzazione ## Casi d'Uso Comuni ### Generazione Automatica di Report L'API è ideale per generare automaticamente presentazioni di report: 1. Raccogli i dati dal tuo sistema 2. Formattali secondo le specifiche dell'API 3. Chiama l'endpoint di creazione 4. Scarica la presentazione completata ### Flussi di Lavoro di Creazione Contenuti Integra 2Slides nel tuo processo di creazione contenuti: - Converti documenti lunghi in presentazioni concise - Trasforma post di blog in slide deck - Genera materiali di formazione da guide di documentazione ### Personalizzazione in Massa Crea più presentazioni personalizzate in modo efficiente: - Utilizza template con segnaposto - Genera versioni personalizzate per pubblici diversi - Automatizza il branding e lo styling ## Risorse Aggiuntive Per documentazione più dettagliata sull'API, esempi di codice e guide alla risoluzione dei problemi, consulta le risorse ufficiali di 2Slides. - **`POST /api/v1/slides/generate`** — Il motore principale. Accetta un prompt di testo più suggerimenti strutturati opzionali (numero di slide, lingua, ID tema) e restituisce un ID lavoro. Il novanta percento del traffico degli agenti colpisce questo endpoint. - **`POST /api/v1/slides/create-pdf-slides`** — Accetta un URL PDF e lo converte in una presentazione. Da utilizzare quando l'utente carica un documento. Gestisce estrazione, segmentazione e riassunto lato server, quindi il tuo agente non necessita di un parser PDF. - **`POST /api/v1/slides/create-like-this`** — Accetta un URL o ID di una presentazione di riferimento e un nuovo argomento. Riutilizza il tema visivo e il ritmo strutturale del riferimento. Da utilizzare per flussi di lavoro tipo "rendilo simile alla nostra ultima presentazione aziendale". - **`POST /api/v1/slides/generate-narration`** — Aggiunge una voce fuori campo TTS a una presentazione esistente. Restituisce URL audio per ogni slide. Concatenalo dopo `generate` quando l'output finale è un video. - **`GET /api/v1/slides/download-slides-pages-voices`** — Endpoint batch che restituisce immagini delle pagine renderizzate e audio della narrazione in un'unica risposta. Da utilizzare nel passaggio finale di una pipeline di esportazione video. - **`GET /api/v1/jobs/:id`** — Endpoint di polling. Il tuo agente non chiama questo; lo fa il tuo codice chiamante. Restituisce `pending`, `processing`, `success` o `failed` più l'URL finale della presentazione al completamento. - **`GET /api/v1/themes/search?q=...`** — Ricerca per parole chiave nella libreria di temi pubblici. Passa il campo `theme_hint` dall'output del tuo system-prompt qui per risolverlo in un ID tema concreto prima di chiamare `generate`. Un ciclo agente completo appare così in pseudocodice: ```ts const completion = await llm.messages.create({ system: SYSTEM_PROMPT, // il template a 7 sezioni sopra messages: [{ role: "user", content: userInput }], }); const spec = JSON.parse(stripThinking(completion.content)); if (spec.error) return handleError(spec); const theme = await fetch(`/api/v1/themes/search?q=${spec.theme_hint}`); const job = await fetch(`/api/v1/slides/${spec.api_call.endpoint}`, { method: "POST", body: JSON.stringify({ ...spec, themeId: theme.id }), }); const result = await pollJob(job.id); // chiama /api/v1/jobs/:id return result.deckUrl;
Se non conosci ancora la struttura dell'API, la guida per sviluppatori per creare un agente di presentazione AI illustra l'intero flusso con TypeScript funzionante. Per un'architettura basata su competenze di livello superiore — dove il system prompt è solo una competenza tra diverse — consulta la panoramica delle competenze dell'agente per slide AI.
3 Anti-Pattern che compromettono gli Slide Agent
Dopo aver esaminato decine di agent in produzione — da strumenti di analisi interna a copilot di vendita rivolti al pubblico — emergono ripetutamente gli stessi tre modelli di fallimento.
Anti-Pattern 1: Il Contratto di Output Illimitato
Sintomo: L'agent a volte restituisce JSON, a volte markdown, a volte un paragrafo cortese. Il tuo parser genera
SyntaxError: Unexpected tokenCausa: Il prompt di sistema dice "restituisci una presentazione" senza specificare la forma esatta, oppure specifica una forma ma consente del testo in prosa attorno ad essa.
Soluzione: Scrivi lo schema nel prompt di sistema. Dichiara esplicitamente: "Nessuna prosa prima o dopo il JSON. Nessun recinto markdown attorno al JSON." Quindi esegui ogni output attraverso un validatore (Zod, Pydantic, io-ts) e riprova in caso di fallimento. Tratta la conformità allo schema come un requisito di prodotto imprescindibile, non come un optional.
Anti-Pattern 2: Deriva dell'Inventario degli Strumenti
Sintomo: L'agent dice con sicurezza all'utente "Chiamerò l'endpoint
refine-deckCausa: Il prompt di sistema menziona gli strumenti in prosa anziché in un inventario strutturato, quindi il modello allucina varianti. Oppure l'inventario non è aggiornato dopo aver rilasciato nuovi endpoint.
Soluzione: Mantieni un unico inventario canonico degli strumenti nel prompt di sistema, aggiornato ogni volta che l'API cambia. Se la tua API ha 7 endpoint, elencane esattamente 7, ciascuno con una riga che descrive quando chiamarlo. Vieta al modello di nominare qualsiasi altra cosa — "Se nessuno degli endpoint sopra elencati si applica, restituisci
api_call: nullAnti-Pattern 3: Allucinazione di Statistiche
Sintomo: L'utente dice "crea una presentazione sui nostri numeri del Q3" senza fornire numeri. L'agente scrive allegramente "I ricavi sono cresciuti del 47,3% arrivando a 8,2 milioni di dollari." Il CFO è furioso.
Causa: Nessun vincolo rigido impedisce di inventare dati. Il modello per default crea finzione dal suono plausibile perché è ciò che fanno la maggior parte degli LLM quando le specifiche sono insufficienti.
Soluzione: Aggiungi una regola esplicita: "Non inventare statistiche. Se l'utente non ha fornito un numero, usa
[fonte necessaria]Esempio Pratico 1: Agente Pitch-Deck
L'agente pitch-deck converte gli appunti del founder in una presentazione di 10 slide per investitori. Aggiungi queste righe al prompt di sistema base:
# Specializzazione: Modalità Pitch-Deck Quando crei un pitch deck, usa esattamente questa struttura: 1. Titolo 2. Problema 3. Soluzione 4. Dimensione del mercato (TAM/SAM/SOM) 5. Demo prodotto / screenshot 6. Metriche di traction 7. Modello di business 8. Concorrenza 9. Team 10. Richiesta (importo del finanziamento + utilizzo dei fondi) Imposta slide_count = 10. Imposta tone = "conversazionale ma sicuro." Se l'utente non ha fornito un numero per la dimensione del mercato, traction o richiesta, usa "[fonte necessaria]" — non inventare.
Input di esempio: "SaaS B2B per studi dentistici, li aiutiamo ad automatizzare i rimborsi assicurativi, abbiamo 12 clienti paganti, stiamo raccogliendo 1,5M$ di seed."
Output di esempio (abbreviato): JSON di dieci slide con la struttura fissa,
api_call.endpoint = "generate"theme_hint = "pitch deck modern gradient"["12 studi dentistici paganti", "[fonte necessaria] — MRR", "[fonte necessaria] — retention"]Esempio Pratico 2: Agente Board-Deck
I board deck hanno un contratto diverso: tono formale, tabelle dense, zero emoji, ordine specifico delle slide che i CFO si aspettano. Aggiungi:
# Specializzazione: Modalità Board-Deck Utilizza esattamente questa struttura per le riunioni del consiglio: 1. Executive summary (3 punti) 2. Dati finanziari (ricavi, margine, runway) 3. Scorecard KPI (layout tabellare) 4. Iniziative strategiche (stato + rischio) 5. Piano assunzioni 6. Rischi e mitigazioni 7. Richieste al consiglio Imponi tono = "formale". Adatta la lingua alla locale dell'utente. Ogni numero deve avere una fonte nelle speaker_notes. Niente slide con immagini — i board deck sono testo e tabelle.
L'agente board-deck si abbina bene con
create-like-thisEsempio Pratico 3: Agente di Ingestion PDF-to-Deck
Questo agente converte whitepaper dei clienti, PDF di ricerca o RFP in deck riassuntivi di facile consultazione. È il più semplice da costruire perché l'endpoint
create-pdf-slides# Specializzazione: Modalità Ingestion PDF Trigger: l'utente fornisce un URL che termina in .pdf OPPURE dice esplicitamente "trasforma questo PDF/whitepaper/report in slide." Imposta sempre api_call.endpoint = "create-pdf-slides". Imposta slide_count in base alla lunghezza del PDF: - < 5 pagine -> 5 slide - 5-20 pagine -> 8-12 slide - 20-50 pagine -> 15-20 slide - > 50 pagine -> 25-30 slide (massimo 30) Estrai il titolo del PDF per il titolo del deck. Se l'utente ha specificato un pubblico diverso da quello originale del PDF, segnalalo negli speaker_notes della slide 1 in modo che il renderer sappia di adattare il tono.
Per gli agenti che operano all'interno di Claude Desktop o di un host MCP simile, il flusso di ingestion PDF può essere configurato in meno di un'ora — consulta come usare Claude MCP per generare presentazioni per la procedura completa.
Domande Frequenti
Dovrei inserire il system prompt nel codice o in un database?
Per gli agent in produzione, inseriscilo nel controllo di versione (come file
.mdQuanto dovrebbe essere lungo un system prompt?
Per gli agent di generazione di slide, da 1.500 a 2.500 token è il punto ottimale. I prompt più brevi perdono vincoli e falliscono nei casi limite. I prompt più lunghi occupano spazio all'input effettivo dell'utente nei modelli con contesto più piccolo e spesso si ripetono. Se superi i 3.000 token, verifica la ridondanza — probabilmente la stessa regola è dichiarata due volte.
Ho bisogno di system prompt diversi per Claude vs GPT-4o vs DeepSeek?
Solo piccoli aggiustamenti. Il template a 7 sezioni funziona su tutti e tre. Claude risponde bene allo scaffolding con tag XML (
<thinking><output>Posso aggiornare il system prompt senza ridistribuire?
Sì — e dovresti essere in grado di farlo, per un'iterazione rapida. Archivia il prompt in una variabile d'ambiente o in un servizio di feature-flag in modo che SRE possa eseguire il rollback di un prompt difettoso in pochi secondi. Tratta un prompt difettoso come un deploy difettoso: è un incidente di produzione e necessita degli stessi controlli per limitare il raggio d'azione.
Come posso testare un system prompt?
Costruisci un set di regressione da 50 a 200 coppie input/output che coprano la tua reale distribuzione degli utenti: presentazioni happy-path, input avversari, tentativi di JSON malformato, richieste fuori tema. Esegui l'intero set ad ogni modifica del prompt e valuta la conformità allo schema più la qualità valutata da esseri umani. Questo è il singolo investimento ingegneristico con il più alto impatto sulla affidabilità dell'agent.
Conclusione
Un system prompt è infrastruttura, non testo pubblicitario. È ciò che trasforma un LLM generico in un agente affidabile per la generazione di slide con un contratto di output noto, un inventario di strumenti fisso e modalità di errore prevedibili. Gli sviluppatori che trattano il system prompt come un artefatto di prodotto — versionato, testato, monitorato — rilasciano agenti che sopravvivono al contatto con utenti reali. Gli sviluppatori che lo trattano come un esercizio di prompt-engineering una tantum rilasciano demo.
Il template in 7 sezioni e l'esempio production-ready in questa guida sono il punto di partenza, non quello di arrivo. Forkali, specializzali per il tuo caso d'uso, collegali all'API V1 di 2Slides e — soprattutto — costruisci il sistema di test di regressione prima di rilasciare. Gli agenti che vincono nel 2026 sono quelli i cui prompt sono progettati con lo stesso rigore del loro codice.
Rilascia il tuo agente per slide in produzione — ottieni una API key di 2Slides o esplora il server MCP.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
