Overzicht
Koppel de gemeentelijke website voor de chat (crawlen + index). Daarnaast: e-loketdiensten en optioneel documenten.
Aan de slag
-
Website-URLVul op het tabblad Website de start-URL van de gemeente in en sla op.
-
Website indexerenDruk op Website indexeren om te crawlen en vectors naar Upstash te schrijven.
-
E-loketdienstenVoeg op Diensten minstens één dienst toe met een geldige e-loket-URL.
-
Interne documentenOptioneel: beleid of FAQ op Documenten, daarna document-index bouwen.
Configuratie opslaan
Bewaar website, diensten, documenten en design in één keer.
Laatste versie laden
Haal de actuele serverconfiguratie opnieuw op voordat je verder werkt.
Persona van Sophie
Schrijf hier extra instructies voor de toon en stijl van Sophie. Deze komen bovenop de vaste veiligheids- en gemeente-instructies.
Sophie antwoordt standaard in deze taal. Laat dit op Nederlands staan voor de huidige standaard, of vul bijvoorbeeld Frans, Engels of Duits in.
Tip: beschrijf gedrag concreet, bijvoorbeeld aanspreekvorm, mate van formaliteit, emoji-gebruik of hoe Sophie moet reageren bij onzekerheid.
Website toevoegen
Vul de startpagina van de gemeente in (https://…). Daarna opslaan. Bij
Website indexeren wordt de site eerst opgeslagen en daarna gecrawld voor de chat.
Laatste crawl
Gecrawlde pagina's
Indexeer-overzicht
Geavanceerd — crawl & RAG
Zelfde host als de website-URL. Grote sites duren langer.
E-loket koppelingen
Maak diensten vindbaar voor Sophie
Voeg per burgerdienst de naam en juiste e-loketlink toe. Sophie gebruikt deze lijst om burgers meteen naar de juiste aanvraag of afspraak te sturen.
Elke regel wordt een dienstkaart. Een URL op dezelfde regel wordt meteen ingevuld; ontbrekende links vul je nadien handmatig aan.
Vraag de agent om kaarten te maken of je geplakte lijst op te schonen. Je controleert daarna zelf de links.
Interne documenten
Plak beleidsteksten, FAQ’s of interne nota’s. Na opslaan bouw je de vector-index zodat Sophie eruit kan citeren (naast de website).
Agenda in de chat
In het tabblad Berichten kan Sophie een ingebouwde afspraakflow tonen, of doorverwijzen naar jullie eigen agendasysteem. Kies hier wat past bij jullie gemeente.
Verplicht bij Externe agenda. Sophie zet in antwoorden een duidelijke «Afspraak maken»-link naar deze URL. Bij API kun je dit als reserve invullen als er geen aparte API-basis-URL is.
Publieke URL waar burgers terechtkomen voor een afspraak (vaak hetzelfde als het planningsportaal van jullie API-leverancier). Gevoelige sleutels horen in server-omgeving, niet in dit veld.
Chatballonnen
Stel de achtergrondkleur in voor de ballon van Sophie en voor de ballon van de burger. Deze kleuren worden direct gebruikt in de chatwidget.
Startscherm (widget — tab Home)
Uploads werken niet als je dit bestand direct vanaf je computer opent. Start in de
projectmap npm run dev en open vervolgens
http://127.0.0.1:5173/admin.html in je browser.
Upload afbeeldingen voor de achtergrond bovenaan en het logo — geen kopiëren-plakken van links nodig. Klik daarna op Opslaan om ze in de configuratie te bewaren.
Widget op een website plaatsen
Plak deze ene regel vlak voor </body> op de website. Sophie laadt daarna op elke
pagina waar deze code staat als vaste chatwidget met iframe.
Gebruik hier de URL waar deze Sophie-installatie online staat. Lokaal vult Studio automatisch de huidige dev-server in, maar voor een echte website moet dit de productie-URL zijn.
Geïsoleerde resources voor deze site
Vul per klant/site een eigen Upstash Vector database in. De sleutels worden server-side versleuteld opgeslagen en niet teruggetoond.
Op Vercel is dit doorgaans
https://uw-project.vercel.app/admin.html — dezelfde host als hierboven, met
/admin.html.