ID.nl logo
Zo maak je een wifi-punt van je Raspberry Pi
© Reshift Digital
Huis

Zo maak je een wifi-punt van je Raspberry Pi

Als je op zolder of in de tuin wifi nodig hebt en toevallig nog een Raspberry Pi hebt liggen, hoef je geen draadloos toegangspunt meer te kopen: je maakt dit gewoon zelf. Je installeert gewoon de software RaspAP op je Raspberry Pi en configureert het daarna eenvoudig via de ingebouwde webinterface. RaspAP is ook te combineren met een adblocker, vpn-server, Tor of een captive portal.

01 Raspberry Pi met wifi

Als je een Raspberry Pi over hebt, kun je daarmee een draadloos netwerk opzetten waarop je kunt verbinden. Daarbij maakt het niet zoveel uit over welk model van de Pi het gaat, al behaalt het nieuwste model, de Raspberry Pi 4, wel de hoogste prestaties. Je hebt uiteraard een wifi-chip nodig, dus je gebruikt of minimaal een Raspberry Pi 3 ofwel een ouder model dat je via een van de usb-poorten uitbreidt met een wifi-adapter zoals de Edimax EW-7811Un. Voor de eenvoud veronderstellen we dat je de Pi op je thuisnetwerk aansluit via een ethernetkabel.

©PXimport

02 Raspbian installeren

Daarna dien je Raspbian Buster Lite op je Pi te installeren.. Kort samengevat: download Raspbian Buster Lite, schrijf het image met balenaEtcher naar een micro-sd-kaart, schakel ssh in, start de Pi op en log met een ssh-client op je Pi in via het netwerk. Wijzig daarna het standaardwachtwoord en update alle pakketten. Daarna is je Pi klaar om er een draadloos toegangspunt van te maken.

©PXimport

Wifi-prestaties van de Pi

Er zijn belangrijke verschillen in wifi-prestaties tussen de verschillende Pi-modellen. De Raspberry Pi Zero W(H) en Raspberry Pi 3 ondersteunen 802.11n in de 2,4 GHz-band. Uit benchmarks van de Raspberry Pi Foundation blijkt dat die eerste een doorvoersnelheid van 25 Mbit/s haalt en die tweede 50 Mbit/s. De Raspberry Pi 3B+, 3A+ en 4B ondersteunen 802.11 b/g/n/ac, zowel in de 2,4GHz- als in de 5GHz-band. In die eerste band ligt de doorvoersnelheid van die modellen rond de 60 Mbit/s en in die tweede rond de 100 Mbit/s, met een uitschieter voor de Raspberry Pi 4B naar 114 Mbit/s.

©PXimport

03 Extra configuratie

Start in de terminal het configuratieprogramma van Raspbian met de opdracht sudo raspi-config, ga met de pijltjestoetsen naar 4 Localisation Options en druk op Enter. Kies daarna I4 Change Wi-fi Country en bevestig dan je land. Als je wilt dat de webinterface van RaspAP automatisch de taal van je webbrowser herkent als die op Nederlands ingesteld is, open je ook I1 Change Locale en vink je met de spatiebalk de utf-8-versie van je taal aan in de lijst, bijvoorbeeld nl_NL.UTF-8 voor Nederlands. Ga daarna met de tabtoets naar Ok en bevestig met Enter. De standaardtaal mag je in de volgende stap op en_GB.UTF-8 laten staan. Verlaat het programma tot slot met Finish.

©PXimport

04 RaspAP installeren

Download eerst het installatieprogramma van RaspAP met de opdracht wget -q https://git.io/voEUQ -O /tmp/raspap en voer het programma dan uit met bash /tmp/raspap. Bevestig met y en een druk op Enter dat je RaspAP wilt installeren. Je krijgt daarna te zien welke pakketten er geïnstalleerd worden: bevestig weer met y en Enter. Na de installatie krijg je nog enkele vragen over de configuratie: bevestig telkens met Enter om de aangeraden configuratie te kiezen. Helemaal op het einde krijg je de vraag om je Pi te herstarten: kies y en Enter om dat te doen.

©PXimport

05 Webinterface

Vanaf nu heb je de opdrachtregel niet meer nodig. Na de herstart is je draadloze toegangspunt actief met raspi-webgui als ssid en ChangeMe als wachtwoord. Verbind met dit draadloze netwerk: je krijgt dan een ip-adres toegekend en toegang tot internet via de ethernetinterface van de Pi. Bezoek dan het ip-adres 10.3.141.1 in je webbrowser. Log in op de webinterface met admin als gebruikersnaam en secret als wachtwoord. Je krijgt nu het dashboard te zien met wat statistieken over het toegangspunt, waaronder een lijst met verbonden toestellen met hun ip-adres en mac-adres.

©PXimport

06 Taal instellen

Als je taal onverwacht niet in het Nederlands staat, klik dan links op System en dan op het tabblad Language. Daar kun je handmatig je taal instellen. Sla je wijziging op en herlaad de pagina. Eventueel dien je je Pi te herstarten (dat kan in het tabblad System). Krijg je dan nog de interface in het Engels te zien, kijk dan na of je in stap 3 wel echt nl_NL.UTF-8 als taal hebt toegevoegd: zo merkten we dat RaspAP de taal nl_BE.UTF-8 niet als Nederlands herkende. Als je dit opgelost hebt, zie je alles in het Nederlands staan.

©PXimport

07 Hotspotinstellingen

Bekijk eerst de hotspotinstellingen. Klik daarvoor links op Configureer hotspot. In het eerste tabblad kun je het ssid, de draadloze modus en het kanaal veranderen (zie ook het kader ‘Welk wifi-kanaal kiezen?’). Kijk ook in het tabblad Geavanceerd na of de landcode daar wel correct staat. In het tabblad Beveiliging is er doorgaans geen reden om de standaardkeuzes WPA en TKIP te aanvaarden: kies voor de veiligere opties WPA2 en CCMP. Verander ook het wachtwoord ChangeMe. Sla je instellingen op en herstart daarna je Pi of klik (als je de webinterface niet via het wifi-netwerk van RaspAP bezoekt) op Stop hotspot en daarna Start hotspot.

©PXimport

08 Wachtwoord veranderen

Naast het wachtwoord voor je ssid dien je ook nog het wachtwoord voor de webinterface van RaspAP te veranderen. Dat doe je in Configureer authenticatie. Eventueel kun je ook de standaard gebruikersnaam admin veranderen. Maar het belangrijkste is dat je het standaardwachtwoord secret (dat je bij Oud wachtwoord invult) vervangt door een veiliger wachtwoord. Vul je nieuwe wachtwoord twee keer in en klik op Instellingen opslaan. Daarna vraagt de webinterface het nieuwe wachtwoord. Het is belangrijk dat zowel het ssid-wachtwoord als het wachtwoord van je webinterface sterk genoeg zijn, zodat onbevoegden geen toegang tot je netwerk en de configuratie van je hotspot hebben.

©PXimport

Welk wifi-kanaal kiezen?

Welk wifi-kanaal je voor RaspAP instelt, hangt voornamelijk af van welke kanalen er in je buurt al in gebruik zijn. Als meerdere draadloze netwerken van hetzelfde kanaal gebruikmaken, dan gaat dit vaak ten koste van de verbindingssnelheid. Op de 2,4GHz-band overlappen die kanalen bovendien, wat het nog problematischer maakt. De eerste stap is dus om te bekijken welke kanalen er al in gebruik zijn. Dat kan onder Android met een app zoals Wifi Analyzer, waarin je ook mooi de overlapping van de kanalen te zien krijgt. Kies voor RaspAP een kanaal dat zo min mogelijk overlapt met de andere netwerken.

09 Verbindingsproblemen oplossen

Als het je niet lukt om op je wifi-toegangspunt te verbinden, ga dan naar Configureer hotspot / Geavanceerd en schakel de optie Logboek uitvoer in. Klik op Instellingen opslaan en herstart de hotspot met Stop hotspot en daarna Start hotspot. Daarna krijg je in het tabblad Logfile logs te zien die je op de oorzaak van je problemen kunnen wijzen. Zoek voor een oplossing naar de foutmelding die je te zien krijgt in Google of op de GitHub-pagina van RaspAP.

©PXimport

10 Dhcp-server instellen

RaspAP draait een dhcp-server op de draadloze interface, die je via het menu Configureer DHCP server kunt instellen. Standaard deelt die ip-adressen uit van 10.3.141.50 tot 10.3.141.255, maar dat kun je veranderen. In het tabblad Clienten lijst krijg je te zien welke dhpc-leases geconfigureerd zijn. In Static Leases configureer je vaste ip-adressen. Je vult dan het mac-adres van een apparaat in en het ip-adres dat het toegekend moet krijgen. Klik daarna op Voeg toe en dan Instellingen opslaan. Dat is vooral handig als je op een van de via wifi aangesloten apparaten een server wilt draaien of met een firewall op basis van het ip-adres specifiek netwerkverkeer al dan niet wilt toestaan.

©PXimport

11 Draadloos in plaats van ethernet

Je kunt met RaspAP ook een draadloos toegangspunt opzetten op een plaats waar je geen ethernetaansluiting hebt. Je dient dan een tweede wifi-interface via usb aan te sluiten op je Raspberry Pi, die je dan in plaats van een ethernetkabel gebruikt om met je router te verbinden. Open eerst het configuratiebestand van RaspAP met sudo nano /var/www/html/includes/config.php en verander in de regel define('RASPI_WIFI_CLIENT_INTERFACE', 'wlan0'); wlan0 door wlan1. Sla je wijziging op met Ctrl+O en sluit nano af met Ctrl+X. Open dan met nano het bestand /etc/dhcpcd.conf en voeg helemaal op het einde de regel nohook wpa_supplicant toe en plaats een hekje (#) vooraan de regel static routers=10.3.141.1. Voer daarna de opdracht sudo systemctl restart hostapd.service uit.

©PXimport

Https

Standaard draait de webinterface van RaspAP op http, niet op het versleutelde https. Op de wiki van het project vind je hoe je https-ondersteuning activeert. In het kort komt het hier op neer: je draait je eigen lokale certificaatautoriteit (CA), maakt een certificaat voor RaspAP aan en ondertekent dat. Daarna configureer je lighttpd, de door RaspAP gebruikte webserver, zodat die je certificaat gebruikt voor versleutelde communicatie met de webinterface. Tot slot moet je ook op elk apparaat waarmee je de webinterface wilt bezoeken het rootcertificaat (van je eigen certificaatautoriteit) downloaden zodat het certificaat van RaspAP vertrouwd wordt en in je webbrowser een groen slotje krijgt.

©PXimport

12 Wifi-client configureren

Klik daarna in de webinterface van RaspAP links op Configureer WiFi apparaat en rechts op Herscan. Kies het draadloze netwerk dat voor RaspAP als toegang tot je thuisnetwerk dient. Vul het wachtwoord bij het juiste netwerk in en klik op Add en daarna op Connect. Schakel daarna in Configureer hotspot / Geavanceerd de WiFi client AP mode in, klik op Instellingen opslaan en herstart de hotspot. Overigens is dit een stap waarin je tegen wat problemen kunt aanlopen. Als er iets niet lukt, kijk dan eens bij de issues op de GitHub-pagina van RaspAP of iemand een vergelijkbaar probleem heeft gehad en dat heeft opgelost.

©PXimport

13 RaspAP upgraden

RaspAP is nog volop ontwikkeling. Regelmatig upgraden naar de nieuwste versie is daarom aangeraden. Helaas gaat dat (nog) niet via de webinterface en dien je daarvoor enkele opdrachten in te typen. Zoek eerst op wat de nieuwste versie is, en of die nieuwer is dan het versienummer dat je linksboven in de webinterface van RaspAP te zien krijgt. Voer daarna de volgende opdrachten op je Pi uit: ga naar de juiste directory met cd /var/www/html, download de laatste broncode met sudo git fetch --tags en installeer daarna de gewenste versie met (bijvoorbeeld voor versie 1.6.1) sudo git checkout tags/1.6.1.

©PXimport

14 RaspAP verwijderen

Als je RaspAP als een tijdelijke oplossing hebt gebruikt, wil je het programma achteraf wellicht verwijderen. Gelukkig levert RaspAP een de-installatiescript mee dat niet alleen alle sporen van het programma zelf verwijdert, maar ook je systeemconfiguratiebestanden terugzet naar de versies waarvan RaspAP tijdens zijn installatie een kopie heeft gemaakt. Het gaat dan onder andere om de configuratie van je netwerkinterfaces, dns en dhcp. Ga daarvoor naar de juiste map met cd /var/www/html/installers en voer het script uit met ./uninstall.sh.

©PXimport

Extra diensten integreren

RaspAP kun je nog uitbreiden met extra diensten. Helaas is de integratie daarvan nog niet helemaal af, zodat je op dit gebied zelf nog wat configuratiewerk dient te doen. Maar op de wiki en in de issues van de GitHub-pagina vind je hier extra informatie over. Zo kun je een OpenVPN-client integreren, zodat alle clients die met je toegangspunt verbinden via een specifieke vpn-server surfen. Je kunt Tor op je Pi installeren, zodat alle wifi-clients automatisch via het Tor-netwerk anoniem surfen. En ook de adblocker Pi-hole kun je laten samenwerken met RaspAP om automatisch advertenties te blokkeren bij alle verbonden wifi-clients.

©PXimport

▼ Volgende artikel
SSD vs. HDD: waarom is een SSD zo veel sneller dan een harde schijf?
© arinahabich
Huis

SSD vs. HDD: waarom is een SSD zo veel sneller dan een harde schijf?

Waarom start een computer met een SSD binnen enkele seconden op, terwijl een oude harde schijf blijft ratelen? Het vervangen van een HDD door een SSD is de beste upgrade voor een trage laptop of pc. We leggen in dit artikel uit waar die enorme snelheidswinst vandaan komt en wat het fundamentele verschil is tussen deze twee opslagtechnieken.

Iedereen die zijn computer of laptop een tweede leven wil geven, krijgt vaak hetzelfde advies: vervang de oude harde schijf door een SSD. De snelheidswinst is direct merkbaar bij het opstarten en het openen van programma's. Maar waar komt dat enorme verschil in prestaties vandaan? Het antwoord ligt in de fundamentele technologie die schuilgaat onder de behuizing van deze opslagmedia.

De vertraging van mechanische onderdelen

Om te begrijpen waarom een Solid State Drive (SSD) zo snel is, moeten we eerst kijken naar de beperkingen van de traditionele harde schijf (HDD). Een HDD werkt met magnetische roterende platen. Dat kun je vergelijken met een geavanceerde platenspeler. Wanneer je een bestand opent, moet een fysieke lees- en schrijfkop zich naar de juiste plek op de draaiende schijf verplaatsen om de data op te halen. Dat fysieke proces kost tijd, wat we latentie noemen. Hoe meer de data op de schijf verspreid staat, hoe vaker de kop heen en weer moet bewegen en wachten tot de juiste sector onder de naald doordraait. Dit mechanische aspect is de grootste vertragende factor in traditionele opslag.

©Claudio Divizia

Flashgeheugen en directe gegevensoverdracht

Een SSD rekent definitief af met deze wachttijden omdat er geen bewegende onderdelen in de behuizing zitten. De naam 'Solid State' verwijst hier ook naar; het is een vast medium zonder rammelende componenten. In plaats van magnetische platen gebruikt een SSD zogenoemd NAND-flashgeheugen. Dat is vergelijkbaar met de technologie in een usb-stick, maar dan veel sneller en betrouwbaarder. Omdat de data op microchips wordt opgeslagen, is de toegang tot bestanden volledig elektronisch. Er hoeft geen schijf op toeren te komen en er hoeft geen arm te bewegen. De controller van de SSD stuurt simpelweg een elektrisch signaal naar het juiste adres op de chip en de data is direct beschikbaar.

Toegangstijd en willekeurige leesacties

Hoewel de maximale doorvoersnelheid van grote bestanden bij een SSD indrukwekkend is, zit de echte winst voor de consument in de toegangstijd. Een besturingssysteem zoals Windows of macOS is constant bezig met het lezen en schrijven van duizenden kleine systeembestandjes. Een harde schijf heeft daar enorm veel moeite mee, omdat de leeskop als een bezetene heen en weer moet schieten. Een SSD kan deze willekeurige lees- en schrijfopdrachten (random read/write) nagenoeg gelijktijdig verwerken met een verwaarloosbare vertraging. Dat is de reden waarom een pc met een SSD binnen enkele seconden opstart, terwijl een computer met een HDD daar soms minuten over doet.

©KanyaphatStudio

Van SATA naar NVMe-snelheden

Tot slot speelt de aansluiting een rol in de snelheidsontwikkeling. De eerste generaties SSD's gebruikten nog de SATA-aansluiting, die oorspronkelijk was ontworpen voor harde schijven. Hoewel dat al een flinke verbetering was, liepen snelle SSD's tegen de grens van deze aansluiting aan. Moderne computers maken daarom gebruik van het NVMe-protocol via een M.2-aansluiting. Deze technologie communiceert rechtstreeks via de snelle PCIe-banen van het moederbord, waardoor de vertragende tussenstappen van de oude SATA-standaard worden overgeslagen. Hierdoor zijn snelheden mogelijk die vele malen hoger liggen dan bij de traditionele harde schijf.

Populaire merken voor SSD's

Als je op zoek bent naar een betrouwbare en snelle SSD, is er een aantal fabrikanten dat de markt domineert. Samsung wordt door velen gezien als de marktleider op het gebied van flashgeheugen en staat bekend om de uitstekende prestaties van hun EVO- en PRO-series. Daarnaast is Western Digital (WD) een vaste waarde; dit merk heeft de transitie van traditionele harde schijven naar SSD's succesvol gemaakt met hun kleurgecodeerde (Blue, Black en Red) series voor verschillende doeleinden. Ook Transcend is een uitstekende keuze; dit merk staat al jaren bekend om zijn betrouwbare geheugenproducten en biedt duurzame SSD's die lang meegaan. Tot slot bieden merken als Kingston en Seagate betrouwbare alternatieven die vaak net iets vriendelijker geprijsd zijn, zonder dat je daarbij veel inlevert op stabiliteit.

▼ Volgende artikel
AI zonder programmeren: Zo bouw je je eigen chatbot
© ID.nl
Huis

AI zonder programmeren: Zo bouw je je eigen chatbot

Misschien heb je wel eens een vraag gesteld aan een AI-chatbot als ChatGPT, Microsoft Copilot of Perplexity. Maar hoe ontwerp je zelf nu zo'n chatbot? Met de juiste tools is daar zelfs weinig tot geen programmeerwerk voor vereist. We bekijken twee uiteenlopende oplossingen.

Een AI-chatbot is een digitale gesprekspartner die wordt aangedreven door kunstmatige intelligentie. Meestal is de intelligentie gebaseerd op een taalmodel dat is getraind om mensachtige gesprekken te voeren. In tegenstelling tot traditionele op regels gebaseerde chatbots, die alleen vooraf ingestelde antwoorden geven, kan een AI-chatbot vrije tekst begrijpen en ‘natuurlijke’ reacties geven.

In dit artikel kijken we naar het bouwen van een eigen chatbot die je op je desktop of mobiel kunt gebruiken en zelfs op een eigen website kunt plaatsen. We bespreken twee manieren. De eenvoudigste is een no-code chatbotplatform dat het AI-gedeelte achter de schermen afhandelt en je via een gebruiksvriendelijke interface laat bepalen hoe de gespreksflow verloopt. Typische voorbeelden zijn Chatfuel en Chatbot voor zakelijke toepassingen. Daarnaast zijn er de meer toegankelijke Poe en Coze, die we hier behandelen. Onze tweede oplossing is technischer, maar flexibeler. Daarbij gebruik je de Application Programming Interface (API) van een AI-taalmodel om de AI-functionaliteit in je eigen omgeving te integreren. Hiervoor werken we graag met de online omgeving Google Colab.

Poe

Laten we starten met een gebruiksvriendelijke optie: het no-code chatbotplatform Poe (www.poe.com). Je kunt hier ook de app voor desktop of mobiel downloaden en installeren, met vrijwel dezelfde interface en functies als in de browser. De eerste keer maak je een account aan of meld je je aan met je Google- of Apple-account. Via Bots and apps kun je met allerlei AI-chatbots praten, maar in dit geval willen we vooral een eigen chatbot maken. Concreet gaat het om het creëren van een eigen ‘persona’ binnen een gekozen AI-model. Zo’n persona kun je zien als het perspectief, de rol of identiteit die je een AI-bot meegeeft.

Klik hiervoor op Create +. Je krijgt nu verschillende opties, zoals Image generation bot, Video generation bot en Prompt bot. Wij kiezen dit laatste.

Poe bestaat ook als desktop-app en biedt toegang tot vele tientallen AI-modellen.

Creatie

Je hoeft nu eigenlijk alleen maar een onlineformulier in te vullen. We doorlopen kort de belangrijkste onderdelen. Naast het gekozen bottype moet je een naam verzinnen. Omdat deze deel uitmaakt van de url, kies je bij voorkeur een originele, korte naam in kleine letters. Voeg ook een beschrijving toe, die zichtbaar is voor gebruikers van je bot.

Bij Base bot selecteer je een geschikt AI-model, bijvoorbeeld Claude-Haiku-3, GPT-4o-mini, GPT-5 of Grok-4. Afhankelijk van het model gelden er soms beperkingen. Poe-abonnees krijgen doorgaans uitgebreidere toegang tot de duurdere modellen.

Bij Prompt beschrijf je nauwkeurig en uitgebreid hoe de bot moet reageren. De optie Optimize prompt for Previews kun je uitgeschakeld laten. Vul bij Greeting message een welkomstwoord in dat de bot bij elke start toont. Het onderdeel Advanced kun je eigenlijk ongemoeid laten, maar interessant is wel dat je bij Custom temperature het ‘creativiteitsgehalte’ van de bot kunt instellen: hoe hoger de waarde, hoe creatiever en onvoorspelbaarder.

Bij Access kies je de zichtbaarheid van je bot. Wellicht is Only people with the access link de handigste optie, waarna de url zichtbaar wordt en je deze kunt verspreiden. Klik bovenin op Edit picture en kies of ontwerp een passend pictogram. Is alles ingevuld, klik dan onderin op Publish. Je bot is nu klaar voor gebruik. Om je bot te bewerken, hoef je deze maar bij Bots and apps te selecteren en via het knopje met de drie puntjes op Edit te klikken. Ook de optie Delete is beschikbaar.

Geef duidelijk aan wat je bot precies moet doen.
GPT's van OpenAI

Binnen de omgeving van OpenAI (https://chat.openai.com) kun je ook je eigen AI-chatbots maken, de zogeheten GPT’s. Hiervoor heb je wel een plusabonnement nodig (23 euro per maand). Je bent daarbij ook beperkt tot de GPT-modellen van OpenAI, maar je kunt je creaties wel delen via een link of in de GPT-store.

In het kort werkt dit als volgt. Meld je aan en klik links op GPT’s. Klik rechtsboven op + Maken. Via Configureren stel je alles handmatig in, maar via Maken kan het ook ‘al converserend’. Beschrijf kort wat je GPT moet doen en voor wie. Laat de tool een naam en profielfoto voorstellen en beantwoord de vragen om toon en werking af te stemmen. Test je GPT in de preview en ga daarna naar Configureren, waar je naam, beschrijving, instructies en gespreksopeningen ziet. Bij Kennis kun je bestanden uploaden zodat je GPT ook informatie uit je eigen documenten haalt. Via Nieuwe handeling maken koppel je eventueel acties aan externe API’s, gebruik alleen API’s die je vertrouwt. Bevestig met Maken en bepaal hoe je je GPT deelt: Alleen ik, Iedereen met de link of GPT-winkel (in een zelfgekozen categorie). Rond af met Opslaan. Je kunt de link (https://chatgpt.com/g/<code><naam>) daarna kopiëren en verspreiden. Via GPT’s / Mijn GPT’s kun je eerder gemaakte GPT’s bewerken of verwijderen.

Je kunt ook je ook eigen ‘chatbots’ (GPT’s) ontwerpen, gebruiken en met anderen delen.

Poe biedt ook geavanceerdere mogelijkheden als een Server bot-type (waarmee je ook andere API’s kunt aanroepen). Via Knowledge base kun je verder eigen informatiebronnen toevoegen waaruit de bot kan putten. Voor complexere bots gebruiken we toch liever het no-code platform Coze (www.coze.com) dat veel extra opties kent. Meld je aan met je Google-account, klik op + Create in de linkerkolom en daarna op + Create bij Create agent.

Coze

Coze gebruikt de term agent in plaats van bot om duidelijk te maken dat je er een digitale assistent mee kunt maken die niet alleen met een AI-model antwoorden geeft, maar ook geheugen of context kan gebruiken en meerdere kanalen kan bedienen, zoals een website of een Discord-server, maar zover gaan we hier niet.

Vul een passende naam voor je bot of agent in en schrijf een korte maar duidelijke omschrijving, bijvoorbeeld “Deze bot haalt allerlei informatie uit onze eigen documenten rond computerbeveiliging.” Laat Personal geselecteerd bij Workspace en klik linksonder op het knopje om een geschikt pictogram te uploaden of klik op het sterretje om er een te laten genereren. Klik daarna op Confirm.

De start van je eigen AI-chatbot (of agent) in Coze.

Uitwerking

Je komt nu in je dashboard waar je de bot verder vorm kunt geven. Ontwerp de persona door in het linkerdeelvenster een uitvoerige omschrijving van de bot in te vullen. Optimaliseer deze omschrijving snel met het blauwe knopje Auto Optimize prompt rechtsboven. Na bevestiging met Auto-optimize werkt Coze meteen een geoptimaliseerde prompt uit voor de persona. Klik op Replace om deze te gebruiken. In het rechterdeelvenster kun je je bot direct testen. De antwoorden komen uit de kennisdatabank van het geselecteerde model (zoals GPT-4o).



Wil je dat de bot ook uit eigen bronnen put, dan moet je deze eerst uploaden. Dit doe je in het middelste deelvenster, bij

Knowledge, waar je uit Text, Table en Images kunt kiezen. Klik op het plusknopje bij bijvoorbeeld Text en daarna op Create knowledge. Selecteer Text format en geef een naam aan je informatiebundel. Je kunt data ophalen uit bronnen als Notion of Google Doc, maar wij kiezen voor Local documents om eigen bestanden te uploaden. Klik op Create and import en versleep de gewenste documenten naar het venster. Klik daarna op Next (3x) en wat later zijn je documenten verwerkt. Rond af met Confirm en met Add to Agent rechtsboven. Je vindt je informatiebundel nu terug bij Knowledge en de bot put voortaan (ook) uit deze gegevens.

Om je bot beschikbaar te maken, klik je rechtsboven op Publish en daarna op Confirm. Je kunt hem op diverse platformen publiceren, onder meer in de Coze Agent Store. Selecteer een passende categorie en bevestig met Publish.

Laat AI je helpen bij het ontwerpen van een optimale persona.

Extra's

Daarnaast biedt Coze nog diverse andere nuttige opties, zoals talrijke plug-ins. Klik hiervoor op het plusknopje bij Plugins of gebruik het A-knopje om automatisch geschikte plug-ins te laden op basis van je persona-beschrijving. Deze kun je meteen inzetten, eventueel na optimale afstelling via het tandwielpictogram.

Je kunt de functionaliteit van je bot eenvoudig uitbreiden met talrijke plug-ins.

API-sleutels

No code-platformen als Poe en Coze zijn handig, maar wil je meer flexibiliteit en schrik je niet terug voor enige basiscodering, dan werk je beter met de API van een AI-model. Deze fungeert als tussenpersoon die je script en de AI-dienst laat communiceren via een set regels en commando’s. We gaan uit van de API van OpenAI (GPT) en maken eerst een sleutel aan om de API-interface te gebruiken. Ga naar https://platform.openai.com/api-keys, meld je aan met je account (zoals Google) en klik op +Create new secret key. Geef de sleutel een naam, bijvoorbeeld aibot, en klik op Create secret key. Klik daarna op Copy en bewaar de sleutel op een veilige plek. Rond af met Done: de sleutel is nu toegevoegd. Je kunt deze hier op elk moment ook weer intrekken.

Je hebt een sleutel nodig om de API te kunnen gebruiken.

Interactie

Een snelle manier om een script te maken dat deze API aanroept, is via het gratis Google Colab (https://colab.research.google.com), een online notitieboek voor Python. Meld je aan met je Google-account, klik op + Nieuw notebook of ga naar Bestand en kies Nieuw notebook in Drive, en geef het ipynb-bestand (Interactive PYthon NoteBook) een zinvolle naam. Het notebook wordt automatisch in je Google Drive bewaard en is bereikbaar via het pictogram met de oranje cirkels.

Klik nu op + Code voor je eerste codecel, waarmee je de OpenAI-bibliotheek installeert:

!pip install openai

Voer dit uit met het pijlknopje en klik vervolgens op + Code voor de tweede cel met de volgende code:


from openai import OpenAI

client = OpenAI(api_key="<je_API-sleutel>")

response = client.chat.completions.create(

    model="gpt-3.5-turbo",

    messages=[{"role": "user", "content": "Wat weet je over Haarlem( Nederlands)?"}]

)

print(response.choices[0].message.content)


Je laadt hierbij eerst de geïnstalleerde Python-bibliotheek en zet je geheime sleutel in de clientconfiguratie. Vervolgens stuur je een chataanvraag naar OpenAI en bewaar je het antwoord in de variabele ‘response’. Vervolgens haal je de tekst van het (eerste) antwoord op en druk je dit af in de uitvoer van de code-cel.

Een eenvoudige interactie tussen je script en GPT via de API.

Eigen chatbot

 We gaan nu een stap verder en maken er een heuse chatbot van die via een while-lus een doorlopend gesprek kan voeren:


from openai import OpenAI

client = OpenAI(api_key="<je_API-sleutel>")

messages=[

    {"role":"system","content":"Je beantwoordt elke prompt leuk, maar correct, met een rijmschema zoals ABAB of ABBA"}]

while True:

  user_input=input("Jij:")

  if user_input.lower() in ["stop","exit","quit"]:

    break

  messages.append({"role":"user","content":user_input})

  response=client.chat.completions.create(

      model="gpt-4o",messages=messages)

  bot_reply=response.choices[0].message.content

  print("Bot:",bot_reply)

  messages.append({"role":"assistant","content":bot_reply})


Zolang de gebruiker geen stopwoord invoert, blijft de lus actief. De bot antwoordt in de stijl en taal die je zelf hebt vastgelegd in de systeemrol (zie coderegel 3). Met de methode-aanroep messages.append voeg je telkens een nieuw bericht van zowel de gebruiker (user) als de bot (assistant) toe aan de gespreksgeschiedenis.

Mocht je ergens een fout hebben gemaakt in je script, dan is de kans groot dat je via de knop Fout uitleggen nuttige feedback krijgt en met de knop Accepteren (en uitvoeren) de fout zelfs automatisch kunt laten verbeteren.

In het kader ‘Mooi gepresenteerd’ lichten we kort toe hoe je dit script bijvoorbeeld ook op een eigen webpagina kunt laten draaien.

Onze rijmende chatbot wordt wakker geschud vanuit Colab.
Mooi gepresenteerd

Je Colab-script werkt, maar het oogt niet fraai en je wilt het natuurlijk mooi gepresenteerd met anderen delen. Dit doe je het makkelijkst met Gradio, een opensource-Python-bibliotheek waarmee je snel een webinterface rond je script bouwt. Installeer en importeer daarvoor eerst Gradio in je Colab-omgeving:

!pip install -q gradio

import gradio

Via www.kwikr.nl/colabcode vind je de code (als py-bestand) waarmee je rond het Colab-script met Gradio een eenvoudige webinterface genereert. Deze verschijnt in je Colab-omgeving, maar je krijgt ook een publieke url te zien waar je de interface rechtstreeks kunt openen (https://<code>.gradio.live).

Dankzij de volgende aanroep in de laatste coderegel kunnen bezoekers van deze webpagina je chatbot-script ook als PWA-app op hun pc bewaren en starten:

demo.launch(share=True,pwa=True)

Een alternatief is deze webpagina via een <iframe>-instructie in de html-code van je eigen site op te nemen:

<iframe src=https://<code>.gradio.live></iframe>

Gradio heeft een eenvoudige webinterface gecreëerd voor ons chatbotscript.