Integración en el proyecto
Se ofrecen dos formas de integración: encargar a un asistente de programación la integración de Jev en el proyecto según las necesidades o, en un proyecto que ya contenga código de TypeSafe, modificar únicamente dos variables de entorno.
Integración mediante asistente de programación
Si utiliza un asistente de programación como Claude Code, Cursor o Codex, copie la instrucción siguiente y sustituya el contenido entre [ ] por sus necesidades reales; el asistente realizará la integración en el proyecto.
Integrar Jev en mi proyecto
Después de copiarla, sustituya el contenido entre [ ] del paso 2 por sus necesidades reales de decisión.
Quiero integrar el modelo de decisión Jev de OfoxAI en el proyecto actual. Ya he creado una API Key en la consola de OfoxAI. Guíeme paso a paso; en cada paso, dígame primero qué va a hacer y qué viene después. [Paso 1: guardar la API Key de forma segura] 1. Cree en el proyecto un archivo .env con una línea OFOX_API_KEY= y deje vacío el valor después del signo =; añada .env a .gitignore. 2. Indíqueme dónde está ese archivo para que yo mismo pegue la API Key y lo guarde. No me pida que envíe la API Key en el chat, ni la escriba en el código ni la imprima. 3. Espere a que le diga "listo" antes de continuar. [Paso 2: la decisión que necesito] - Contenido que se debe evaluar: [por ejemplo: el texto de los tickets de soporte que envían los usuarios] - Preguntas que se deben responder: [por ejemplo: a qué equipo se asigna (cobros y reembolsos / incidencias técnicas / consultas comerciales); si es urgente] - Qué hacer con el resultado: [por ejemplo: asignarlo automáticamente si la confianza es suficiente y, si no, pasarlo a revisión humana] [Paso 3: escribir el código] 4. Use el SDK oficial de OpenAI (ejecute antes pip install -U openai; las versiones antiguas no tienen client.decisions), con base_url https://api.ofox.ai/v1; lea la API Key de OFOX_API_KEY en .env y llame a client.decisions.create() con el modelo typesafe/jev-latest. 5. Elija el tipo de pregunta según mis necesidades: predicate para sí o no; choice para una opción entre varias; score para un grado. Incluya todas las preguntas en el array questions de una misma petición y asigne un name a cada una. 6. Las opciones de choice deben cubrir todos los casos; añada una opción "ninguna de las anteriores" y escriba una description para cada opción. 7. Lea los resultados por name. En choice y score, use confidence para decidir si se actúa automáticamente; en predicate, use probability. Fije el umbral inicialmente en 0.7 como valor de configuración, para poder ajustarlo más adelante. Lo que quede por debajo del umbral debe pasar a revisión humana o a un flujo alternativo. 8. Los campos y errores se rigen por https://ofox.ai/es/docs/api/decisions ; para el uso, consulte https://ofox.ai/es/docs/develop/models/jev . [Paso 4: probar] 9. Ejecute una vez cada uno de 3 ejemplos claros y 2 ejemplos ambiguos, y muéstreme la respuesta, la probabilidad y la confianza de cada uno. 10. Si hay un error, imprima el código de estado HTTP, error.message y request_id, consulte la tabla de errores de la documentación y cambie solo una cosa antes de reintentar; si el mismo error persiste tras dos correcciones, deténgase y deme el texto exacto del error y el request_id.
Migración desde TypeSafe
En los proyectos que utilizan el SDK oficial de TypeSafe o cuyo código se escribió a partir de la documentación oficial de TypeSafe, basta con cambiar la URL base a https://api.ofox.ai/typesafe y sustituir la API Key por una API Key de OfoxAI:
export TYPESAFE_BASE_URL="https://api.ofox.ai/typesafe"
export TYPESAFE_API_KEY="$OFOX_API_KEY"Las peticiones se envían a /typesafe/v1/systemone, con el mismo formato que la API oficial de TypeSafe (state y questions indexadas por ID de pregunta; el tipo de pregunta de sí o no es noul). La comparación de ambos formatos y los ejemplos del SDK figuran en Decisions API · Formato nativo de TypeSafe. Para proyectos nuevos se recomienda utilizar directamente /v1/decisions.