TypeSafe AI peut d’abord être testé dans Playground, puis intégré via API ou SDK officiel. Le processus le plus court est : se connecter à la console pour obtenir la clé API, enregistrer le contenu à enregistrer dans le state, sélectionner jev-latest, puis définir Noul, Choix ou Score dans le questions. Garder la clé dans la variable d’environnement serveur ; ne pas l’écrire dans le code web ni la soumettre au dépôt.
Tout d’abord, utilisez Playground pour vérifier comment la question est rédigée
Collez un message de service client comme un état, puis ajoutez une question « Est-ce urgent ? » Noul. Ajoutez ensuite un choix de département et un score de sentiment pour observer la distribution de probabilité. Si les résultats sont instables, clarifiez d’abord les instructions et les critères, plutôt que d’accumuler immédiatement plus de contexte.
Quels champs sont nécessaires pour les requêtes API
{ "state": "付款连续失败三天，请尽快处理", "model": "jev-latest", "questions": { "department": { "type": "choice", "instructions": "应由哪个团队处理？", "criteria": { "billing": "支付、账单或退款", "technical": "故障、接口或集成" } }, "is_urgent": { "type": "noul", "instructions": "消息是否明确表达紧急性？" } } }Les requêtes sont envoyées à POST /v1/systemone et authentifiées avec des jetons porteurs. Les réponses utilisent l’identifiant de la question, comme la lecture des answers.department.choice et les probabilités candidates. Les environnements de production doivent également enregistrer la version réelle du modèle dans la réponse pour faciliter le dépannage après les mises à jour.
Comment choisir entre Python et JavaScript
Le SDK Python nécessite Python 3.10 ou supérieur et peut s’installer typesafe-sdk ; JavaScript peut utiliser le typesafe-ai/sdk officiel. Les deux lisent les clés de TYPESAFE_API_KEY variables d’environnement et appellent jev-latest par défaut. Si vous avez déjà un framework backend, vous pouvez choisir le langage que votre équipe utilise actuellement, sans avoir à passer à une pile technologique TypeSafe distincte.
Le premier accès ne doit pas être exécuté automatiquement
- Un ensemble d’échantillons réels de désensibilisation, incluant des conditions normales, floues et extrêmes, a été préparé.
- Chaque question ne détermine qu’une seule chose, laissant le calcul de la comparaison du montant et de la date au code.
- Premièrement, enregistrez des résultats et de la confiance, sans déclencher de véritables actions commerciales.
- Ajustez les critères en fonction de l’échantillon mal estimé, puis fixez des seuils de réussite automatique et de vérification manuelle.
- Versions de modèles fixes pour les tests de régression, validées avant de passer à de nouveaux alias.
Si vous rencontrez 401, priorisez la vérification de la clé et de l’en-tête Authorization ; Si vous rencontrez 429, évitez en fonction du temps de réévaluation dans la réponse. Réessayer une requête échouée infiniment immédiatement ne fera que prolonger la limitation de vitesse.
