Template prompt API Design con esempio

Prompt riutilizzabile

Design an API contract that is usable, stable, secure, and observable.

Tipo di attività: API Design
Obiettivo: Design an API contract that is usable, stable, secure, and observable.

Contesto:
- [Progetto, prodotto o tema]: [Progetto, prodotto o tema]
- [Pubblico e situazione]: [Pubblico e situazione]
- [Vincoli, requisiti e cose da evitare]: [Vincoli, requisiti e cose da evitare]

Informazioni da fornire:
[Incolla qui il materiale di partenza]

Output atteso:
1. Panoramica architettura
2. Componenti principali
3. Flusso dati
4. Compromessi
5. Checklist accuratezza

Criteri di qualità:
- Sii specifico ed evita consigli generici.
- Dichiara chiaramente le ipotesi.
- Preferisci prossimi passi concreti alla teoria generica.
- Se mancano informazioni importanti, fai fino a 3 domande di chiarimento prima di rispondere.
- Per affermazioni fattuali o sensibili al tempo, distingui fatti noti, inferenze e punti da verificare.

Esempio guidato

L’esempio sotto compila lo stesso prompt per uno scenario Ingegneria realistico. È volutamente sobrio: mostra come funziona il template, non promette di risolvere tutto.

Tipo di attività: API Design
Obiettivo: Design an API contract that is usable, stable, secure, and observable.

Contesto:
- [Progetto, prodotto o tema]: Un’attività reale di Ingegneria con il prompt API Design
- [Pubblico e situazione]: Un collega che ha bisogno di una risposta utile e prossimi passi chiari
- [Vincoli, requisiti e cose da evitare]: Essere specifici, dichiarare ipotesi, evitare affermazioni senza prove e rendere l’output operativo.

Informazioni da fornire:
Materiale esempio: il team ha bisogno di aiuto con API Design. La situazione è disordinata, ma l’obiettivo è abbastanza chiaro per separare fatti, ipotesi, rischi e prossime azioni.

Output atteso:
1. Panoramica architettura
2. Componenti principali
3. Flusso dati
4. Compromessi
5. Checklist accuratezza

Criteri di qualità:
- Sii specifico ed evita consigli generici.
- Dichiara chiaramente le ipotesi.
- Preferisci prossimi passi concreti alla teoria generica.
- Se mancano informazioni importanti, fai fino a 3 domande di chiarimento prima di rispondere.
- Per affermazioni fattuali o sensibili al tempo, distingui fatti noti, inferenze e punti da verificare.

Come usare questo prompt

1. Sostituisci i placeholder con l’attività reale API Design, pubblico, materiale sorgente e vincoli.
2. Mantieni la struttura dell’output quando possibile; rende la risposta più facile da valutare.
3. Incolla il prompt finito nel tuo assistente AI, poi fai una domanda di follow-up su ipotesi o prove mancanti.

Cosa deve contenere una buona risposta

• 1. Panoramica architetturaRendi concreta questa sezione: Panoramica architettura.
• 2. Componenti principaliRendi concreta questa sezione: Componenti principali.
• 3. Flusso datiRendi concreta questa sezione: Flusso dati.
• 4. CompromessiRendi concreta questa sezione: Compromessi.
• 5. Checklist accuratezzaRendi concreta questa sezione: Checklist accuratezza.

Perché questo prompt funziona

• API Design chiarisce subito tipo di attività e obiettivo, riducendo risposte vaghe.
• Il prompt chiede contesto, materiale e vincoli prima della risposta finale.
• Le 5 sezioni di output rendono la risposta leggibile e confrontabile.
• La qualità richiesta spinge l’assistente a fare domande e a indicare cosa va verificato.

Errori da evitare

• Lasciare i placeholder vuoti aspettandosi che il modello indovini il contesto.
• Rimuovere la struttura dell’output e ottenere una risposta difficile da controllare.
• Usare il prompt per fatti recenti senza verificare fonti e date.

Template prompt correlati