Die Antworten aus dem Helpdesk übernehmen, ohne dass der Agent sie ungeprüft sagt

Ein Teilehändler hat über Jahre eine FAQ-Seite und ein Helpdesk mit Textbausteinen gepflegt. Darin stecken die richtigen Antworten — und einige, die seit der letzten Versandumstellung falsch sind. Alles auf einmal in den Agenten zu kippen, wäre schnell und gefährlich.

Der Import ist deshalb bewusst zweistufig: Eingelesen wird immer als Entwurf, und die freigegebene Auswahl ändert sich dabei nicht. Wirksam wird eine Antwort erst, wenn jemand sie freigibt — ein Import kann nie stillschweigend verändern, was der Agent sagt.

Was dieser Fall voraussetzt

• Ein angelegtes Profil. Die Wissensbasis gehört zu einem Profil; ohne profileId gibt es keinen Ort für die Einträge.
• Die Antworten als Frage-Antwort-Paare. Fliesstext aus einer Seite muss vorher in Paare zerlegt werden.
• Eine Person, die freigibt. Die Freigabe ist der eigentliche Arbeitsschritt, nicht der Import.
• Die Bereitschaft, zu kürzen. Die Anweisung hat eine Obergrenze; nicht jede alte Antwort passt hinein.

Der Ablauf

Die Tabelle nennt je Stufe den zuständigen Aufruf und das, was danach vorliegt. Die Begründung, warum die Stufe nicht übersprungen werden kann, steht darunter.

Warum jede Stufe nötig ist

1. Den Bestand lesen. GET /agent/profiles/{profileId}/faq liefert die Einträge mit status, dazu entryCount, approvedCount und faqCompiledChars. Wer vor dem Import weiss, wie viel schon freigegeben ist und wie viel Platz die Anweisung noch hat, importiert gezielter.
2. Einlesen. POST /agent/profiles/{profileId}/faq/import nimmt bis zu 200 Einträge mit question, answer und language — immer als Entwurf. Die Antwort meldet imported und skipped getrennt und nennt in warnings, was auffällig war.
3. Freigeben. PUT /agent/profiles/{profileId}/faq/{entryId} setzt status auf approved, rejected oder zurück auf draft und erlaubt, Frage und Antwort vorher zu korrigieren. Die Antwort nennt faqDropped: Passt ein Eintrag nicht mehr in die Anweisung, erfahren Sie es, statt es zu raten.
4. Veraltetes löschen. DELETE /agent/profiles/{profileId}/faq/{entryId} entfernt einen Eintrag und nennt die neue Länge der Anweisung in faqCompiledChars. Löschen ist hier Pflege, nicht Verlust: Jede entfernte falsche Antwort ist eine, die der Agent nicht mehr sagen kann.
5. Das Profil nachziehen. PUT /agent/setup/profiles/{profileId} aktualisiert das Profil aus geänderten Antworten auf den Fragebogen, ohne es neu anzulegen. Wenn die Wissensbasis zeigt, dass sich Ton, Versandregeln oder Befugnisse geändert haben, gehört das in das Profil und nicht nur in einen FAQ-Eintrag.

curl -X POST \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"entries":[{"question":"Versenden Sie auch nach Österreich?","answer":"Ja, innerhalb von zwei Werktagen nach Zahlungseingang.","language":"de","status":"draft"}]}' \
  'https://api.tapinomahub.com/hub/index.php/agent/profiles/<profileId>/faq/import'

Was am Ende vorliegt

Am Ende steht eine Wissensbasis, in der jede Antwort des Agenten einmal ausdrücklich freigegeben wurde, und ein Profil, das zur Wissensbasis passt. Der Import war schnell; die Freigabe war die Arbeit — und sie ist der Grund, warum man dem Ergebnis trauen kann.

Wo das in der Dokumentation steht

Die verbindlichen Feldlisten, Fehlercodes und Beispielantworten stehen im OpenAPI-Vertrag dieser Fläche unter docs.tapinomahub.com (tapinoma-agent). Alle Anwendungsfälle nach Fläche und Rolle geordnet: Übersicht der Anwendungsfälle.