Intégration au projet
Deux modes d’intégration sont proposés : confier à un assistant de programmation l’intégration de Jev au projet selon les besoins, ou, pour un projet comportant déjà du code TypeSafe, modifier uniquement deux variables d’environnement.
Intégration par assistant de programmation
Avec un assistant de programmation tel que Claude Code, Cursor ou Codex, copiez la consigne ci-dessous et remplacez le contenu entre [ ] par vos besoins réels ; l’assistant réalisera l’intégration dans le projet.
Intégrer Jev à mon projet
Après la copie, remplacez le contenu entre [ ] de l'étape 2 par vos besoins réels de décision.
Je souhaite intégrer le modèle de décision Jev d'OfoxAI au projet courant. J'ai déjà créé une clé API dans la console OfoxAI. Guidez-moi pas à pas ; à chaque étape, indiquez-moi d'abord ce que vous faites et ce qui suit. [Étape 1 : enregistrer la clé en toute sécurité] 1. Créez dans le projet un fichier .env contenant une ligne OFOX_API_KEY= en laissant vide la valeur après le signe = ; ajoutez .env au fichier .gitignore. 2. Indiquez-moi où se trouve ce fichier, afin que je colle moi-même la clé et que je l'enregistre. Ne me demandez pas d'envoyer la clé dans la conversation, et n'écrivez pas la clé dans le code ni ne l'affichez. 3. Attendez que je vous dise « terminé » avant de continuer. [Étape 2 : la décision à prendre] - Contenu à évaluer : [par exemple : le texte des tickets d'assistance soumis par les utilisateurs] - Questions auxquelles répondre : [par exemple : quelle équipe doit traiter le ticket (prélèvements et remboursements / pannes techniques / questions commerciales) ; le ticket est-il urgent] - Que faire du résultat : [par exemple : attribuer automatiquement si la confiance est suffisante, sinon transmettre à un humain] [Étape 3 : écrire le code] 4. Utilisez le SDK officiel d'OpenAI (exécutez d'abord pip install -U openai ; les anciennes versions n'ont pas client.decisions), avec base_url https://api.ofox.ai/v1, lisez la clé depuis OFOX_API_KEY dans .env, appelez client.decisions.create() avec le modèle typesafe/jev-latest. 5. Choisissez le type de question selon mes besoins : predicate pour oui ou non ; choice pour une option parmi plusieurs ; score pour un degré. Placez toutes les questions dans le tableau questions d'une même requête, et donnez un name à chaque question. 6. Les options de choice doivent couvrir tous les cas : ajoutez une option « aucune des précédentes » et rédigez une description pour chaque option. 7. Lisez les résultats par name. Pour choice et score, utilisez confidence pour décider d'agir automatiquement ; pour predicate, utilisez probability. Fixez d'abord le seuil à 0.7, sous forme de paramètre de configuration pour pouvoir l'ajuster ensuite. En dessous du seuil, passez par un humain ou un processus de repli. 8. Pour les champs et les erreurs, la référence est https://ofox.ai/fr/docs/api/decisions ; pour l'utilisation, consultez https://ofox.ai/fr/docs/develop/models/jev . [Étape 4 : tester] 9. Exécutez un appel pour 3 exemples évidents et 2 exemples ambigus, et présentez-moi pour chacun la réponse, la probabilité et la confiance. 10. En cas d'erreur, affichez le code de statut HTTP, error.message et request_id, puis, en vous appuyant sur le tableau des erreurs de la documentation, ne modifiez qu'une seule chose avant de réessayer ; si la même erreur persiste après deux corrections, arrêtez-vous et donnez-moi le texte exact de l'erreur et le request_id.
Migration depuis TypeSafe
Pour les projets qui utilisent le SDK officiel TypeSafe ou dont le code a été écrit d’après la documentation officielle de TypeSafe, il suffit de remplacer l’URL de base par https://api.ofox.ai/typesafe et la clé API par une clé OfoxAI :
export TYPESAFE_BASE_URL="https://api.ofox.ai/typesafe"
export TYPESAFE_API_KEY="$OFOX_API_KEY"Les requêtes sont envoyées à /typesafe/v1/systemone, dans le même format que l’API officielle TypeSafe (state et questions indexées par ID de question ; le type de question oui/non est noul). La comparaison des deux formats et des exemples de SDK figurent dans Decisions API · Format natif TypeSafe. Pour un nouveau projet, il est recommandé d’utiliser directement /v1/decisions.