Den Agenten anweisen und ihm eine Obergrenze geben

Die Sorge vor einem automatischen Verkäufer ist selten technisch. Sie lautet: Was sagt das Ding, wenn ich nicht zusehe, und was gibt es weg? Beide Fragen sind berechtigt, und beide werden nicht durch Vertrauen beantwortet, sondern durch eine Anweisung und eine Obergrenze.

Das Profil ist die vertrauenswürdige Anweisung des Agenten: Ton, Regeln, Befugnisse und die Hub-Werkzeuge, die er benutzen darf. Die Mindestpreise sind davon getrennt, und das ist wichtig — sie sind die einzige Verhandlungsgrundlage, und eine fehlende Grenze ist keine offene Grenze.

Was dieser Fall voraussetzt

• Eine Vorstellung vom eigenen Ton. Der Fragebogen fragt danach; wer ihn beliebig ausfüllt, bekommt einen beliebigen Agenten.
• Entschiedene Befugnisse. Ob der Agent stornieren, eine Adresse ändern oder ein Rücksendeetikett schicken darf, ist eine kaufmännische Entscheidung, keine Einstellung.
• Mindestpreise für die Artikel, über die verhandelt werden soll. Ohne sie verhandelt der Agent nicht.
• Eine Obergrenze, die Sie tragen wollen. Der Deckel wird vor dem Betrieb gesetzt, nicht nach der ersten Rechnung.

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 Fragebogen lesen. GET /agent/setup/questionnaire liefert sections und questions. Der Fragebogen ist der Ersatz für eine handgeschriebene Konfiguration: Er stellt die Fragen, die man sonst vergisst, und er trägt eine Version — eine spätere Erweiterung fällt damit auf.
2. Das Profil aus den Antworten anlegen. POST /agent/setup/profiles erzeugt die config mit assistantName, tone, rules, permissions und hubTools. Die Befugnisse sind hier einzeln benannt, nicht pauschal erteilt — das ist der Unterschied zwischen einem begrenzten und einem entgrenzten Agenten.
3. Das eigene Wissen hinterlegen. POST /agent/profiles/{profileId}/faq nimmt freigegebene Frage-Antwort-Paare mit status. Die Antwort nennt faqCompiledChars und faqDropped: Wenn ein Eintrag nicht mehr in die Anweisung passt, erfahren Sie es, statt es zu erraten.
4. Die Mindestpreise setzen. PUT /agent/items/prices schreibt minPriceCents je itemKey. Das ist die einzige Verhandlungsgrundlage. Wer hier nichts hinterlegt, bekommt keinen Agenten, der großzügig verhandelt, sondern einen, der gar nicht verhandelt.
5. Den Deckel setzen. PUT /agent/controls legt monthlyChargeCapCents, dailyTurnCap und lowBalanceWarningCents fest. Zusätzlich lässt sich der Agent jederzeit anhalten und wieder fortsetzen — ein Stopp beendet den Betrieb, ohne die Einrichtung zu verlieren.

curl -X PUT \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"controls":{"monthlyChargeCapCents":25000,"dailyTurnCap":200}}' \
  'https://api.tapinomahub.com/hub/index.php/agent/controls'

Was am Ende vorliegt

Am Ende steht ein Agent, der im eigenen Ton antwortet, nur die erteilten Befugnisse ausübt, unter dem Mindestpreis nicht verhandelt und beim erreichten Deckel aufhört. Das ist keine Vertrauensfrage mehr, sondern eine Einstellung, die man nachlesen 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.