Een bestaande agent controleren en verbeteren

Een bestaande agent controleren

Voor het controleren van een agent die iemand anders heeft gebouwd, of een agent die zich verkeerd gedraagt. Dezelfde regels als in Zo bouw je je AI-telefoonagent, maar dan in controlevolgorde.

Stap 1: Bedrijfsinformatie. Staat hier iets wat geen feit is? Dan zijn er instructies en stappen in terechtgekomen. Verplaats ze.

Stap 2: Hoofddoel, naast de standaardinstructies van het platform (sectie 6 van de handleiding). Loop het letterlijk door. Elke overeenkomst wordt verwijderd. Deze stap alleen haalt meestal een derde van de tekst weg.

Stap 3: Hoofddoel, op bedrijfsbeschrijving. Feiten bovenaan horen in de Bedrijfsinformatie.

Stap 4: Hoofddoel, op instellingen en configuratie. Telefoonnummers, endpoints, agendanamen, veldlijsten.

Stap 5: Elke skillbeschrijving, aan de hand van de drie vragen in sectie 5.7 van de handleiding.

Stap 6: Zoek naar dezelfde beslissing op twee plekken. Doorverbindlogica in zowel het Hoofddoel als een skillbeschrijving. De scope op de ene manier in de Bedrijfsinformatie en op een andere in het Hoofddoel. Vind je zoiets, kies dan welke plek eigenaar is en verwijder de andere. Probeer ze niet gelijk te trekken, want ze lopen weer uit elkaar.

Stap 7: Zoek naar instructies die niet kunnen werken. Alles wat afhangt van de huidige tijd. Alles wat beschrijft wat er gebeurt nadat een gesprek is doorverbonden. Ze zien er correct uit maar hebben geen effect, dus ze worden makkelijk over het hoofd gezien.

Stap 8: Zoek naar ontbrekende vertakkingen. Hier zitten meestal de echte problemen, en juist deze stap wordt overgeslagen omdat er op de pagina niets fout lijkt. Neem de tabel uit sectie 8 van de handleiding en controleer het hoofddoel rij voor rij. Een stap die informatie vraagt zonder vertakking voor een weigering, een vraag die zich zonder limiet kan herhalen, een onderwerp buiten de scope zonder uitweg: elk daarvan is een bevinding van het type missing (ontbreekt).

Stap 9: Controleer of elke skill is ingeschakeld en überhaupt een beschrijving heeft.

Bevindingen vastleggen

Eén regel per bevinding:

LAAG · PROBLEEMTYPE · de tekst · wat te doen
main_objective · overlap · "Wees altijd beleefd en professioneel" · verwijderen
main_objective · wrong layer · "+31 20 XXX XX01 voor verkoop" · verplaatsen naar de skill Oproep Doorverbinden
main_objective · impossible · "Als het na zessen is, bied terugbellen aan" · verwijderen; telefonie regelt de tijden
skill description · genericness · "voor klanten die hulp nodig hebben" · herschrijven: noem bestemming en onderwerpen
business_info · wrong layer · "Vraag eerst naar het bestelnummer" · als stap naar main_objective verplaatsen

Vijf probleemtypes, en alleen deze vijf: overlap (dubbeling) · genericness (te algemeen) · wrong layer (verkeerde laag) · missing (ontbreekt) · impossible (onmogelijk).

Dubbelingen verspillen tokens. Onmogelijke instructies hebben geen effect maar zien eruit alsof ze werken, dus controleer daar gericht op.

Automatische controle voor het opslaan

De regels hierboven zijn zo geschreven dat je ze als regels in plaats van als lopende tekst aan een model kunt geven. Deze prompt neemt de configuratie van een agent en geeft bevindingen terug. Kopieer hem ongewijzigd; hij werkt ook zonder deze pagina. De prompt is in het Engels en werkt voor agents in elke taal.

You are reviewing the configuration of a voice AI phone agent before it is
saved. Report problems. Do not rewrite the configuration.

BACKGROUND
Every agent inherits fixed base instructions the builder cannot see or edit.
They already govern all of the following:
 - date awareness (today, tomorrow, yesterday)
 - speaking times, numbers, prices and phone numbers as words
 - spelling out "@" and special characters in email addresses
 - a calm, polite, concise tone in short conversational sentences
 - asking one question per turn and waiting
 - never opening a reply with a greeting
 - never using exclamation marks
 - never speaking code, JSON or internal text aloud
 - never asking the caller for their phone number
 - declining questions unrelated to the task

The platform also controls these through settings, not text: language, voice,
working hours, voicemail detection, call recording, notifications, creativity,
barge-in, and speech-recognition vocabulary.

THE LAYERS
 business_info       facts about the business
 main_objective      what to do on this call: steps, conditions, triggers,
                     scope, fallbacks, ending
 skill descriptions  what makes one entry of a skill different from the
                     others of the same skill

RULES
R1 OVERLAP          No text in any layer may instruct the agent about anything in
                    the BACKGROUND lists above.
R2 WRONG LAYER      Facts belong in business_info. Steps and conditions belong in
                    main_objective. Discrimination between entries of one skill
                    belongs in that entry's description. Configuration values —
                    phone numbers, endpoints, field lists, calendar names — belong
                    in the skill's own fields, never in prose.
R3 GENERICNESS      A skill description equally true of another entry, or of a
                    different business, does not discriminate. Flag it. Exception:
                    an entry that explicitly names itself the fallback may be broad.
R4 MISSING          A skill description must say what it is for and which caller
                    intents belong to it. With more than one entry of the same
                    skill, each must mark its boundary against the others.
R4b UNHANDLED       main_objective must handle the calls that do not go to plan.
                    Flag as missing:
                     - a step that collects information with no instruction for
                       the caller refusing or being unable to give it;
                     - a question that can be repeated with no attempt limit and
                       no defined next step (this is how agents loop);
                     - out-of-scope topics named with no exit — what to say and
                       where to send the caller;
                     - anything spelled or alphanumeric collected with no
                       read-back and confirmation;
                     - no instruction for the caller going silent;
                     - no defined ending for the call.
                    Report one finding per gap, naming the step it belongs to.
R5 DANGLING         Every destination or target that main_objective names in words
                    must be identifiable from exactly one skill description, using
                    that name. A named target with no matching description — most
                    often a fallback — can stop the skill firing at all, including
                    for targets that are correctly configured.
R6 CONTRADICTION    The same decision must not be made in two layers.
R7 SECRETS          No API key, token or password may appear in business_info,
                    main_objective or any skill description. Blocking.
R8 TRANSFER SAFETY  main_objective must not instruct the agent to transfer to a
                    number supplied by the caller. Blocking.
R9 IMPOSSIBLE       Flag text that depends on the agent determining the current
                    time of day or whether it is inside business hours, or that
                    describes what the agent should do after a call has been
                    transferred away. Stating opening hours as a fact is fine;
                    branching on them is not.

OUTPUT
One line per finding:
  LAYER · TYPE · "the offending text" · what to do
TYPE is one of: overlap, genericness, wrong layer, missing, dangling,
contradiction, secret, transfer safety, impossible.
Order: blocking findings first, then impossible and dangling, then
contradiction and wrong layer, then overlap, then genericness and missing.
If there are no findings, output exactly: NO FINDINGS.

Do not comment on writing style or length. A short description is not a
problem by itself.

CONFIGURATION TO REVIEW
<<<paste business_info, main_objective and every skill description here, each
labelled with its layer and, for skills, the entry name>>>