Wat is promptversiebeheer?
Wat promptversiebeheer is, waarom stemagentteams elke promptwijziging vastleggen en hoe je test, releaset en terugdraait zonder live gesprekken te verstoren.
Prompt versioning (promptversiebeheer) is het vastleggen van elke wijziging in de prompt van een AI-agent als een genummerde, vaste versie. Zo kan een team de wijziging testen voordat die live gaat, precies zien wat er is veranderd en terugschakelen naar een eerdere versie als de nieuwe niet werkt. Het wordt ook wel prompt version control genoemd. Promptbeheer is de bredere taak van het schrijven, opslaan en organiseren van prompts. Versiebeheer is het onderdeel daarvan dat releases regelt.
Prompt engineering bepaalt wat de prompt zegt. Promptversiebeheer bepaalt wanneer bellers het horen.
Waarom is een promptwijziging riskanter bij een stemagent?
Een stemagent spreekt in realtime met live bellers. Een slechte prompt bereikt dus mensen voordat iemand het transcript bekijkt. Een zin die de beller al heeft gehoord, kun je niet meer terugnemen.
| Chatassistent | Telefonische stemagent | |
|---|---|---|
| Waar een fout zichtbaar wordt | Op het scherm, waar de gebruiker kan herlezen of het opnieuw kan proberen | Eén keer uitgesproken, midden in het gesprek |
| Wat de prompt aanstuurt | Tekstantwoorden, soms tool calls | Antwoorden plus doorverbindingen, boekingen en sms'jes die echte systemen bereiken |
| Wat een teksttest mist | Weinig, want het product is tekst | Stem, onderbrekingen, doorverbindingen en toetsenbordinvoer |
Bij een stemagent is de prompt niet het enige wat verandert. In Retell AI omvat een versie de hele agent: de prompt, stem, tools, conversation flow en gekoppelde kennisbanken. Een nieuwe stem of een hernoemde tool kan gesprekken net zo makkelijk laten mislukken als een anders geformuleerde instructie. Teams beheren daarom versies van de agent, niet alleen van de prompttekst.
Hoe werkt promptversiebeheer in Retell AI?
Retell documenteert een releaseproces dat is gebouwd op concepten, gepubliceerde versies en omgevingstags. Elke stap hieronder komt uit de documentatie van Retell over agentversies, testen, analytics en alerts.
- Concept. Een nieuwe versie begint als een bewerkbaar concept. Je kunt er een maken vanuit elke eerdere versie en meerdere concepten tegelijk aanhouden.
- Testen. Voer je opgeslagen simulatietestcases uit als batch en vergelijk het slagingspercentage met de vorige run. Luister daarna naar de wijziging in een webgesprek en controleer doorverbindingen en toetsenbordinvoer in een telefoongesprek. Beide werken op een concept zonder dat je het publiceert.
- Vergelijken. In het publicatievenster kun je het concept vergelijken met de laatst gepubliceerde versie, tot op de woorden die in de prompt zijn toegevoegd of verwijderd.
- Publiceren. Publiceren maakt de versie alleen-lezen: V3 (draft) wordt V3, een vaste configuratie waar je later naar kunt terugkeren.
- Releasen. Elke agent begint met de tags
prodenstaging. Telefoonnummers die aanprodzijn toegewezen, volgen de versie waarnaar die tag verwijst. Als jeprodvan V2 naar V3 verplaatst, schakelen ze dus over zonder dat je elk nummer hoeft te bewerken. Wil je een wijziging eerst op een deel van de gesprekken uitproberen, dan verdeelt A/B-testen het verkeer van een nummer procentueel over agents. - Monitoren. Het analyticsdashboard splitst statistieken uit per agentversie, en alertregels kun je beperken tot de
prod-tag. - Terugdraaien. Verplaats
prodterug naar V2.
Wie moet eigenaar zijn van promptversies?
Eén vaste persoon moet eigenaar zijn van elke release, want een promptwijziging op een telefoonlijn is een productiewijziging. Sommige klanten van Retell geven die taak aan een CX automation engineer: de interne eigenaar die slecht afgehandelde gesprekken opspoort, de oplossing schrijft, die test en teruggaat naar de laatst gepubliceerde versie als het niet werkt.
Een korte releaseroutine houdt versies bruikbaar:
- Geef elke versie een titel met de reden van de wijziging, zoals "Fix doorverbinding terugbetaling".
- Mock elke functie die een live systeem bereikt voordat je tests uitvoert. De documentatie van Retell waarschuwt dat een niet-gemockte custom function het echte endpoint aanroept.
- Noteer naar welke versie je zou terugdraaien voordat je
prodverplaatst. - Volg de eerste dag de gesprekken van de nieuwe versie, uitgesplitst per versie.
Veelgestelde vragen over promptversiebeheer
Wat is het verschil tussen promptversiebeheer en promptbeheer?
Promptbeheer omvat het schrijven, opslaan, organiseren en bewerken van prompts. Promptversiebeheer is het onderdeel van promptbeheer dat elke wijziging als een vaste versie opslaat, zodat een team die kan testen, vergelijken en terugdraaien.
Wat zijn tools voor promptversiebeheer?
Dat zijn tools die elke promptversie met een identificatie opslaan, laten zien wat er is veranderd en bepalen welke versie in productie draait. Op een platform voor stemagents kan versiebeheer in de agentbuilder zelf zitten. In Retell AI maken concepten, gepubliceerde versies en omgevingstags deel uit van elke agent.
Hoe draai je een promptwijziging bij een stemagent terug?
Laat productie weer verwijzen naar de laatste versie die werkte. In Retell AI verplaats je de prod-omgevingstag terug naar de vorige versie, en telefoonnummers die aan die tag zijn toegewezen, volgen mee.
Kun je een nieuwe promptversie testen zonder live gesprekken te beïnvloeden?
Ja. Houd de wijziging in een concept en test die met simulatietests, een webgesprek of een telefoongesprek op een testnummer. Met Retell kun je een conceptversie aan een telefoonnummer koppelen zonder die te publiceren. Laat de dynamische variabelen van de prod-tag tijdens het testen ongemoeid, want die gelden voor live gesprekken.
Beheer en test versies van je stemagents met Retell AI
Retell AI is een platform voor AI-stemagents voor contactcenters, met concepten, versievergelijking, omgevingstags en simulatie- en batchtesten ingebouwd in de agentbuilder. Na een release beoordeelt AI QA een steekproef van productiegesprekken, zodat je na elke release de gesprekskwaliteit kunt controleren.
