Prompts schrijven voor AI-assistenten

Volgende stappen

Aan de hand van deze richtlijnen kun je beginnen met het schrijven van effectieve prompts om optimaal gebruik te maken van een AI-assistent. Probeer ze eens uit, en ervaar hoe een AI-assistent je workflow kan verbeteren.

Klik hier voor het bron-artikel

Richtlijnen voor het schrijven van prompts

Zorg ervoor dat je prompt je doelstelling duidelijk maakt, de benodigde context bevat, en de gewenste weergave van de tekst beschrijft. Houd rekening met de volgende richtlijnen als je met een AI-assistent communiceert:

De originele prompt: Maak een plattegrond met daarop het aantal kleuters in Noord-Holland.
Eerste iteratie: Maak een plattegrond met daarop het aantal kinderen in Noord-Holland jonger dan 4 jaar oud.
Tweede iteratie: Maak een plattegrond met een groen kleurverloop die het aantal kinderen onder de 4 jaar in Noord-Holland weergeeft.
Voeg zo nodig nog meer iteraties toe.

De originele prompt gaf een ongewenst resultaat omdat er een slecht gedefinieerd concept in werd gebruikt: kleuters. Als het resultaat niet is wat je verwachtte, herschrijf de prompt dan en voeg er meer details en context aan toe. Zo herhaalt de eerste iteratie de originele prompt, met extra informatie over de leeftijd. Om het resultaat verder toe te spitsen benoemt de tweede iteratie een kleurverloop voor de plattegrond. Onthoud dus dat je eerste prompt niet altijd succesvol zal zijn; om betere resultaten te krijgen kun je je prompts aanscherpen.

Sommige assistenten, zoals de Business Analyst assistent (preview), kunnen gesprekken voeren en het gehele verloop daarvan onthouden. Als je met een conversational of gespreksmatige AI-assistent communiceert hoef je eerdere prompts of iteraties niet volledig te herschrijven. Zo kan de tweede iteratie van de voorbeeldprompt worden ingekort tot 'Verander het kleurverloop naar groen'.

Als je met een assistent communiceert is het slim om een prompt te schrijven en het resultaat daarvan te evalueren. Vervolgens herschrijf je de prompt om een beter resultaat te krijgen. Je moet misschien met een paar iteraties van een prompt experimenteren voor het gewenste resultaat. Zoals in het volgende voorbeeld.

Scherp je resultaten aan met iteratief prompten

Leg uit wat ArcGIS Instant Apps is aan iemand met minimale kennis van GIS. Gebruik eenvoudige taal. Gebruik maximaal 100 woorden.

Wat is ArcGIS Instant Apps?

Deze prompt geeft niet aan wat de behoeften zijn van de doelgroep, zoals hun leesvaardigheid of de lengte van de resulterende tekst. In dit geval weet de assistent niet dat de beoogde ontvanger onbekend is met GIS, en die dus vereenvoudigde taal en definities voor vaktermen nodig heeft. Als je niet toelicht wie de doelgroep is, zou de assistent je een veel te technisch en complex resultaat kunnen geven. Dit zou een betere prompt zijn:

Je zult relevantere resultaten zien als je informatie over de doelgroep meegeeft zoals hun leeftijd, leesvaardigheid of voorkeurstalen. Bekijk de volgende prompt voor documentatie-assistent (beta).

Maak duidelijk wie je doelgroep is

Vergelijk samenwerking met partners ten opzichte van gedistribueerde samenwerking in maximaal 50 woorden. Geef de resultaten weer als een lijst met opsommingstekens.

Vergelijk samenwerking met partners ten opzichte van gedistribueerde samenwerking.

Het is duidelijk dat de prompt een taak beschrijft, maar de gewenste soort weergave van de informatie is niet omschreven. Het is voor de assistent onduidelijk of de resulterende informatie in de vorm van een lijst, paragraaf, grafiek, tabel of anderzijds moet worden weergeven. Dit zou een betere prompt zijn:

Maak de assistent duidelijk hoe je wil dat de resultaten worden weergeven: omschrijf restricties zoals het aantal woorden en gewenste tekstopmaak. Bekijk de volgende prompt voor documentatie-assistent (beta).

Beschrijf de gewenste weergave

Maak een enquête waarmee deelnemers feedback kunnen geven op de Marathon van Rotterdam. Zet hier vragen in over communicatie voorafgaand aan de loop, veiligheid tijdens de loop, helderheid van de routemarkering, locaties van de waterpunten, snacks na de loop, parkeren, en algemene tevredenheid.

Stel een enquête op voor het geven van feedback op een evenement.

Deze prompt benoemt geen type evenement, en daarom kan de assistent alleen algemene vragen schrijven die over allerlei evenementen zouden kunnen gaan. Goed afgestemde vragen zullen waardevollere resultaten opleveren, zoals vragen over de geluidskwaliteit van een openluchtconcert, maar hebben daar wel extra context en details voor nodig. Belangrijke enquêtevragen of onderwerpen worden niet benoemd in deze prompt, waardoor essentiële informatie mogelijk niet verzameld kan worden. Onthoud dat de beste resultaten alleen mogelijk zijn met de juiste hoeveelheid informatie. Dit zou een betere prompt zijn:

Om te voorkomen dat je een nietszeggend, middelmatig antwoord krijgt is het belangrijk om voldoende details in de omschrijving van de opdracht te zetten. Bijvoorbeeld bij deze prompt voor Survey123-assistent (preview).

Wees specifiek

Maak een HTML-tabel die burgerlijke staat laat zien. Zet in de eerste kolom de burgerlijke staat, en in de tweede het aantal mensen in elke categorie. Gebruik komma's voor de opmaak van getallen. Geef de rij met het hoogste aantal een oranje kleur.

Vat burgerlijke staat samen in een soort tabel of grafiek die er overzichtelijk uitziet.

Deze prompt is onduidelijk, omdat de opmaak van de tekst aan de interpretatie van de assistent wordt overgelaten. Je kunt beter direct vragen om het gewenste resultaat. Als je het soort tabel of grafiek niet omschrijft, zoals een HTML-tabel of staafdiagram, zou het kunnen dat de assistent het verkeerd interpreteert. Dit zou een betere prompt zijn:

Geef duidelijk aan wat je van de assistent vraagt, en vermijd vaag taalgebruik. Kijk bijvoorbeeld naar de volgende prompt voor Arcade-assistent (beta).

Gebruik duidelijke, simpele taal

Op zoek naar ons oorlogverleden
met Topotijdreis

Bekijk het in Topotijdreis

Bij een onderzoek naar een neergestort vliegtuig in Gemert bleek in Topotijdreis dat de plaatsaanduiding van Het Broek gedurende de jaren veranderd is. In 1942 beslaat Het Broek een groter gebied dan in 2023. Wanneer we op de huidige kaart naar deze locatie zoeken staat Het Broek aangegeven ten zuiden van de Peeldijk/de Biezen. Wanneer we naar 1943 kijken, dan zien we dat Het Broek destijds ook ten noorden van de Peeldijk stond aangegeven; een gebied dat tegenwoordig de Biezen heet.

Advies over ontplofbare oorlogsresten
Adviesbureau Bombs Away doet onderzoek naar overblijfselen van de Tweede Wereldoorlog op specifieke locaties. Via diverse bronnen verzamelen ze gegevens over die locatie om erachter te komen wat zich daar in de oorlog heeft afgespeeld. Op basis daarvan geven ze diverse opdrachtgevers, van overheden tot ingenieursbureaus, advies over het risico dat er ontplofbare oorlogsresten in de bodem zitten. Jesse Gruijters, projectleider GIS bij Bombs Away, vertelt hoe ze in dit onderzoek te werk gaan. “We gebruiken enorm veel bronnen om een zo duidelijk mogelijk beeld te krijgen. Onze historici duiken de archieven in naar bruikbare documenten, denk aan schademeldingen in het gemeentearchief, maar ook dagboeken van militaire eenheden.”

“In veel van dit archiefmateriaal zit een geografisch component: een adres, plaatsnaam of coördinaat. Op basis van die gegevens gaan we op zoek naar kaarten en foto’s. We gebruiken vaak luchtfoto’s uit die jaren om te kijken of hetgeen dat uit de archieven naar voren komt echt daar is gebeurd. Hierop zien we of een bombardement daadwerkelijk een gebouw heeft getroffen: zien we bomkraters of eventuele punten waar een blindganger (onontploft explosief) kan zitten?”

Topotijdreis als spiekbriefje
“Bij die vertaalslag van al die historische gebeurtenissen naar geografische data gebruiken we Topotijdreis. Nederland is in de afgelopen 75 jaar natuurlijk sterk veranderd. Als je naar recente kaarten kijkt dan vind je veel plaatsaanduidingen die in de archieven staan niet meer terug. Vaak worden er zaken omschreven - een kapelletje, een bos of een akker met een bepaalde naam – op plekken waar zich tegenwoordig een bedrijventerrein bevindt. Dan gebruiken we Topotijdreis als een soort spiekbriefje om te kijken waar bepaalde locaties zich nu daadwerkelijk bevinden. Ook gebruiken we Topotijdreis om oude luchtfoto’s te kunnen lokaliseren. Op plekken waar ten tijde van de oorlog polder was liggen nu soms complete steden. Zeker nu sinds vorig jaar de vergelijkfunctie is toegevoegd aan Topotijdreis is deze tool voor ons heel handig om locaties te vinden.”

1942

Schatgraven
met
Topotijdreis

Bekijk het in Topotijdreis

De vindplaats van de munten in Twente bevindt zich op het oorspronkelijk kruispunt van wegen, zichtbaar op de kaart van 1867. Dit kruispunt werdt ontdekt door de discrepantie tussen de Topografische Militaire Kaart van 1867 en de eerste uitgave van de chromotopografische kaart (Bonneblad 1910). De wegen zijn dus verlegd ergens in het begin van de twintigste eeuw, toen het gebied ontgonnen werd.

Topotijdreis toont recente verstoringen van locaties
Jan-Willem de Kort is archeoloog bij de Rijksdienst voor Cultureel Erfgoed. “Topotijdreis wordt door archeologen ontzettend veel gebruikt. Onze afdeling gebruikt Topotijdreis vooral in de voorbereidende fase van archeologisch onderzoek, om een beeld te krijgen van de plek waar we onderzoek gaan doen. Topotijdreis vertelt ons vooral veel over recente verstoringen van een locatie: veranderingen van het landschap in de afgelopen 200 jaar. Daarbij zien we hoe het terrein in die periode gebruikt is: daar heeft een boom gestaan, hier heeft een weg overheen gelopen. Daarmee kunnen wij een inschatting maken van wat we kunnen verwachten. Soms geeft Topotijdreis zelfs verklaringen voor sporen die we aantreffen. Die kunnen we dan weer herleiden tot de historische kaart.”

Historische context muntenschat aangetoond
“Een leuk voorbeeld is een vondst die in 2019 is gedaan in Twente. Twee hobbyisten hadden, met toestemming van de grondeigenaar, met metaaldetectors kleine gouden munten uit de vroege middeleeuwen gevonden. Naar aanleiding van die vondst zijn wij onderzoek gaan doen in dat gebied. De muntjes lagen in twee concentraties in een akker die door Staatsbosbeheer werd omgezet in natuur. Bij de muntjes vonden we sporen van palenrijen. Toen we Topotijdreis erbij pakten zagen we dat op de locatie van de vondst honderd jaar geleden een kruispunt van wegen lag, midden op de heide. Toen we deze kaart over ons eigen archeologisch informatiesysteem legden ontdekten we dat er grafheuvels zich langs die wegen van het kruispunt bevonden. Het ging hier dus blijkbaar om eeuwenoude routes die al in de vroege middeleeuwen van betekenis waren en waarnaast de palenrijen zijn opgericht. Uiteindelijk hebben we in het onderzoek geïnterpreteerd dat op deze plek een offerplaats was in die tijd. In dat hele proces vanaf de vondst tot de resultaten van het onderzoek heeft Topotijdreis dus echt bijgedragen aan deze interpretatie.”

1910

1867

Tekst: Emma Fazekas en Leann Kurias. Beeld: Freepik

abonneer hier

Nooit meer een editie van

het Esri Magazine missen?

Bij het schrijven van instructies voor een AI-tool, zoals een ArcGIS AI-assistent, is het belangrijk om helder en duidelijk zijn. Instructies aan AI-tools worden prompts genoemd. Door middel van prompts kun je de tool dingen laten doen zoals vragen beantwoorden, samenvattingen schrijven, tekst genereren, of helpen bij het uitvoeren van een taak. De manier waarop de prompt is geschreven heeft enorme invloed op de kwaliteit van de reactie, dus als je goede prompts leert schrijven, zul je betere resultaten behalen. In dit artikel staan niet alleen richtlijnen voor het schrijven van goede prompts, maar ook praktische voorbeelden om je op weg te helpen met het gebruik van ArcGIS AI-assistenten.

Meer informatie

Meer weten over de mogelijkheden van AI-assistenten in ArcGIS? Ga naar de pagina AI-assistenten configureren om een assistent te kiezen die je aanspreekt en aan de slag te gaan.

CONTACT

Prompts schrijven voor AI-assistenten