Reprendre les réponses du support sans que l’agent les dise sans contrôle

Un négociant en pièces entretient depuis des années une FAQ et un support avec des modèles de texte. On y trouve les bonnes réponses — et certaines fausses depuis le dernier changement d’expédition. Tout verser d’un coup dans l’agent serait rapide et dangereux.

L’import est donc volontairement en deux temps : tout entre en brouillon, et la sélection validée ne change pas. Une réponse ne devient effective qu’une fois validée — un import ne peut jamais modifier en silence ce que dit l’agent.

Ce que ce cas suppose

• Un profil créé. La base appartient à un profil ; sans profileId, les entrées n’ont pas de place.
• Des réponses en paires question-réponse. Le texte continu d’une page doit d’abord être découpé en paires.
• Une personne qui valide. La validation est la vraie étape de travail, non l’import.
• La disposition à élaguer. L’instruction a une limite haute ; toute ancienne réponse n’y entre pas.

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 l’existant. GET /agent/profiles/{profileId}/faq renvoie les entrées avec leur status, ainsi que entryCount, approvedCount et faqCompiledChars. Savoir avant l’import ce qui est déjà validé et la place restante rend l’import plus ciblé.
2. Importer. POST /agent/profiles/{profileId}/faq/import prend jusqu’à 200 entrées avec question, answer et language — toujours en brouillon. La réponse signale imported et skipped séparément et indique dans warnings ce qui a attiré l’attention.
3. Valider. PUT /agent/profiles/{profileId}/faq/{entryId} met status à approved, rejected ou de nouveau draft, et permet de corriger question et réponse auparavant. La réponse indique faqDropped : si une entrée n’entre plus dans l’instruction, on vous le dit au lieu de vous laisser deviner.
4. Supprimer l’obsolète. DELETE /agent/profiles/{profileId}/faq/{entryId} retire une entrée et indique la nouvelle longueur dans faqCompiledChars. Supprimer relève ici de l’entretien, non de la perte : chaque réponse fausse retirée est une réponse que l’agent ne peut plus donner.
5. Mettre à jour le profil. PUT /agent/setup/profiles/{profileId} actualise le profil à partir des réponses modifiées au questionnaire, sans le recréer. Si la base montre que ton, règles d’envoi ou permissions ont changé, cela relève du profil et non d’une seule entrée de FAQ.

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'

Ce que l’on obtient

Il reste une base où chaque réponse de l’agent a été validée expressément, et un profil qui lui correspond. L’import a été rapide ; la validation a été le travail — et c’est elle qui rend le résultat fiable.

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.