Ce qu’il fait
Le SDK JavaScript officiel relie les applications JavaScript et TypeScript à l’API de TypeSafe. Ses assistants de questions typées permettent aux types de réponse de suivre les questions que vous définissez. Vous pouvez ainsi utiliser une catégorie sélectionnée dans le reste de votre programme sans traiter la réponse comme un paragraphe à analyser.
Pour un produit web, cet appel doit normalement être effectué côté serveur. Le navigateur envoie la demande de l’utilisateur à votre application, votre serveur appelle Jev, puis l’interface affiche la suggestion obtenue. Cette séparation claire empêche également la clé API de se retrouver dans le bundle du navigateur.
À qui il convient
C’est une option simple pour les équipes qui maintiennent déjà un backend JavaScript. Elle convient bien lorsqu’un produit a besoin d’une décision ciblée au sein d’un code existant, par exemple pour suggérer une catégorie de prospect ou une file de support. Si votre équipe utilise déjà AI SDK avec plusieurs fournisseurs, comparez aussi cette intégration ; des conventions communes peuvent compter davantage que l’utilisation du client le plus direct.
Une situation que vous pourriez connaître
Un formulaire de contact reçoit à la fois des propositions de partenariat et des questions de clients. Votre serveur pourrait demander à Jev quelle est l’intention probable, puis afficher une destination suggérée à la personne qui gère la boîte de réception. Le responsable doit toujours voir la demande originale et pouvoir modifier la catégorie.
Si le visiteur envoie deux fois le même formulaire, utilisez votre propre identifiant de requête pour éviter les doublons. Une réponse du modèle ne remplace pas ce contrôle. De même, décider qu’une demande est urgente ne doit pas, à lui seul, autoriser l’envoi d’un message ou la modification d’un compte.
Une première configuration raisonnable
- Vérifiez les exigences actuelles de l’environnement d’exécution et installez @typesafe-ai/sdk dans le projet serveur.
- Chargez la clé API depuis l’environnement de déploiement et gardez-la hors du code côté client.
- Définissez une courte liste de catégories utiles, puis envoyez un échantillon avec le client officiel.
- Ajoutez une solution de repli visible lorsque le service est indisponible ou la classification incertaine.
- Testez l’ensemble du parcours, du formulaire à la vérification, avant de laisser le résultat déclencher d’autres actions.
Les points à évaluer avant de choisir
L’inférence de types aide à détecter les champs incompatibles pendant le développement, mais elle ne repère pas une catégorie métier mal définie. Un résultat peut être valide sur le plan structurel tout en envoyant la demande à la mauvaise équipe. Conservez un échantillon de vérification et testez des messages aux intentions mélangées, comportant des fautes d’orthographe et rédigés dans les langues utilisées par vos clients.
Évitez de laisser une page interactive attendre indéfiniment une décision. Si la classification prend trop de temps, enregistrez la demande et laissez l’utilisateur continuer ; votre application pourra terminer la classification plus tard.
Comptes et coûts d’utilisation
Le SDK permet d’accéder au service ; il ne comprend pas un crédit inclus pour les appels au modèle. Vous avez besoin d’un accès API adapté, et les coûts d’hébergement sont distincts des frais d’inférence. Comparez les coûts selon la quantité de texte envoyée par requête et le nombre réel d’appels. Un actualisation ou une nouvelle soumission du formulaire ne devrait pas entraîner inutilement une nouvelle classification d’un contenu inchangé.