Einen bestehenden Agenten prüfen und verbessern

Einen bestehenden Agenten prüfen

Für die Prüfung eines Agenten, den jemand anderes gebaut hat, oder eines Agenten, der sich falsch verhält. Es gelten dieselben Regeln wie in So bauen Sie Ihren KI-Telefonagenten, hier in Prüfreihenfolge.

Schritt 1: Unternehmensinformationen. Steht hier etwas, das kein Fakt ist? Dann sind Anweisungen und Schritte hineingerutscht. Verschieben Sie sie.

Schritt 2: Hauptziel, abgeglichen mit den Plattform-Standardanweisungen (Abschnitt 6 der Erstellungsanleitung). Gehen Sie es wörtlich durch. Jeder Treffer wird gelöscht. Dieser Schritt allein entfernt meist ein Drittel des Textes.

Schritt 3: Hauptziel, auf Firmenbeschreibung prüfen. Fakten am Anfang gehören in die Unternehmensinformationen.

Schritt 4: Hauptziel, auf Einstellungen und Konfiguration prüfen. Telefonnummern, Endpunkte, Kalendernamen, Feldlisten.

Schritt 5: Jede Skill-Beschreibung, anhand der drei Fragen aus Abschnitt 5.7 der Erstellungsanleitung.

Schritt 6: Nach doppelt getroffenen Entscheidungen suchen. Weiterleitungslogik sowohl im Hauptziel als auch in einer Skill-Beschreibung. Der Umfang einmal so in den Unternehmensinformationen und anders im Hauptziel. Finden Sie so etwas, legen Sie fest, welche Stelle zuständig ist, und löschen Sie die andere. Versuchen Sie nicht, beide anzugleichen, denn sie laufen wieder auseinander.

Schritt 7: Nach Anweisungen suchen, die nicht funktionieren können. Alles, was von der aktuellen Uhrzeit abhängt. Alles, was beschreibt, was nach einer Weiterleitung passiert. Solche Anweisungen sehen richtig aus, haben aber keine Wirkung, daher übersieht man sie leicht.

Schritt 8: Nach fehlenden Verzweigungen suchen. Hier liegen meist die echten Probleme, und genau diesen Schritt lassen viele aus, weil auf der Seite nichts falsch aussieht. Nehmen Sie die Tabelle aus Abschnitt 8 der Erstellungsanleitung und prüfen Sie das Hauptziel Zeile für Zeile. Ein Schritt, der Informationen abfragt, ohne Verzweigung für eine Weigerung, eine Frage, die sich ohne Grenze wiederholen kann, ein ausgeschlossenes Thema ohne Ausweg: Jedes davon ist ein Befund vom Typ missing (fehlt).

Schritt 9: Prüfen, ob jeder Skill aktiviert ist und überhaupt eine Beschreibung hat.

Befunde festhalten

Eine Zeile pro Befund:

EBENE · PROBLEMTYP · der Text · was zu tun ist
main_objective · overlap · "Sei immer höflich und professionell" · löschen
main_objective · wrong layer · "+31 20 XXX XX01 für den Verkauf" · in den Skill Anruf weiterleiten verschieben
main_objective · impossible · "Wenn es nach sechs ist, biete einen Rückruf an" · löschen; die Telefonie regelt die Zeiten
skill description · genericness · "für Kunden, die Hilfe brauchen" · neu schreiben: Ziel und Themen benennen
business_info · wrong layer · "Frage zuerst nach der Bestellnummer" · als Schritt ins main_objective verschieben

Fünf Problemtypen, und nur diese fünf: overlap (Doppelung) · genericness (zu allgemein) · wrong layer (falsche Ebene) · missing (fehlt) · impossible (unmöglich).

Doppelungen verschwenden Tokens. Unmögliche Anweisungen haben keine Wirkung, sehen aber aus, als würden sie funktionieren. Prüfen Sie gezielt darauf.

Automatische Prüfung vor dem Speichern

Die Regeln oben sind so geschrieben, dass man sie einem Modell als Regeln statt als Fließtext geben kann. Dieser Prompt nimmt die Konfiguration eines Agenten und gibt Befunde zurück. Kopieren Sie ihn unverändert; er funktioniert auch ohne diese Seite. Der Prompt ist auf Englisch und funktioniert für Agenten in jeder Sprache.

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>>>