Je AI-medewerker bouwen
Speeltuin (platformbeheerders)
Alleen voor platformbeheerders.
Klanten testen hun
agent met de live preview — de echte widget, op de tabbladen ‘Uiterlijk’ en ‘Persoonlijkheid’
en die op elke andere pagina van de agent te zien is. De Playground op
/app/agents/{id}/playground
is de diagnostische
tweelingbroer: een aparte chat die ook laat zien welke pagina’s zijn opgehaald, hoe
zeker de reranker was, en de exacte prompt die het model kreeg.
Dit werd voor klanten verborgen gehouden, omdat een tweede chat die eruitziet als
de widget maar dat niet is, meer verwarring veroorzaakte dan dat het hielp. Gesprekken
hier worden gemarkeerd met is_playground
en tellen nooit mee voor de
factureringsmeter, het aantal gesprekken of leads.
Wat je kunt testen
-
Sitetype
— schakel tussen
ecommerce,saas,documentation,help_center,marketing,internal_kbofgenericzonder de opgeslagen kolom van de agent te wijzigen. Handig voor "wat zou mijn agent zeggen als hij behandeld wordt als e-commerce versus documentatie?". - Paginacontext — plak een URL en metadata (titel, beschrijving, OG-tags, JSON-LD, h1/h2, zichtbare hoofdtekst) zodat de agent antwoordt alsof de bezoeker op een specifieke pagina zit. Zes kant-en-klare sjablonen (Shopify-product, SaaS-prijzen, Docusaurus- documentatie, helpcentrumartikel, marketinglandingspagina, leeg) dekken de meest voorkomende vormen.
-
Antwoordtaal
— kies elke taal waarvoor de werkruimte
vertalingen aanbiedt (standaard 132, automatisch gedetecteerd via
lang/*.json). Handig om te controleren of de agent in de juiste taal antwoordt en of RTL-scripts correct worden weergegeven. - Voorbeeldvragen — realistische testvragen van kopers per branche (5–6 voorbeelden per sitetype), zodat je met één klik een typische vraag kunt stellen.
- Vergelijkingsmodus — schakel deze in om de chat in twee kolommen te splitsen en dezelfde vraag voor twee verschillende sitetypes naast elkaar te stellen. Dit is de doorslaggevende factor bij het kiezen van de juiste branche.
Tabbladen in het rechtervenster
Scenario
Sitelijst overschrijven + antwoordtaal + voorbeeldvragen. De
functiebadges onder de sitelijstkeuze laten zien welke rich blocks
(product_card
, pricing_card
,
case_study_card
, escalation_button
) de
geselecteerde branche kan weergeven.
Let op: nog niet elke functie heeft een widget-renderer.
Op dit moment staat de RENDERABLE
-set van de widget in
resources/widget/src/core/capabilities.ts
alleen
ticket_escalation
op de witte lijst (het
escalation_button
-blok). Andere blokken
(product_card
, pricing_card
,
case_study_card
) worden door de server gegenereerd als de
LLM erom vraagt, maar de openbare widget laat
totdat hun renderer is toegevoegd aan de
RENDERABLE
-set + een Preact-component in
ui/blocks.tsx
. De Playground geeft een voorbeeldweergave ervan
omdat deze alle renderers meelevert voor ontwerpdoeleinden — wat je
in de Playground ziet, kan uitgebreider zijn dan wat je bezoekers zien in
de live widget.
Paginacontext
Formuliergestuurde editor voor de page_context die de bezoeker zou
verzenden. Gebruik de
dropdown ‘Sjabloon gebruiken’ om een realistische Shopify-productpagina
of Stripe-prijspagina in te voegen, en pas vervolgens de URL, titel en OG-velden aan. JSON-LD
accepteert geplakte JSON.
Diagnostiek
Alleen-lezen inspectie van de laatste beurt:
- Latentie — tijd tot eerste token en totale tijd.
- Betrouwbaarheid — hoe goed de kennisbank aansloot bij de vraag: de beste ophaalscore vóór de boost, 0,3 als er niets werd opgehaald (geen drempel voor paginamomentopname).
- Gevonden bronnen — top-k fragmenten met zowel ANN- als herrangschikkingsscores plus een fragment, gerangschikt zoals de LLM ze zag. Elk wordt gelabeld als het een productrecord is (catalogusrecord, registerrecord) of een product-, categorie- of beleidspagina, en de regel boven de lijst laat zien waarnaar er gezocht is — een vervolgvraag zoekt met het onderwerp hersteld, net als in de widget.
- Toolaanroepen — elke server-side tool die tijdens de beurt is geactiveerd, met argumenten.
- Inline-blokken — aantal en soorten rich-blokken
die de LLM heeft gegenereerd (bijv.
product_card). - Systeemprompt — het volledige systeembericht dat is gebruikt, inclusief het verticale fragment en eventuele aangepaste systeemprompts. Klik om uit te vouwen.
Het antwoord wordt precies zo opgebouwd als de widget het opbouwt: dezelfde zoekopdracht, de productgegevens die een beurt meebrengt (het productregister en de productcatalogus, inclusief het record van een product dat de bezoeker noemt als er verder niets vond), de productlijst van het register bij een beurt waarin niets werd gevonden, de verkoopargumenten van de eigenaar bij een prijsbezwaar, en de paginatypen in de prompt. Voorheen sloeg de Playground dit allemaal over, dus een strikte winkel zou hier kunnen weigeren terwijl hij via de widget antwoordt.
Eindpunten
Alle drie zijn sessie-geauthenticeerd en worden afgebakend door
AgentPolicy::update
:
-
GET /app/agents/{agent}/playground— Inertia-render met de verticale preview-kaart op basis van slug. -
POST /app/agents/{agent}/playground/stream— SSE-stream. Body:{message, conversation_id?, site_type_override?, language_override?, page_context?}. Geeftstart,retrieval,prompt,token,block,tool_call, <img id="9"/>,done-gebeurtenissen af. -
POST /app/agents/{agent}/playground/reset— wist de in de cache opgeslagen gespreksgeschiedenis. Hoofdtekst:{conversation_id}.
Opmerkingen
- Playground gebruikt dezelfde Redis-geschiedenis-sleutel als de productieversie van de widgetgesprekken. Resetten is de expliciete manier om vanaf een lege context te beginnen — als je het tabblad sluit, blijft de geschiedenis twee uur lang bewaard.
- Overschrijvingen voor sitetype en taal veranderen de opgeslagen kolommen van de agent niet. Zodra je de combinatie hebt gevonden die werkt, ga je naar Geavanceerd › Type website van de AI-medewerker om deze op te slaan.
- Payloads in de paginacontext worden aan de serverzijde op dezelfde manier opgeschoond als bij de bezoekerswidget — dezelfde allow-list voor sleutels, dezelfde limiet van 8 KB, dezelfde samenvatting van de canonical-URL.