Jev API
Jev est la famille de modèles Système Un de TypeSafe AI pour des décisions typées et basées sur des probabilités : classification avec Choice, évaluation par grille avec Score et jugements oui/non avec Noul. Comparez Jev 1.13 et 1.14.0, y compris les capacités expérimentales spécifiques aux versions.
Jev 1.14.0 API
typesafe/jev-1.14.0
Jev 1.14.0 améliore les décisions typées et la prise en charge multilingue, en ajoutant des sorties Box expérimentales ainsi que des fonctionnalités opt-in pour les images et les contextes plus longs. La disponibilité sur les plateformes et la prise en charge des fonctionnalités expérimentales doivent être vérifiées séparément.
Jev API Contexte
Aperçu
Jev est conçu pour les applications nécessitant une décision directement exploitable. Une requête fournit un état et un ensemble de questions typées ; la réponse contient des réponses structurées plutôt qu'une explication générée. L'état peut décrire un message de client, un document, un produit, un incident ou un autre enregistrement applicatif. L'application définit les résultats disponibles et décide de la manière dont ces résultats affectent son flux de travail. Jev complète un modèle de génération de texte lorsqu'un système a besoin à la fois de réponses écrites et de décisions explicites.
Historique de développement
Cette page de famille regroupe les entrées jev-1.13 et jev-1.14.0 de la plateforme. TypeSafe a publié Jev 1.14.0 le 14 octobre 2026, décrivant des améliorations incrémentielles à travers les tâches et un accent particulier sur la qualité multilingue. Son API d'origine utilise les identifiants de version jev-1.13.0 et jev-1.14.0 ; les identifiants de modèle sur cette plateforme suivent la carte de version sélectionnée. Une version en amont ne signifie pas nécessairement que chaque fournisseur l'expose déjà.
Innovations clés
- Les primitives de décision typées permettent aux logiciels de consommer des étiquettes sélectionnées, des scores numériques et des probabilités sans les extraire de phrases.
- Des questions indépendantes peuvent partager un même état. Les applications peuvent collecter plusieurs jugements et les combiner à l'aide d'une logique métier explicite.
- Des entrées d'image expérimentales sont disponibles en amont pour les deux versions, tandis que le type de question expérimental Box est spécifique à Jev 1.14.0.
Jev API Spécifications techniques
Architecture
TypeSafe qualifie Jev de modèle de Système Un : un modèle construit autour de jugements étroits fournis sous forme de questions typées. Chaque question est évaluée indépendamment par rapport au même état. Il est destiné à des décisions bien ciblées ; les tâches larges nécessitant plusieurs étapes de raisonnement doivent être décomposées en jugements séparés et combinées dans le code de l'application. La documentation publique ne fournit pas de nombre de paramètres ici, aucun n'est donc supposé.
Capacités
- Choice sélectionne parmi un ensemble d'options nommées défini par le développeur, renvoyant l'option sélectionnée, la distribution de probabilité et une valeur de confiance. Il convient aux catégories sans ordre inhérent, telles que les départements de support ou les classes de produits.
- Score évalue une grille ordonnée. Il renvoie un score numérique qui peut se situer entre les niveaux de la grille, des probabilités sur ces niveaux et un niveau de confiance. Rédigez des descriptions qui distinguent la signification de chaque niveau.
- Noul évalue une déclaration oui/non et renvoie une probabilité comprise entre zéro et un. Utilisez-le pour des prédicats individuels plutôt que de traiter une probabilité comme un résultat booléen inconditionnel.
- La confiance de Choice et Score résume la concentration de la distribution des sorties ; elle est distincte d'une garantie de correction. Les seuils et les politiques d'escalade relèvent de l'application.
- Les limites de contexte par défaut en amont sont de 64k jetons pour l'ensemble de la requête et de 32k pour l'état ainsi que toute question unique. Les questions doivent respecter les deux limites. Ce sont des limites de référence en amont ; vérifiez l'entrée de la plateforme choisie pour sa configuration exposée.
- Le contexte étendu expérimental en amont nécessite TypeSafe-Danger-Zone-Long-Context : true et élève les deux limites de contexte à 262k. L'entrée d'image nécessite TypeSafe-Danger-Zone-Images : true. Le passage d'en-tête et le support expérimental doivent être vérifiés auprès du fournisseur réel.
Limitations
- Jev n'est pas une interface générale de génération de prose. Utilisez un modèle génératif séparé lorsque le produit nécessite une réponse écrite, une composition ouverte ou une explication détaillée.
- Les entrées d'image, les sorties Box et le contexte étendu sont des fonctionnalités expérimentales facultatives en amont, et non une garantie de préparation pour la production ou de disponibilité via cette plateforme.
- Un contexte plus long peut réduire la précision et augmenter la latence. Fournissez des preuves pertinentes et évitez de faire porter à une seule question plusieurs jugements sans rapport.
- N'inférez pas la prise en charge de l'audio ou de la vidéo à partir du support expérimental des images. Convertissez les médias non pris en charge en texte approprié ou en preuves structurées avant l'évaluation.
Jev API Performance
Points forts
- Les types de sortie explicites conviennent aux flux de travail où le logiciel doit se ramifier, classer ou acheminer en utilisant le résultat.
- Choice peut comparer des catégories connues ; Score peut conserver une évaluation ordonnée au lieu de forcer chaque jugement dans une décision binaire.
- La gestion consciente de la confiance peut distinguer les décisions automatiques des cas nécessitant des preuves supplémentaires ou une révision humaine.
- Le modèle d'état partagé et de questions multiples permet d'évaluer des aspects distincts d'un même enregistrement tout en maintenant la politique finale visible dans le code.
Efficacité en conditions réelles
Utilisez un jeu d'évaluation représentatif avant d'adopter une version ou de modifier un seuil. Incluez des enregistrements ambigus, des informations manquantes, des catégories minoritaires et les langues utilisées par vos clients. Mesurez la précision des tâches, les actions automatiques erronées, le volume de révision, la latence et le coût sous le fournisseur réel. L'annonce de version de TypeSafe décrit de vastes améliorations dans la version 1.14.0, mais n'établit pas de pourcentage d'amélioration universel pour chaque charge de travail. Conservez une ancienne version épinglée jusqu'à ce que le remplacement satisfasse vos propres critères d'acceptation.
Jev API Quand l'utiliser
Scénarios
- Triage du support : choisissez l'équipe responsable dans une liste fixe et évaluez l'urgence séparément avec une grille ordonnée.
- Classification de catalogues et de documents : associez les enregistrements à des étiquettes connues tout en préservant les cas incertains pour révision.
- Évaluation de contenu : évaluez les conditions de politique individuelles ou les dimensions de qualité, puis combinez-les à l'aide de règles d'application explicites.
- Routage d'agents : choisissez entre des outils ou des gestionnaires connus, avec des contrôles de permission ordinaires appliqués avant qu'une action ne s'exécute.
- Pipelines de récupération : évaluez la pertinence des candidats ou vérifiez une affirmation étroitement formulée par rapport aux preuves fournies.
Meilleures pratiques
- Rédigez un jugement clairement délimité par question. Placez les preuves dans l'état et définissez des options Choice mutuellement distinctes ou des niveaux de Score descriptifs.
- Utilisez la confiance et les probabilités comme entrées d'une politique de décision testée. Incluez un chemin de révision ou d'abstention là où les décisions incertaines ne doivent pas s'exécuter automatiquement.
- Épinglez une version spécifique du modèle pendant l'évaluation et le déploiement. Retestez les seuils lors du passage de 1.13 à 1.14.0 ; ne supposez pas des distributions de sortie identiques.
- Vérifiez le statut sur la plateforme et le prix de la version sélectionnée avant l'intégration. Les tarifs et points de terminaison officiels en amont ne remplacent pas la documentation d'API spécifique à la version de cette plateforme.
- Gardez les expériences d'images et de contexte étendu séparées du flux de travail textuel de production initial jusqu'à ce que le fournisseur choisi et vos évaluations les prennent en charge.
- Documentation de référence : https://docs.typesafe.ai/introduction ; https://docs.typesafe.ai/models ; https://docs.typesafe.ai/primitives/choice ; https://docs.typesafe.ai/primitives/score ; https://docs.typesafe.ai/confidence ; https://docs.typesafe.ai/images ; https://typesafe.ai/blog/jev-1-14 .