프로젝트 연동

현재 프로젝트에 OfoxAI의 Jev 판단 모델을 연동하고 싶습니다. OfoxAI 콘솔에서 API Key는 이미 만들었습니다. 한 단계씩 안내해 주시고, 각 단계마다 무엇을 하는지, 다음 단계는 무엇인지 먼저 알려 주십시오.

【1단계: Key를 안전하게 저장하기】
1. 프로젝트에 .env 파일을 만들고 OFOX_API_KEY= 한 줄을 쓰되, 등호 뒤는 비워 두십시오. .env를 .gitignore에 추가하십시오.
2. 파일 위치를 알려 주시면 제가 직접 Key를 붙여 넣고 저장하겠습니다. 대화에서 Key를 보내 달라고 하지 마시고, Key를 코드에 쓰거나 출력하지도 마십시오.
3. 제가 「입력했습니다」라고 말할 때까지 기다린 뒤 진행하십시오.

【2단계: 내가 하려는 판단】
- 판단할 콘텐츠: 【예: 사용자가 제출한 고객 지원 티켓 텍스트】
- 답해야 할 질문: 【예: 어느 팀에 배정할지(결제·환불 / 기술 장애 / 구매 전 문의), 긴급한지】
- 결과를 받은 뒤 할 일: 【예: 신뢰도가 충분히 높으면 자동 배정하고, 그렇지 않으면 사람에게 넘김】

【3단계: 코드 작성】
4. OpenAI 공식 SDK를 사용하십시오(먼저 pip install -U openai를 실행하십시오. 이전 버전에는 client.decisions가 없습니다). base_url은 https://api.ofox.ai/v1이고, Key는 .env의 OFOX_API_KEY에서 읽으며, client.decisions.create()를 호출하고 모델은 typesafe/jev-latest를 사용합니다.
5. 요구 사항에 따라 질문 유형을 고르십시오. 예인지 아닌지는 predicate, 몇 개의 선택지 중 하나는 choice, 정도의 높고 낮음은 score를 사용합니다. 모든 질문은 같은 요청의 questions 배열에 넣고, 모든 질문에 name을 쓰십시오.
6. choice 선택지는 모든 경우를 포괄해야 하며, 「해당 없음」 선택지를 추가하십시오. 모든 선택지에 description을 쓰십시오.
7. 결과는 name으로 읽으십시오. 자동 실행 여부는 choice와 score는 confidence로, predicate는 probability로 판단합니다. 임곗값은 우선 0.7로 두고, 나중에 조정하기 쉽도록 설정 항목으로 만드십시오. 임곗값보다 낮은 건은 사람 검토나 대체 처리로 넘기십시오.
8. 필드와 오류는 https://ofox.ai/ko/docs/api/decisions 를 기준으로 하고, 사용법은 https://ofox.ai/ko/docs/develop/models/jev 를 참고하십시오.

【4단계: 테스트】
9. 명확한 샘플 3건과 애매한 샘플 2건으로 각각 한 번씩 실행하고, 각 건의 답, 확률, 신뢰도를 표로 보여 주십시오.
10. 오류가 나면 HTTP 상태 코드, error.message, request_id를 출력하고, 문서의 오류 표와 대조해 한 곳만 고친 뒤 다시 시도하십시오. 같은 오류를 두 번 고쳐도 해결되지 않으면 멈추고 오류 원문과 request_id를 알려 주십시오.