En bref
- De vraies réponses issues de vos systèmes.L'agent lit les données en direct de votre API, comme le statut d'une commande, au lieu de deviner à partir d'une page d'aide.
- Signé et sans risque de relance.Chaque appel est signé pour que votre serveur puisse prouver qu'il vient de OneType, et il porte une clé d'idempotence stable.
- Les visiteurs approuvent les changements.Les outils qui modifient quelque chose demandent d'abord au visiteur dans le chat, et les outils destructifs demandent toujours.
- Pas de numéros de commande inventés.Un numéro de commande ou un autre identifiant doit venir du visiteur, de la page ou d'un résultat précédent, jamais de l'imagination du modèle.
La plupart des chatbots s'arrêtent à répondre. Un visiteur demande où est sa commande, et le bot l'envoie vers une page de suivi. Avec les actions API, votre agent appelle votre propre système, lit le vrai statut et le lui dit dans la même conversation. C'est comme parler à quelqu'un de votre équipe qui a le bon écran ouvert.
Comment ça marche
Une API est l'adresse sur laquelle répond votre propre logiciel. Avec les actions API (bientôt), vous ajoutez un outil : donnez-lui un nom, décrivez avec des mots simples quand l'agent doit l'utiliser, et saisissez la méthode et l'adresse https de votre endpoint. Vous décrivez les paramètres dont il a besoin, comme un numéro de commande, sous forme d'un petit JSON Schema. Quand un visiteur demande quelque chose qui correspond, l'agent remplit ces paramètres, OneType appelle votre endpoint, et l'agent répond à partir de ce que votre API a renvoyé.
- Choisissez la méthode : GET, POST, PUT, PATCH ou DELETE.
- Mettez les paramètres dans le chemin avec {parameter}, le reste va dans la requête ou le corps JSON.
- Ajoutez des en-têtes, et marquez les identifiants comme secrets pour qu'ils soient stockés chiffrés et jamais réaffichés.
- Dites ce que l'outil fait de vos données : lire, modifier quelque chose, ou détruire.
L'agent enchaîne les étapes tout seul
Une réponse peut utiliser plusieurs outils. L'agent peut retrouver une commande, puis vérifier le délai de retour, puis proposer de passer le chat à une personne, le tout en une seule réponse. Il peut faire jusqu'à 20 appels d'outils dans une seule réponse, et un agent peut posséder jusqu'à 100 outils.
Conçu pour que votre API puisse lui faire confiance
Chaque appel est signé avec un secret de signature propre à l'agent, selon le schéma ouvert Standard Webhooks, pour que votre serveur puisse vérifier qu'il vient bien de OneType. Chaque appel porte aussi une clé d'idempotence qui reste identique lors d'une nouvelle tentative, pour que votre API puisse ignorer les doublons. OneType n'appelle que des adresses publiques d'Internet et ne suit jamais les redirections.
Pour les données personnelles, activez « Only for signed-in visitors ». L'appel inclut alors le contact vérifié, tiré de votre propre jeton d'identité signé, de sorte que le modèle ne peut jamais choisir le compte sur lequel porte une recherche. Les visiteurs anonymes sont refusés.
Les changements exigent le clic du visiteur
Un outil qui ne fait que lire s'exécute tout de suite. Un outil qui modifie quelque chose montre au visiteur une question que vous écrivez, comme Annuler la commande #1234 ?, et ne s'exécute qu'après son clic d'approbation. Les outils destructifs demandent toujours. Les identifiants comme les numéros de commande ou les SKU doivent venir de ce que le visiteur a saisi, de ce que la page montre ou d'un résultat d'outil précédent. Si le modèle en invente un, l'appel ne s'exécute pas et l'agent reçoit la consigne de chercher ou de demander.
Voir comment fonctionne l'approbation du visiteur
Limites à connaître
Votre endpoint doit répondre en JSON en moins de 10 secondes, et l'agent en lit jusqu'à 32 Ko. Chaque outil a sa propre limite d'appels par minute, de 1 à 60, 10 par défaut. Si un appel échoue, l'agent en est informé et continue, par exemple en proposant une personne.