B Blengi docs

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_kb of generic zonder 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?} . Geeft start , 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.