Een AI-widget op uw website
In de widget ontmoeten bezoekers de assistent.
Wat je gaat leren
- Leg uit: een begrensde agentlus
- Pas het idee toe in een voorbeeld: een AI-widget op uw website
- Herken beperkingen en verifieer het resultaat van de oefening
In de widget ontmoeten bezoekers de assistent. Combineer duidelijkheid, het juiste doel en toegestane toegang.
Deze stappen verwijzen naar de functies die in de applicatiecode zijn geïdentificeerd. Dit materiaal is niet gevalideerd op een live exemplaar; controleer de documentatie en de opties in uw versie.
Hoe het werkt, stap voor stap
Een begrensde agentlus
Een agent combineert een model met hulpmiddelen, een doel en een staat. Het observeert het verzoek, kiest een stap, ontvangt een resultaat en besluit of het doorgaat. Een chatbot mag alleen tekst genereren; een agent kan om een externe actie verzoeken. Commerciële definities variëren, dus inspecteer de daadwerkelijke controle. Definieer succes en stoppen: een geverifieerd resultaat, een maximaal aantal stappen, herhaalde fouten of een uitgeput budget. Gebruik beperkte mogelijkheden en minimale machtigingen. Nuttige autonomie betekent vrijheid binnen de door software afgedwongen grenzen.
Controleer de toegang vóór gebruik
Machtigingen moeten worden afgedwongen door servers en de gegevenslaag. Laat het model niet beslissen of een gebruiker een document mag zien. Filter bronnen voordat ze in de context terechtkomen, niet nadat het antwoord is gegenereerd. Gebruik inloggegevens voor minimale toegang, houd deze buiten prompts, schermafbeeldingen en browsercode en draai blootgestelde sleutels. Een toelatingslijst voor widgetdomeinen vervangt API-authenticatie niet. Authenticatie identificeert u; autorisatie bepaalt welke handelingen en gegevens u kunt gebruiken. Test ook toegang geweigerd.
Definieer succes voordat u gaat optimaliseren
Bereid representatieve verzoeken en verwachte antwoorden of eigenschappen voor. Inclusief gewone gevallen, dubbelzinnigheid, ontbrekende gegevens en gereedschapsfouten. Meet voor RAG het ophalen van bewijsmateriaal afzonderlijk van de correctheid van het antwoord. Recall@k meet het aandeel relevant bewijsmateriaal gevonden in de eerste k-resultaten; Precision@k meet het aandeel geretourneerde resultaten dat relevant is. Voor agenten: houd ook acties, machtigingen en stoppen bij. Een LLM-als-rechter kan de evaluatie versnellen, maar moet worden gekalibreerd ten opzichte van mensen. Wijzig de prompt, het model en de index niet tegelijkertijd als u wilt begrijpen wat de resultaten verbeterden.
Het verklarende schema
Volg de ononderbroken pijlen voor de hoofdstroom. Gestippelde blauwe pijlen leveren gegevens of context; roze pijlen geven feedback of geretourneerde resultaten weer. Kleuren en vormen onderscheiden modellen, winkels, beslissingen en resultaten. Scrol op kleine schermen horizontaal om het hele schema te volgen.
Een compleet voorbeeld
Kies in Widgets agent, workflow of RAG, pas kleuren en begroeting aan, controleer voorbeeld en toegestane domeinen. Gebruik het integratiefragment dat door uw applicatieversie wordt geleverd.
Probeer het zelf
- Test op één toegestaan en één geweigerd testdomein en vervolgens op mobiel.
- Leg de input, bron en verwachte uitkomst vast voordat u het experiment uitvoert. Gebruik alleen de fictieve gegevens in het voorbeeld.
- Volg de diagramfasen. Registreer bij elke stap welke informatie wordt ontvangen en geproduceerd; verwar de tussentijdse output niet met het uiteindelijke resultaat.
- Herhaal dit nadat de noodzakelijke informatie is verwijderd of de invoer dubbelzinnig is gemaakt. Controleer of het systeem een antwoord verduidelijkt, stopt of verzint.
- Vergelijk met de uitgelegde oplossing. Bewaar de configuratie, datum, resultaat en een verklaring voor verschillen. Verander één ding en test opnieuw.
Een uitgelegde oplossing
De widget reageert op toegestane domeinen met contrast, leesbare tekst en een duidelijke rolomschrijving. Met een succesvolle oefening kun je het verband tussen input, fasen en uitkomst laten zien. Als er informatie ontbreekt, is een voorzichtig antwoord nuttiger dan verzonnen details. Vergelijk meer dan stijl: controleer ook voorwaarden, bronnen en bewerkingen.
Wanneer deze aanpak helpt en wat de beperkingen zijn
Plaats geen privé-API-sleutels in browserfragmenten. Kies deze aanpak wanneer deze een gemeten behoefte verbetert. Houd een eenvoudige basislijn aan en vergelijk de resultaten met behulp van identieke inputs. Eén succesvol voorbeeld garandeert niet in elke situatie betrouwbaarheid.
Controleer wat je hebt geleerd
Geeft meer autonomie altijd een beter resultaat?
Nee. Het vergroot ook de ruimte voor fouten, kosten en onnodige acties.
Waarom is het verwijderen van een privébron na het beantwoorden te laat?
De gegevens zijn al in de modelcontext terechtgekomen en kunnen worden vrijgegeven.
Welk resultaat moet deze oefening opleveren?
De widget reageert op toegestane domeinen met contrast, leesbare tekst en een duidelijke rolomschrijving.
Begrippen om te onthouden
- Tussenpersoon: Een systeem dat stappen kan kiezen en hulpmiddelen kan gebruiken om een doel te bereiken.
- Autorisatie / Autorisatie: het recht op toegang tot een bewerking of bron controleren.
- Regressie / regressie: Een wijziging die een voorheen correcte casus doorbreekt.
Bronnen en uw volgende stap
Ter voorbereiding: U04 — Gesprekken en feedback