Hoe je een artikel schrijft dat AI kan gebruiken

Benodigde licentie

Abonnement Suite Team of hoger, Knowledge Professional of hoger
Toegang Agent

Zeven gewoonten die een artikel bruikbaar maken voor een AI-agent, en die het stuk voor stuk ook beter maken voor mensen.

1. Eén vraag per artikel

De belangrijkste. Een artikel dat één ding beantwoordt kun je citeren; een dat er vijf beantwoordt wordt samengevat tot vaagheid.

2. Antwoord in de eerste alinea

Leg daarna uit. De opening telt dubbel: zoekmachines bouwen de beschrijving van het artikel uit de eerste 140 tekens, en op dat fragment beslist een lezer. Een artikel dat opent met drie alinea's context toont context waar het antwoord hoort te staan.

3. Titel het als de vraag

"Waarom kan ik me niet aanmelden?" in plaats van "Problemen met authenticatie oplossen". Het helpt bij het matchen, en het vertelt de AI waar het artikel voor is.

4. Zeg de voorwaarden hardop

Geldt iets alleen op een bepaald abonnement, of alleen voor zakelijke klanten, schrijf dat dan in het artikel. Een AI kan het niet afleiden, en hij vertelt een klant vrolijk dat hij iets kan wat hij niet kan.

5. Gebruik echte structuur, in de artikeltekst

Koppen, genummerde stappen, lijsten. Structuur is betekenis, en zowel een schermlezer als een AI gebruikt hem om uit te maken wat bij elkaar hoort.

Het moet in de tekst staan. Generatieve antwoorden en generatief zoeken kunnen bijlagen bij je artikelen niet lezen, dus een procedure die in een bijgevoegde pdf staat is voor hen onzichtbaar, en dat geldt ook voor alles wat alleen in een video wordt uitgelegd. De oplossing is de voor de hand liggende: zet de inhoud van die bijlage in het artikel. Webcrawlers lezen daarentegen wel wat in de paginabron staat, ook als een element als een accordion het verbergt, dus die twee gedragen zich verschillend, en waar je op leunt verandert de uitkomst.

6. Haal tegenstrijdigheden weg

Twee artikelen die het oneens zijn is erger dan één die ontbreekt. Vind ze door je AI-agent de vragen te stellen waarop hij wisselende antwoorden geeft.

7. Let op wat de agent mag lezen

Goed schrijven is niet genoeg als het artikel buiten bereik ligt. Een AI-agent antwoordt uit de kennisbronnen die eraan hangen, en bij een aangemelde klant kunnen daar beperkte artikelen bij zitten, terwijl een bezoeker alleen openbare krijgt. Hetzelfde artikel kan dus voor de een bruikbaar zijn en voor de ander afwezig.

Meer bronnen is ook niet de oplossing. Zendesk formuleert het voorzichtig: te veel bronnen kunnen in sommige gevallen de nauwkeurigheid verlagen en de vertraging verhogen, en het advies is het aantal binnen een redelijke grens te houden zonder die grens te noemen. Dit is dus een afweging die je bewust maakt, geen drempel waar je onder blijft.

Wat je niet doet

Schrijf niet voor de AI. Artikelen volgestopt met formuleringen, of geschreven in stroeve taal om machinevriendelijk te zijn, lezen slecht voor mensen en zijn ook voor AI niet beter.

Schrijf helder voor iemand met een probleem. Dat is wat werkt.

Zie ook

Was dit artikel nuttig?

0

Kom je er niet uit?

Ons supportteam kijkt met je mee.

Opmerkingen

0 opmerkingen

Artikel is gesloten voor opmerkingen.