# Prompt Engineering 1

<span class="s1">[cursus 28568](https://talnet.instructure.com/courses/28568)</span>

## <span class="s1">Introductie</span>

[datasource](https://www.roc.ovh/books/software-development-20252627/page/prompt-engineering-1)

<span class="s1">Prompt Engineering is alsof je een buitenstaander die niets van je weet iets wilt vragen. Omdat te doen moet je dus duidelijk en geod communiceren.</span>

![image.png](https://www.roc.ovh/uploads/images/gallery/2025-05/scaled-1680-/fhhimage.png)

<span class="s1">We gaan leren hoe we goede prompt kunnen schrijven.</span>

<span class="s1">Voor een **goede prompt** moet je rekening houden met de volgende zaken:</span>

1. 1. <span class="s1"><span style="color: rgb(224, 62, 45);">**Context** </span>- een goede prompt heeft voldoende context.</span>
    2. <span class="s1"><span style="color: rgb(224, 62, 45);">**Details**/</span>**<span style="color: rgb(224, 62, 45);">Specifiek</span>** - een goed prompt heeft voldoende details en is zo specifiek mogelijk.</span>
    3. <span class="s1"><span style="color: rgb(224, 62, 45);">**Duidelijkheid** </span>- een goede prompt is duidelijk.</span>
    4. <span class="s1">**Doelgericht** - een goede prompt is doelgericht.</span>
    5. <span class="s1">**Vorm** - in een goede prompt kan je de output in een bepalade vorm vragen.</span>
    6. <span class="s1">**Toon** -door in de prompt de toon op te nemne, bepaal je de vorm van het antwoord.</span>

<span class="s1">Al deze punten worden stuk-voor-stuk behandeled. De eerste drie zijn **<span style="color: rgb(224, 62, 45);">rood </span>**omdat é*lke* prompt altijd moet voldoen aan deze kenmerken.</span>

<span class="s1">Maar laten we eerst even kiijk wat nu eigelijk *promting* precies is.</span>

#### <span class="s1">Wat is prompting?</span>

<span class="s1">**Prompting**</span> betekent dat je iets vraagt aan een AI, zoals ChatGPT, op een manier waardoor je een goed antwoord krijgt. Je *geeft een opdracht of stelt een vraag*, en dat noemen we een <span class="s1">**prompt**</span>.

Je kunt het vergelijken met hoe je een klasgenoot iets vraagt:

1. Als je gewoon zegt: “Doe dit,” snapt die ander misschien niet precies wat je bedoelt.
2. Maar als je zegt: “Kun je me helpen met deze code, want ik snap het niet?", is dat al een stukje beter.
3. Maar het kan nog beter: "Kun je me helpen met deze code want ik krijg een foutmelding 'unknown variable on line 23', ik snap niet wat de foutmelding betekent? '".
4. En zelfs dit kan nog beter want je vergeet een belangrijk detail, zie jij welke detail?

<span class="s1">**Kort gezegd:**</span> prompting is het slim stellen van een vraag of opdracht aan AI, zodat je krijgt wat je nodig hebt.

In de laatste zin staat niets over in welke omgeving en met welke programmeertaal je werkt. Ook zou je kunnen overwegen om de code of een stuk daarvan mee te sturen.

### **✍️** Opdracht 1

Weet jij welke verbetering je bij punt 4 nog kan toevoegen?

Pas de prompt zoals die bij 3 staat aan en en voeg één of meer details toe.

## 1. Context

We hebben geleerd dat een goede prompt detail en context heeft.

Context is een soort van "omgeving".

Als je vraagt om code aan passen dan moet je dus aangeven wat de "omgeving" is, in dit geval PHP en als het je bepaalde frameworks gebruikt of andere zaken die van belang zijn dan noem je die ook.

- <span class="s1">**Context**</span> betekent: de omgeving waarin iets zich afspeelt.
- Bij programmeren is dat bijvoorbeeld: de taal (zoals PHP), het framework (zoals Laravel), of iets anders dat belangrijk is om te weten. Bijvoorbeeld "ik ben een student softwaredeveloper en ik ken de basis van HTML", of "het doel van deze code is dat ik als software developer wil begrijpen hoe het werkt".
- Een AI snapt je vraag beter als jij eerst vertelt wat de <span class="s1">**omgeving/context**</span> is.

### **✍️** Opdracht 2

#### Situatie

Je hebt de volgende PHP-code gekregen.

Deze code toont de huidige datum:

```php
<?php
echo date("Y-m-d");
?>
```

Maar jij wil dat de datum verschijnt in het <span class="s1">**Nederlands**</span>, zoals: <span class="s2">9 mei 2025</span>

De AI moet je helpen om de code aan te passen.

### **📝** Jouw taak:

1. <span class="s1">**Schrijf een prompt aan ChatGPT**</span> waarin je vraagt om deze code aan te passen zodat de datum in het Nederlands verschijnt.
2. <span class="s1">Let erop dat je </span>**duidelijk aangeeft wat de context is**<span class="s1">:</span>
    
    
    - Je werkt met <span class="s1">**PHP**</span>
    - De code moet draaien op een gewone server (geen framework zoals Laravel)
    - <span class="s1">Je wil de </span>**datum in het Nederlands**

### Inleveren

1. Screenshot van de prompt en het antwoord dat je hebt gekregen.
2. Screenshot van het resultaat in je browser.

## 2. Detail/Specifiek

### Doel

Je leert hoe belangrijk <span class="s2">**detail en specificiteit**</span> zijn in een goede prompt. Hoe specifieker je bent, hoe beter de AI je kan helpen met het schrijven of verbeteren van PHP-code.

### **📚** Theorie

- Een vage prompt zoals *“Maak een contactformulier”* geeft een vaag resultaat.
    
    
    - Welke velden moeten erin?
    - Wat moet er met de ingevulde gegevens gebeuren?
    - Moet het formulier controle uitvoeren?
    - Moet er een succesbericht komen?
        
        Een <span class="s1">**specifieke prompt**</span> vertelt precies wat je wil.

Een goede prompt bevat concrete dingen en bevat geen (of zo min mogelijk) 'vage' [termen](https://www.roc.ovh/books/portfolio-kerntaak-examen/page/chatgpt-en-concreet).

#### Test je prompt

Als je over een prompt vragen kan stellen dan is die niet 100% concreet.

##### Voorbeeld prompt:

*Maak de bannder iets breder en verander het letter type zodat het groter is.*

**Wat is 'iets breder' en wat is 'groter'?**

##### Beter zou zijn:

*Maak de banner 5% breder en maak het font 2px groter.*

### **✍️** Opdracht 3

#### Situatie

Je wil een <span class="s2">**contactformulier in PHP**</span> laten maken door ChatGPT.

### Jouw taak

1. <span class="s1">**Schrijf een prompt aan ChatGPT**</span> waarin je duidelijk vraagt om een contactformulier in PHP.
    
    Je moet in je prompt minimaal deze 4 dingen <span class="s1">**specifiek vermelden**</span>:
    
    
    - Welke velden het formulier moet hebben (bv. naam, e-mail, bericht)
    - Wat er met de data moet gebeuren (bijv. opslaan, versturen, tonen)
    - Of er foutcontrole moet zijn (bijv. verplicht invullen, geldig e-mailadres)
    - Of er een succesmelding moet komen na het verzenden

### Inleveren

1. Screenshot van de prompt en het antwoord dat je hebt gekregen.
2. Screenshot van het resultaat in je browser.

## 3. Duidelijkheid

Duidelijk betekent dat je prompt voldoende detail bevat. Hierdoor is het duidelijk wat je precies bedoeld.

Een <span class="s1">**duidelijke prompt**</span> zegt precies:

1. *Wat* je wil
2. *Waarvoor* je het wil
3. Wat de beperkingen zijn
4. En eventueel *hoe* je het eruit wil laten zien

Een **voorbeeld** van de punten zijn:

1. Je wilt een website
2. Je wilt een website waarin de gebruiker zijn naam en adres moet opgeven.
3. Alle velden moeten op één web pagina passen en bestaat uit HTML en CSS.  
    De velden zijn allemaal verplicht. Zodra de submot button wordt ingedrukt wordt gecontroleerd of alle velden zijn ongevuld. Als dat niet het geval is dan volgt er een aanwijzing/waarschuwing.
4. Het moet er eenvoudig en professioneel uitzien, Gebruik 'Tailwind' als CSS framework.

### **📝** Opdracht 4

#### Situatie

Je wil een AI vragen om een klein interacteive pagina met JavaScript te maken waarmee je een getal controleert: is het <span class="s2">**even of oneven**</span>?

Hieronder zie je een voorbeeld van een <span class="s1">**vage prompt**</span>. Lees hem goed.

> “Schrijf iets in JavaScript dat met getallen werkt.”

Je gaat nu zelf een <span class="s1">**duidelijke prompt**</span> schrijven waarin je vraagt om een PHP-script dat:

- Alles komt in één HTML-bestand.
- Één getal controleert
- Zegt of het getal even of oneven is
- De gebruiker het getal zelf laat invoeren via een HTML-formulier
- Maak de styling. Geef zelf duidelijk aan hoe de pagina eruit moet zien (CSS).

### Inleveren

1. Screenshot van de prompt en het antwoord dat je hebt gekregen.
2. HTML-bestand

## 4. Doelgericht

#### **📚** Theorie

- AI is niet helderziend. Als je alleen zegt “Leg dit uit”, weet de AI niet hoe uitgebreid, voor wie of in welke vorm.
    
    
    - Wat wil je *precies* weten of krijgen?
    - Wil je code, uitleg, een stappenplan, een voorbeeld, een tabel, enz.?
    - Voor wie is het bedoeld? (Bijv. jezelf, een beginner, een klasgenoot?)
        
        Een <span class="s1">**doelgerichte prompt**</span> maakt duidelijk:

### 📝 Opdracht

#### Situatie

Je wil begrijpen hoe een <span class="s1">**while-loop**</span> werkt in PHP, en je wil dat de AI het aan je uitlegt.

#### Deel 1: Vergelijk twee prompts

Prompt A (niet doelgericht):

> “Wat is een while-loop?”

Prompt B (wel doelgericht):

> “Leg uit wat een while-loop in PHP doet. Geef een voorbeeld met code en uitleg in simpele taal, zodat ik het kan gebruiken in een quiz voor klasgenoten.”

🔍 Wat is het verschil tussen A en B?

Doelgericht is dus dat je in de prompt benoemd wat het uiteindelijke doel is; wat is het grotere plaatje? Maak je code voor een opdracht voor school, wil je code leren begrijpen, of zit je in een groot project voor ene belangrijke klant?

#### Deel 2: Schrijf je eigen doelgerichte prompt

Bedenk nu een onderwerp in PHP dat jij lastig vindt (bijvoorbeeld: arrays, forms, functies, POST vs GET…).

Schrijf een doelgerichte prompt waarbij je duidelijk maakt <span class="s1">**wat je wil, in welke vorm, en voor wie het bedoeld i**</span>

### Inleveren

1. Deel 1, leg in je eigen woorden uit wat het verschil is tussen prompt A en prompt B.
2. Deel 2, schrijf je eigen doelgerichte prompt (zie beschrijving deel 2).

## 5. Vorm

### **📚** Theorie (kort samengevat)

- Soms weet de AI wél wat je bedoelt, maar krijg je het antwoord in een <span class="s1">**onhandige vorm**</span>:
    
    
    - Alleen tekst terwijl jij voorbeeldcode wilde.
    - Een lang verhaal terwijl jij liever een stappenplan had.
    - Code zonder uitleg erbij.
- Daarom is het slim om in je prompt te zeggen <span class="s1">**hoe je het antwoord wil zien**</span>:
    
    
    - Als lijst, tabel, voorbeeldcode, uitleg in korte zinnen, enz.

### Opdracht

#### Deel 1: Slechte prompt (voorbeeld)

> “Leg uit hoe je een formulier maakt met PHP.”

Wat is hier onduidelijk over de <span class="s2">**vorm**</span> van het antwoord?

#### Deel 2: Schrijf zelf een betere prompt

Jij gaat nu een betere prompt schrijven waarin je <span class="s1">**duidelijk zegt in welke vorm**</span> je het antwoord wil krijgen. Kies een vorm, zoals:

- Stap-voor-stap uitleg
- PHP-code met uitleg onder elke regel
- Een tabel met onderdelen van een formulier
- Een combinatie van uitleg en voorbeeld

📌 Vergeet niet te vermelden dat je werkt met <span class="s1">**PHP**</span>, en dat het voor een <span class="s1">**beginner**</span> is.

### Inleveren

1. De uitleg (deel 1) en de prompt (deel 2) in een PDF.

## 6. Toon

### **📚** Theorie

- De <span class="s1">**toon**</span> is *hoe iets klinkt* of *overkomt*: serieus, grappig, formeel, simpel, kinderlijk, informeel, enz.
- Als je geen toon aangeeft, kiest de AI zelf. Soms is dat te zakelijk, te moeilijk of juist te speels.
- In een goede prompt zeg je dus <span class="s1">**hoe de AI zich moet gedragen**</span>.

### **📝** Opdracht

#### Situatie:

Je wil dat ChatGPT uitlegt wat een <span class="s2">**functie in PHP**</span> is.

Je gaat dezelfde uitleg in <span class="s2">**verschillende tonen**</span> laten geven.

### Stap 1: Schrijf drie verschillende prompts

Gebruik hetzelfde onderwerp (“Wat is een functie in PHP?”) en verander <span class="s2">**alleen de toon**</span>.

1. 🎩 <span class="s1">**Formeel en technisch**</span> (voor iemand met programmeerervaring):
2. 😄 <span class="s1">**Grappig en speels**</span> (alsof je het uitlegt aan een kind van 12):
3. 💬 <span class="s1">**Duidelijk en vriendelijk**</span> (voor een klasgenoot die net begint met PHP):

### Inleveren

1. Welke toon vond jij het <span class="s1">**meest duidelijk**</span> voor een beginner?
2. Welke toon past het best bij jouw klasgroep?
3. Wat gebeurt er als je géén toon vraagt in je prompt?

## 7. Samengevat

### Een goede prompt.

1. <span class="s1">**Context**</span> – Geef achtergrondinformatie, zoals *voor wie* het is, *wat het doel is*, of *waar het over moet gaan (welke programmeertaal?)*.
2. <span class="s1">**Detail**</span> – Hoe specifieker je bent, hoe beter het antwoord past bij wat je zoekt.
3. <span class="s1">**Duidelijkheid**</span> – Gebruik duidelijke en begrijpelijke taal. Vermijd vage of dubbelzinnige zinnen.
4. <span class="s1">**Doelgerichtheid**</span> – Geef aan *wat je precies wil* (bijvoorbeeld: een uitleg, een lijst, een verhaaltje, een vergelijking, enz.).
5. <span class="s1">**Vorm**</span> – Soms helpt het als je zegt *hoe* het antwoord eruit moet zien (bijvoorbeeld: “maak er een tabel van”, “gebruik korte zinnen”, “schrijf het op het niveau van een brugklasser”).
6. <span class="s1">**Toon/Stem**</span> – Wil je dat het grappig is? Serieus? Zakelijk? Kinderlijk? Dat kun je ook zeggen in je prompt.

#### **Voorbeeld prompt**

> “Leg uit wat een <span class="s2">if</span>-statement is in PHP. Geef een simpel voorbeeld met uitleg in makkelijke taal. Ik ben 14 en net begonnen met PHP, dus graag zonder moeilijke woorden. Laat ook zien wat er gebeurt als de voorwaarde niet waar is.”

### Opdracht 3

Maak een prompt waarin je aan AI vraagt om een programma in HTML-pagina te maken die er zo goed mogelijk lijkt op deze website template.

![image.png](https://www.roc.ovh/uploads/images/gallery/2025-05/scaled-1680-/image.png)

Probeer dit in één tekst prompt te doen (gebruik dus géén plaatje) en denk aan alle 6 eigenschappen voor een goede prompt.

### Inleveren

1. Prompt die je hebt gemaakt (schermafdruk).
2. Resultaat (schermafdruk van de webpage).

## 8. Challenge: energiedashboard

### Introductie

In deze challenge ga je een complete webpagina laten bouwen met behulp van een AI-assistent. Je krijgt \*\*geen kant-en-klare prompt\*\*. In plaats daarvan krijg je dezelfde soort informatie die je later ook van een klant kunt ontvangen: een verhaal, een paar schetsen en een lijst met technische en veiligheidseisen.

Jouw eerste taak is daarom niet programmeren, maar \*\*de vraag van de klant vertalen naar een goede prompt\*\*.

#### Een goede prompt bevat de zes onderdelen uit deze les:

1. **Context** – In welke omgeving wordt de pagina gebruikt?
2. **Detail/specifiek** – Welke onderdelen en functies zijn nodig?
3. **Duidelijkheid** – Kan de AI de opdracht maar op één manier begrijpen?
4. **Doelgerichtheid** – Wat moet het eindresultaat bereiken?
5. **Vorm** – In welke vorm moet de AI het antwoord opleveren?
6. **Toon/stem** – Welke uitstraling en schrijfstijl moet de pagina hebben?

<p class="callout info">Let op: de klantomschrijving is expres niet technisch en niet overal even concreet. Het is jouw taak om de belangrijke informatie eruit te halen en vage woorden om te zetten in controleerbare eisen.</p>

### Situatie

Een fictief energiebedrijf wil een demonstratiepagina voor studenten. De pagina gebruikt twee API-endpoints: één met elektriciteitsprijzen en één met elektriciteitsverbruik. De gegevens verschillen per studentnummer.

De bezoeker moet een studentnummer invullen en daarna een duidelijk overzicht krijgen van een volledige zomerweek.

### 💬 Bericht van de klant

<table border="1" id="bkmrk-hoi%21-voor-ons-nieuwe" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td style="border-color: rgb(52, 73, 94); border-style: solid;">*Hoi! Voor ons nieuwe energieconcept zoeken we een pagina die meteen professioneel en een beetje vernieuwend aanvoelt. Niet zo'n standaard schoolopdracht met alleen een formulier en een kale tabel. Het moet meer voelen als iets dat een modern energiebedrijf echt aan klanten zou kunnen laten zien.*  
  
*Een student moet ergens zijn studentnummer kunnen invullen. Daarna willen we in één oogopslag zien wat er die week met de energieprijzen en het verbruik gebeurt. Vooral de goedkope uren zijn interessant. Soms is stroom midden op de dag zelfs gratis of negatief geprijsd; dat mag best opvallen.*  
  
*Ik houd van een stevige, zakelijke uitstraling, maar het mag ook energiek en eigenwijs zijn. Denk aan duidelijke cijfers, grafieken en een slimme conclusie. De gebruiker moet niet hoeven zoeken naar wat belangrijk is. Op een telefoon moet het trouwens ook gewoon prettig werken.*  
  
*Het zou fijn zijn als iemand de onderliggende uurgegevens nog kan bekijken. Misschien kunnen die gegevens ook worden gedownload. Als er iets misgaat met het studentnummer of de verbinding, wil ik geen technisch foutbericht waar niemand iets van begrijpt.*  
  
*Kunnen jullie hier iets moois en bruikbaars van maken?*

</td></tr></tbody></table>

### 🔌 Beschikbare databronnen

Gebruik voor beide requests hetzelfde studentnummer. Vervang `123456` door het nummer dat de gebruiker invoert.

<table border="1" id="bkmrk-elektriciteitsprijze" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 30.4167%;"></col><col style="width: 69.7025%;"></col></colgroup><tbody><tr><td>Elektriciteitsprijzen per uur</td><td>thtps://blok4-mod2-pe1.qool.ovh/energieprijzen.php?studentnummer=123456</td></tr><tr><td>Elektriciteitsverbruik per uur</td><td>https://blok4-mod2-pe1.qool.ovh/verbruik.php?studentnummer=123456</td></tr></tbody></table>

Beide endpoints leveren JSON met 168 uurmetingen voor dezelfde zomerweek. De datasets kunnen via het veld `tijdstip` aan elkaar worden gekoppeld.

### 🖼️ Schets 1: opbouw op desktop

![image.png](https://www.roc.ovh/uploads/images/gallery/2026-11/scaled-1680-/image.png)

Op een klein scherm staan de onderdelen onder elkaar. Grafieken, tabellen, formulieren en knoppen blijven leesbaar en bruikbaar zonder horizontaal door de hele pagina te hoeven schuiven.

### ⚙️ Technische eisen

Je eindresultaat moet aan alle onderstaande eisen voldoen:

1. De complete front-end staat in \*\*één HTML-bestand\*\*.
2. Gebruik voor beide API-calls exact jouw studentnummer.
3. Toon een begrijpelijke foutmelding wanneer invoer ongeldig is of een API request mislukt.
4. Combineer prijs en verbruik op basis van het veld `tijdstip`.
5. Toon minimaal: 
    1. totale geschatte kosten van de week;
    2. totaal verbruik van de week;
    3. de laagste uurprijs met datum en tijd;
    4. het aantal uren met een negatieve prijs;
    5. een grafiek van de uurprijzen;
    6. een grafiek van het uurverbruik;
    7. een overzicht per dag;
    8. een tabel met de gecombineerde uurwaarden.
6. Bereken de kosten per uur met `prijs × verbruik` en tel deze waarden op voor het weektotaal.
7. De pagina heeft een zelfbedachte naam en een herkenbare, fictieve corporate huisstijl.
8. De pagina werkt bruikbaar op desktop, tablet en mobiel.

### 📝 Jouw taak

#### Deel 1 – Analyseer de klantvraag

Lees de klantomschrijving, de schetsen en alle eisen. Noteer voor jezelf:

- wat het doel van de pagina is;
- wie de gebruiker is;
- welke gegevens binnenkomen;
- welke onderdelen zichtbaar moeten zijn;
- welk gedrag en welke foutafhandeling nodig zijn;
- welke technische en veiligheidseisen niet mogen ontbreken.

#### Deel 2 – Schrijf één complete prompt

Schrijf één prompt waarmee een AI-assistent de volledige pagina kan maken. De AI mag de schetsen niet nodig hebben: beschrijf de belangrijke informatie uit de schetsen daarom ook in woorden.

#### Deel 3 – Genereer en test de pagina

1. Geef jouw prompt aan een AI-assistent.
2. Sla het resultaat op als HTML-bestand.
3. Test de invoer, beide API-calls, berekeningen, grafieken, tabel, download en responsive weergave.
4. Verbeter eerst je \*\*prompt\*\* wanneer het resultaat niet aan de opdracht voldoet. Houd bij wat je hebt aangepast.

### 📦 Inleveren

Lever de volgende drie onderdelen in:

1. Jouw definitieve prompt (TXT)  
    De volledige tekstprompt die je hebt gebruikt om de pagina te genereren.
2. Een screenshot van het resultaat\*\*   
    Zorg dat op de screenshot minimaal het studentnummer, de belangrijkste kengetallen en de grafieken zichtbaar zijn.
3. Een testverslag (PDF)  
    Leg in je eigen woorden uit hoe je hebt gecontroleerd dat de pagina en code goed werken.  
    Het testraport bevat **minimaal 5 testen waaronder**: 
    1. Hoe heb je getest wat er gebeurt als het API endpoint het niet doet?
    2. Hoe heb je getest dat de grafieken juist zijn?
    3. Wlek andere cijfers/berekningen heb je getest en hoe heb je dat gedaan? Geef concrete testgevallen met cijfers en berekening.

### Beoordelingscriteria

Je werk wordt beoordeeld op de volgende punten:

1. De prompt bevat alle zes kenmerken van een goede prompt uit deze les.
2. Het getoonde resultaat gebruikt beide API’s en bevat de verplichte onderdelen.
3. Het screenshot maakt het eindresultaat goed controleerbaar.
4. Het testverslag bevat minimaal 5 concrete tests die herhaalbaar zijn
5. Je kunt uitleggen welke keuzes je zelf hebt gemaakt en welke onderdelen door AI zijn gegenereerd.

<p class="callout info">Belangrijk: een mooie pagina met een onduidelijke prompt is niet voldoende. In deze challenge wordt vooral beoordeeld of jij een **professionele prompt** kunt schrijven en het resultaat kritisch kunt **testen**.</p>