Questo articolo spiega come scrivere prompt efficaci per i Super Agent di ClickUp.
Sei nuovo ai Super Agent? Leggi il nostro articolo Cosa sono i Super Agent? prima di iniziare.
La disponibilità delle funzionalità e i limiti variano in base al piano e al ruolo dell'utente. Scopri di più
Esistono impostazioni di privacy, sicurezza e autorizzazioni che si applicano esclusivamente ai Super Agent. Scopri di più
Per utilizzare i Super Agent, devi attivare la ClickApp IA per la tua area di lavoro.
Sei nuovo ai Super Agent? Leggi il nostro articolo Cosa sono i Super Agent? prima di iniziare.
Configurare manualmente un Super Agent
Assicurati di avere tutte le informazioni! Scopri come configurare manualmente il tuo Super Agent, inclusa l'immissione del prompt.
I Super Agent possono anche essere creati nel nostro builder Super Agent in linguaggio naturale.
I frammenti di prompt descritti di seguito sono suddivisi in sezioni. In ogni sezione è presente un esempio di prompt valido e un prompt ottimizzato.
Ruolo e obiettivo
I Super Agent di ClickUp sono come dei colleghi. Puoi assegnare loro un ruolo o una persona e affidar loro delle attività. Immaginali come un nuovo dipendente o qualcuno alle prime armi nel suo ruolo.
| Prompt valido | Prompt ottimizzato |
| Sei un agente di contenuti e approfondimenti specializzato nell'individuare le funzionalità di prodotto appena rilasciate e nel tradurle in sintesi efficaci in italiano semplice e in angolazioni di vendita per i giovani professionisti appassionati di nuove tecnologie, ma che potrebbero non avere competenze tecniche. | Sei un agente perspicace e creativo specializzato nell'individuare le funzionalità di prodotto appena rilasciate, nel raccogliere informazioni su tali funzionalità e nel tradurre quelle informazioni sulle funzionalità in angolazioni di vendita efficaci per i giovani professionisti appassionati di nuove tecnologie, ma che potrebbero non avere competenze tecniche. |
Perché il prompt ottimizzato è migliore?
Il prompt ottimizzato utilizza un linguaggio ricco. Ad esempio: "Sei un agente perspicace e creativo."
- Un linguaggio ricco fornisce al Super Agent sfumature e contesto per le attività che richiedono ragionamento soggettivo, deduzione o sintesi di tipo umano.
Il prompt ottimizzato usa lo stesso termine per garantire coerenza e ripete i termini in modo che il Super Agent non debba dedurre alcuna informazione. Ad esempio: "specializzato nell'individuare le funzionalità di prodotto appena rilasciate, nel raccogliere informazioni su tali funzionalità e nel tradurre quelle informazioni sulle funzionalità."
- Mantenere la coerenza dei termini e ridurre le inferenze preserva la capacità elaborativa del Super Agent per il compito principale.
Ambito
Questa parte del prompt introduce il Super Agent all'ambito del suo compito.
| Prompt valido | Prompt ottimizzato |
| Ogni settimana, raccogli le funzionalità completate nell'intera area di lavoro negli ultimi 7 giorni. Escludi le correzioni di bug evidenti, le attività di manutenzione, i refactoring o le attività solo interne quando identificati tramite titolo/etichette. |
Ogni settimana, raccogli le funzionalità completate nell'intera area di lavoro negli ultimi 7 giorni. Concentrati sulle nuove funzionalità di prodotto escludendo le correzioni di bug evidenti, le attività di manutenzione, i refactoring o le attività solo interne quando identificati tramite titolo/etichette. |
Perché il prompt ottimizzato è migliore?
Il prompt ottimizzato usa istruzioni positive invece di istruzioni negative. Ad esempio, "concentrati sulle nuove funzionalità di prodotto escludendo le correzioni di bug evidenti, le attività di manutenzione, i refactoring o le attività solo interne quando identificati tramite titolo/etichette".
- Quando inizi la frase dicendo al Super Agent di "escludere le correzioni di bug evidenti", il Super Agent impiega la sua capacità elaborativa a pensare ai bug, invece di trovare nuove funzionalità di prodotto.
- Iniziare con un'indicazione positiva, "Concentrati sulle nuove funzionalità di prodotto", consente al Super Agent di impiegare la sua capacità elaborativa per trovare nuove funzionalità di prodotto invece di concentrarsi sui bug.
Passaggi successivi
Indica al Super Agent quali strumenti utilizzare. Ad esempio, per cercare nuove funzionalità di prodotto, il Super Agent dovrà avere accesso a tutta o a parte della tua area di lavoro.
Scopri di più su come creare Super Agent in ClickUp.
Nel prompt, indica al Super Agent come utilizzare lo strumento. Ad esempio, puoi dire al Super Agent: "Verifica che esista un'attività denominata 'Weekly Product Features'; se non la trovi, creala con lo strumento di creazione attività."
Scopri di più su come usare gli strumenti di ClickUp Brain.
Indicazioni per la scrittura
Questa parte del prompt indica al Super Agent cosa produrre in base alle informazioni raccolte.
| Prompt base | Prompt ottimizzato |
| Fornisci 1-3 angoli di vendita incisivi per ogni funzionalità, usando un linguaggio orientato all'azione e vantaggi specifici. | Fornisci 1-3 angoli di vendita incisivi per ogni funzionalità, usando un linguaggio orientato all'azione e vantaggi specifici. Usa le informazioni sulle funzionalità che hai raccolto per riflettere su come queste funzionalità potrebbero avvantaggiare o entusiasmare giovani clienti appassionati di tecnologia ma senza un background tecnico. Scrivi in un linguaggio incisivo e orientato all'azione che dipinga un'immagine coinvolgente ed entusiasmante di come vendere ogni funzionalità. |
Perché il prompt ottimizzato è migliore?
Il prompt ottimizzato mostra in modo efficace la relazione causa-effetto. Ad esempio: "Distilla le informazioni sulle funzionalità che hai raccolto in angoli di vendita ad alto impatto che parlino direttamente alle esigenze dei clienti."
- Questo tipo di linguaggio è utile quando il Super Agent non sfrutta abbastanza un elemento del tuo prompt nel risultato prodotto.
Il prompt ottimizzato usa la relazione causa-effetto per chiedere al Super Agent di trasformare le informazioni raccolte nel risultato finale. Ad esempio: "Usa le informazioni sulle funzionalità che hai raccolto per riflettere su come queste funzionalità potrebbero avvantaggiare o entusiasmare giovani clienti appassionati di tecnologia ma senza un background tecnico."
- Usa questo tipo di linguaggio quando il Super Agent si concentra eccessivamente su una parte del tuo prompt.
Il prompt ottimizzato include un altro esempio di linguaggio ricco: "Scrivi in un linguaggio incisivo e orientato all'azione che dipinga un'immagine coinvolgente ed entusiasmante di come vendere ogni funzionalità."
- Usa questo tipo di linguaggio per ottenere esattamente il risultato che stai cercando.
Formato di output
Questa parte del prompt è come un modello che indica al Super Agent come formattare il suo output.
| Prompt valido | Prompt ottimizzato |
| Voci delle funzionalità: Nome: (Titolo dell'attività) Fonte: Link all'attività Di cosa si tratta: Spiegazione in 1–2 frasi in linguaggio semplice |
Formato delle voci delle funzionalità: Nome: (Titolo della funzionalità) Fonte: Link all'attività relativa alla funzionalità Di cosa si tratta la funzionalità: (Spiega in modo conciso che cos'è la funzionalità, come funziona e come si inserisce nel prodotto più in generale.) |
Perché il prompt ottimizzato è migliore?
Entrambi i prompt forniscono un modello con le parentesi. Il Super Agent saprà di dover sostituire il segnaposto con il contenuto che ha raccolto. Ad esempio, "Nome: (Titolo della funzionalità)."
Il prompt ottimizzato è molto più descrittivo. Ad esempio, "Di cosa si tratta la funzionalità: (Spiega in modo conciso che cos'è la funzionalità, come funziona e come si inserisce nel prodotto più in generale.)"
- Usa la formattazione dell'output quando il Super Agent trae vantaggio da una guida anziché dover elaborare il formato autonomamente. Ad esempio, per report strutturati, procedure operative standard o articoli di blog.
Passaggio successivo
Per rafforzare la struttura che stai cercando, puoi aggiungere un riepilogo alla fine di questa sezione. Ad esempio:
"Formato di output: Produci contenuto Markdown rifinito e pronto per la pubblicazione nella pagina settimanale. Usa paragrafi brevi ed elenchi puntati. Mantieni ogni voce della funzionalità entro circa 120 parole, esclusi i punti elenco."
Usa i delimitatori per etichettare le sezioni del prompt
Quando il tuo prompt include materiale di riferimento come linee guida del brand, descrizioni di prodotto o contenuto di esempio, indica dove inizia e finisce ogni sezione.
| Prompt base | Prompt ottimizzato |
| Brand guidelines: 1 Use short sentences. 2 Avoid jargon. 3 Always lead with the benefit. Product description: A Super Agent that ensures everyone follows brand guidelines. |
Brand guidelines: 1 Use short sentences. 2 Avoid jargon. 3 Always lead with the benefit. --end of brand guidelines-- Product description: A Super Agent that ensures everyone follows brand guidelines. —end of product description— |
Perché il prompt ottimizzato è migliore?
Il prompt ottimizzato usa i delimitatori per indicare esplicitamente dove termina ogni sezione. Questo elimina l'ambiguità e permette al Super Agent di passare da una sezione all'altra senza dover interpretare i confini.
Puoi formattare i delimitatori come preferisci, purché tu sia coerente in tutto il prompt. Alcune opzioni:
- --end of [section name]--
-
Tag XML: <brand_guidelines> Your content here </brand_guidelines>
- I tag XML sono un formato di delimitatore particolarmente efficace. I modelli di IA di solito interpretano questi confini in modo affidabile.
- Trattini o altri separatori visivi
Evita abbreviazioni e linguaggio vago
I Super Agent non comprendono il linguaggio abbreviato così bene come gli esseri umani. Risparmia la potenza di calcolo del Super Agent per ottenere risultati migliori.
| Prompt generico | Prompt ottimizzato |
| Guarda il documento e scrivi qualcosa per i social sulla nuova funzionalità. | Leggi il brief del prodotto e scrivi un post sui social media per annunciare la nuova funzionalità di pianificazione. Concentrati sul vantaggio per i team remoti. |
Perché il prompt ottimizzato è migliore?
Il prompt ottimizzato sostituisce i termini vaghi con termini specifici, mantenendo il Super Agent concentrato sull'attività invece di interpretare abbreviazioni o linguaggio vago.
Usare comandi positivi o negativi
Se l'istruzione è una regola chiara come "non usare i punti esclamativi", un comando negativo funziona bene. Se l'istruzione riguarda il tono, lo stile o il giudizio, riscrivila come comando positivo.
Anche con regole oggettive, evita di usare troppi comandi negativi in un singolo prompt.
| Prompt generico | Prompt ottimizzato |
| Non omettere nessuna informazione dal testo originale | Mantieni tutte le informazioni del testo originale. |
Usa un linguaggio integrativo e trasformativo
Se il tuo Super Agent non utilizza abbastanza una risorsa che hai fornito, oppure copia eccessivamente parte del tuo input, usa un linguaggio integrativo o trasformativo.
Linguaggio integrativo
Se il tuo Super Agent non utilizza abbastanza una risorsa che hai fornito, usa un linguaggio integrativo.
Il linguaggio integrativo è molto compresso: usa proposizioni subordinate per collegare strettamente l'input e il compito.
| Prompt efficace | Prompt ottimizzato |
| Prendi gli angoli di marketing e scrivi un post per i social media. | Usa gli angoli di marketing per scrivere un post per i social media. |
Linguaggio trasformativo
Se il tuo Super Agent copia eccessivamente parte del tuo input, ad esempio copiando verbatim una descrizione del prodotto invece di reinterpretarla, usa un linguaggio trasformativo.
Il linguaggio trasformativo si concentra su parole che implicano un cambiamento e suddivide l'azione in più passaggi.
| Prompt efficace | Prompt ottimizzato |
| Trasforma la descrizione del prodotto in una canzone. | Prendi i concetti e i dettagli più convincenti dalla descrizione del prodotto e reinterpretali come una canzone. |
Suddividi i prompt complessi
Suddividi i prompt complessi per migliorare la qualità dell'output.
Se un prompt indica a un Super Agent di fare due cose molto diverse, come estrarre dettagli tecnici da un documento e poi trasformarli in testi di marketing raffinati, suddividi il prompt.
| Prompt generico | Prompt ottimizzato |
| Trasforma la descrizione del prodotto in una canzone. | Passaggio 1: estrai i principali dettagli tecnici da questo documento ed elencali. Passaggio 2: utilizzando i dettagli estratti, scrivi un riepilogo rivolto ai clienti con un tono informale. |
Perché il prompt ottimizzato è migliore?
Il prompt è suddiviso in due passaggi chiari con un linguaggio dettagliato.
Aggiungi struttura ai prompt lunghi
Usa il seguente schema per migliorare il risultato dei prompt più lunghi:
| Sezione | Cosa includere | Esempio |
| Contesto | Il ruolo del Super Agent, il contesto dell'attività e gli eventuali fattori di complicazione. | Sei uno specialista di marketing di prodotto. Abbiamo lanciato una nuova funzionalità la settimana scorsa e dobbiamo fare un follow-up con i clienti esistenti. |
| Risorse | Qualsiasi materiale di riferimento che il Super Agent utilizzerà. Indica l'inizio e la fine di ciascuna risorsa. | Aggiungi un brief di prodotto, dati sui segmenti di clientela, linee guida del brand o qualsiasi altra risorsa di cui il tuo Super Agent avrà bisogno. Usa i delimitatori per etichettarle. |
| Istruzioni dettagliate | Regole, parametri, casi limite e struttura dell'output. | Scrivi con un tono informale. Mantieni ogni sezione sotto le 100 parole. Se una funzionalità non dispone di dati sui clienti, indicala come TBD. |
| Comando finale | Una frase conclusiva che ribadisce il compito principale. | Scrivi l'email di follow-up utilizzando il brief di prodotto e le linee guida del brand. |
Gestire più scenari
Alcuni prompt di Super Agent gestiscono diverse situazioni.
Se la logica è semplice, usa un linguaggio naturale con condizioni se/allora. Ad esempio: "Se l'attività ha una scadenza, includila nel riepilogo. Se non ce l'ha, ometti la riga della scadenza."
Se il prompt prevede più percorsi, oppure se uno dei percorsi consiste nel non eseguire alcuna azione, definisci tutti gli scenari possibili in anticipo. Indica al Super Agent di sceglierne uno prima di procedere all'esecuzione.
| Prompt valido | Prompt ottimizzato |
| Rimuovi eventuali informazioni di identificazione personale (PII) dal testo. Se non ce ne sono, restituisci il testo originale. | Il tuo compito è rimuovere le PII da un testo. Prima di continuare, determina quale scenario si applica: Scenario 1: il testo contiene PII che possono essere rimosse senza alterarne il significato. Rimuovi le PII e mantieni tutto il resto. Scenario 2: il testo contiene PII, ma alcune non possono essere rimosse senza alterarne il significato. Rimuovi quelle che puoi e sostituisci le altre con [PLACEHOLDER]. Scenario 3: il testo non contiene PII. Restituiscilo così com'è scritto. Determina quale scenario si applica, quindi segui le istruzioni di quello scenario. |
Perché il prompt ottimizzato è migliore?
Il prompt ottimizzato obbliga il Super Agent a scegliere un percorso prima di tutto, in modo che le altre opzioni non occupino banda durante l'esecuzione.
Suggerimenti aggiuntivi
Se hai seguito i passaggi precedenti e il tuo Super Agent non funziona come previsto, assicurati di:
- Fornire i dati essenziali direttamente nel prompt, invece di aspettarti che il Super Agent li trovi da solo.
- Aggiungere flessibilità ai modelli che stai utilizzando. Ad esempio: "Se questa informazione non è disponibile, scrivi 'N/A' o ometti le sezioni che non possono essere completate con le informazioni fornite."
- Limitare il contesto. Ad esempio: "Il brief del prodotto è l'unica informazione a tua disposizione."
Perfeziona il tuo Super Agent
Dopo aver scritto il prompt perfetto, scopri come perfezionare il tuo Super Agent.