Instruire l’agent et lui fixer un plafond

L’inquiétude face à un vendeur automatique est rarement technique. Elle est : que dit cette chose quand je ne regarde pas, et que cède-t-elle ? Les deux questions sont légitimes, et aucune ne se règle par la confiance mais par une instruction et un plafond.

Le profil est l’instruction de confiance de l’agent : ton, règles, permissions et outils Hub autorisés. Les prix plancher en sont séparés, et c’est important — ils sont la seule base de négociation, et une limite absente n’est pas une limite ouverte.

Ce que ce cas suppose

• Une idée de votre propre ton. Le questionnaire le demande ; le remplir au hasard donne un agent au hasard.
• Des permissions arrêtées. Que l’agent puisse annuler, changer une adresse ou envoyer une étiquette de retour est une décision commerciale, non un réglage.
• Des prix plancher pour les articles à négocier. Sans eux, l’agent ne négocie pas.
• Un plafond que vous acceptez de porter. Il se pose avant l’exploitation, non après la première facture.

Le déroulement

Le tableau indique pour chaque étape l’appel compétent et ce qui existe ensuite. La justification de l’étape figure en dessous.

Pourquoi chaque étape est nécessaire

1. Lire le questionnaire. GET /agent/setup/questionnaire renvoie sections et questions. Le questionnaire remplace une configuration écrite à la main : il pose les questions qu’on oublie, et il porte une version — une extension ultérieure devient donc visible.
2. Créer le profil depuis les réponses. POST /agent/setup/profiles produit la config avec assistantName, tone, rules, permissions et hubTools. Les permissions sont nommées une à une, non accordées en bloc — c’est la différence entre un agent borné et un agent sans bornes.
3. Déposer vos connaissances. POST /agent/profiles/{profileId}/faq accepte des paires question-réponse validées avec un status. La réponse indique faqCompiledChars et faqDropped : si une entrée n’entre plus dans l’instruction, on vous le dit au lieu de devoir le deviner.
4. Fixer les prix plancher. PUT /agent/items/prices écrit minPriceCents par itemKey. C’est la seule base de négociation. N’y rien déposer ne donne pas un agent généreux mais un agent qui ne négocie pas.
5. Poser le plafond. PUT /agent/controls fixe monthlyChargeCapCents, dailyTurnCap et lowBalanceWarningCents. De plus, l’agent peut être arrêté et relancé à tout moment — un arrêt met fin à l’exploitation sans perdre la configuration.

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'

Ce que l’on obtient

Il reste un agent qui répond dans votre ton, n’exerce que les permissions accordées, ne descend pas sous le prix plancher et s’arrête au plafond atteint. Ce n’est plus une question de confiance mais un réglage consultable.

Où cela figure dans la documentation

Les listes de champs contractuelles, les codes d’erreur et les réponses d’exemple se trouvent dans le contrat OpenAPI de cette surface, à l’adresse docs.tapinomahub.com (tapinoma-agent). Tous les cas d’usage classés par surface et par rôle : aperçu des cas d’usage.