En bref
- Utilise le code de votre propre page.L'agent appelle les outils que vous déclarez dans votre tableau de bord et enregistrez sur la page, avec la propre session et le propre panier du visiteur.
- Demande avant de modifier quoi que ce soit.Les actions qui modifient quelque chose affichent une carte de confirmation, et seul le clic du visiteur l'approuve.
- Chercher, puis agir.L'agent peut enchaîner des étapes, comme trouver un produit puis l'ajouter au panier, dans une seule réponse.
- Seulement sur les bonnes pages.Limitez chaque action à des chemins comme /shop/*, pour qu'elle ne soit proposée que là où elle a du sens.
Les visiteurs savent souvent exactement ce qu'ils veulent mais pas où faire un clic. Les actions sur le site leur permettent de le dire simplement. « Ajoutez deux sachets de café du Kenya », « montrez-moi seulement les options végétaliennes », « réservez-moi une démo mardi ». L'agent le fait sur votre page, et le visiteur voit le résultat tout de suite.
Comment ça marche
Votre développeur enregistre un outil sur la page d'un seul appel, onetype addTool, et vous déclarez le même outil dans votre tableau de bord sous « Developer › Tools ». Un outil a un nom, une description en mots simples de quand l'utiliser, les paramètres qu'il prend sous forme d'un petit JSON Schema, et un gestionnaire : votre propre JavaScript qui fait le travail, par exemple appeler votre panier. Quand un visiteur demande quelque chose qui correspond, l'agent remplit les paramètres, OneType les vérifie selon votre schéma, et votre gestionnaire s'exécute dans le navigateur du visiteur.
- Dites ce que fait l'action : lecture, écriture ou destructive.
- Écrivez la question de confirmation, avec des espaces réservés {param} remplis à partir des paramètres.
- Limitez-la à certaines pages, jusqu'à 50 chemins.
- Définissez un délai de 1 à 120 secondes, 15 par défaut.
- Modifiez ou retirez un outil à tout moment avec updateTool et removeTool.
Montrez à l'agent ce qui est à l'écran
L'agent ne peut utiliser qu'un identifiant de produit qu'il a réellement vu. Transmettez les produits de la page actuelle avec setContext, ajoutez un outil de recherche pour les grands catalogues, ou laissez votre outil accepter des noms de produits et chercher l'identifiant dans votre propre code. Un identifiant inventé par le modèle ne compte pas : l'appel ne s'exécute pas, et l'agent reçoit la consigne de chercher d'abord ou de demander au visiteur.
Le visiteur garde le contrôle
Tout ce qui change la page ou le panier demande d'abord, sauf si vous le réglez explicitement autrement. Les actions destructrices, comme retirer un article, demandent toujours. L'approbation est un clic dans le chat, que ni le modèle ni un texte sur une page web ne peuvent falsifier. Si le visiteur refuse, votre gestionnaire ne s'exécute jamais.
Lire la suite sur l'approbation du visiteur
Des enchaînements d'étapes
L'agent peut combiner des outils dans une seule réponse. Il peut chercher dans votre catalogue, puis ajouter le bon article au panier, ou retrouver une commande sur votre serveur avec une action API puis ouvrir la page de la commande dans le navigateur. Il peut faire jusqu'à 20 appels d'outils dans une seule réponse.
Les arguments sont vérifiés selon votre schéma avant l'exécution de votre gestionnaire, donc un appel invalide n'atteint jamais votre code et l'agent est informé de l'erreur. Votre gestionnaire peut renvoyer n'importe quel résultat JSON, et l'agent l'utilise dans sa réponse. Donnez les montants avec leur code de devise pour que l'agent n'ait jamais à en deviner un.