Integração ao projeto
Há duas formas de integração: atribuir a um assistente de código a integração do Jev ao projeto conforme as necessidades ou, em um projeto que já contenha código da TypeSafe, alterar apenas duas variáveis de ambiente.
Integração por assistente de código
Ao utilizar um assistente de código como Claude Code, Cursor ou Codex, copie o prompt abaixo e substitua o conteúdo entre [ ] pelas necessidades reais; o assistente realizará a integração no projeto.
Integrar o Jev ao meu projeto
Depois de copiar, substitua o conteúdo entre [ ] do passo 2 pelas necessidades reais de decisão.
Quero integrar o modelo de decisão Jev da OfoxAI ao projeto atual. Já criei uma API Key no console da OfoxAI. Conduza-me passo a passo; em cada passo, diga primeiro o que você está fazendo e qual é o próximo passo. [Passo 1: guardar a API Key com segurança] 1. Crie no projeto um arquivo .env com a linha OFOX_API_KEY=, deixando vazio o valor depois do sinal de igual; adicione .env ao .gitignore. 2. Diga-me onde está esse arquivo para que eu mesmo cole a API Key e salve. Não me peça para enviar a API Key no chat, não a escreva no código e não a imprima. 3. Aguarde até eu dizer "pronto" antes de continuar. [Passo 2: a decisão que preciso tomar] - Conteúdo a avaliar: [por exemplo: o texto dos tickets de suporte enviados pelos usuários] - Perguntas a responder: [por exemplo: para qual equipe vai o ticket (cobranças e reembolsos / falhas técnicas / dúvidas comerciais); se é urgente] - O que fazer com o resultado: [por exemplo: atribuir automaticamente quando a confiança for alta o suficiente; caso contrário, encaminhar para revisão humana] [Passo 3: escrever o código] 4. Use o SDK oficial da OpenAI (execute antes pip install -U openai; versões antigas não têm client.decisions), com base_url https://api.ofox.ai/v1; leia a API Key de OFOX_API_KEY no .env, chame client.decisions.create() e use o modelo typesafe/jev-latest. 5. Escolha o tipo de pergunta conforme minhas necessidades: predicate para sim ou não; choice para uma opção entre várias; score para um grau. Coloque todas as perguntas no array questions da mesma requisição e defina um name em cada pergunta. 6. As opções de choice devem cobrir todos os casos; adicione uma opção "nenhuma das anteriores" e escreva uma description para cada opção. 7. Leia os resultados pelo name. Em choice e score, use confidence para decidir se a ação é automática; em predicate, use probability. Defina o limiar inicialmente como 0.7, como item de configuração, para facilitar ajustes futuros. O que ficar abaixo do limiar vai para revisão humana ou para um fluxo alternativo. 8. Para campos e erros, a referência é https://ofox.ai/pt/docs/api/decisions ; para o uso, consulte https://ofox.ai/pt/docs/develop/models/jev . [Passo 4: testar] 9. Execute uma vez cada um de 3 exemplos claros e 2 exemplos ambíguos e me mostre a resposta, a probabilidade e a confiança de cada um. 10. Em caso de erro, imprima o código de status HTTP, error.message e request_id, consulte a tabela de erros da documentação e altere apenas uma coisa antes de tentar de novo; se o mesmo erro continuar após duas correções, pare e me passe o texto exato do erro e o request_id.
Migração da TypeSafe
Em projetos que utilizam o SDK oficial da TypeSafe ou cujo código foi escrito com base na documentação oficial da TypeSafe, basta alterar a URL base para https://api.ofox.ai/typesafe e substituir a API Key por uma API Key da OfoxAI:
export TYPESAFE_BASE_URL="https://api.ofox.ai/typesafe"
export TYPESAFE_API_KEY="$OFOX_API_KEY"As requisições são enviadas a /typesafe/v1/systemone, no mesmo formato da API oficial da TypeSafe (state e questions indexadas pelo ID da pergunta; o tipo de pergunta de sim ou não é noul). A comparação entre os dois formatos e os exemplos do SDK constam em Decisions API · Formato nativo da TypeSafe. Para projetos novos, recomenda-se utilizar diretamente /v1/decisions.