무엇을 하는가
공식 JavaScript SDK는 JavaScript 및 TypeScript 애플리케이션을 TypeSafe의 API에 연결합니다. 타입이 지정된 질문 도우미를 사용하면 답변 유형이 직접 정의한 질문을 따르므로, 응답을 분석해야 하는 문단으로 취급하지 않고 선택된 범주를 프로그램의 나머지 부분에서 사용할 수 있습니다.
웹 제품에서는 이 호출을 보통 서버에서 처리합니다. 브라우저가 사용자의 요청을 애플리케이션에 제출하면 서버가 Jev를 호출하고, 인터페이스가 결과 제안을 표시합니다. 이 경계를 명확히 유지하면 API 키가 브라우저 번들에 포함되는 것도 막을 수 있습니다.
누구에게 적합한가
이미 JavaScript 백엔드를 운영하는 팀이라면 간단하게 선택할 수 있습니다. 제안 리드 범주나 지원 대기열처럼 기존 코드와 함께 하나의 집중된 결정을 제품에 추가해야 할 때 잘 맞습니다. 팀에서 이미 여러 제공업체를 대상으로 AI SDK를 사용하고 있다면 해당 통합도 비교해 보세요. 가장 직접적인 클라이언트보다 공유 규칙이 더 중요할 수 있습니다.
익숙할 만한 상황
웹사이트 문의 양식으로 제휴 제안과 고객 문의를 모두 받는다고 가정해 보겠습니다. 서버에서 Jev에 문의의 의도를 추정하게 한 뒤, 받은 편지함을 처리하는 담당자에게 추천 목적지를 보여 줄 수 있습니다. 검토자는 원래 문의 내용도 계속 확인할 수 있어야 하며 범주를 변경할 수도 있어야 합니다.
방문자가 같은 양식을 두 번 제출한다면 자체 요청 식별자를 사용해 중복 기록을 방지하세요. 모델 응답은 이 제어를 대신하지 않습니다. 마찬가지로 요청이 긴급하다고 판단하는 것만으로 메시지 발송이나 계정 변경 권한을 부여해서는 안 됩니다.
합리적인 첫 설정
- 현재 런타임 요구 사항을 확인하고 서버 프로젝트에 @typesafe-ai/sdk를 설치하세요.
- 배포 환경에서 API 키를 불러오고 클라이언트 측 코드에는 포함하지 마세요.
- 의미 있는 범주의 짧은 목록을 정의한 다음 공식 클라이언트를 사용해 샘플을 보내세요.
- 서비스를 사용할 수 없거나 분류가 불확실할 때 표시할 대체 경로를 추가하세요.
- 결과가 추가 작업을 실행하도록 허용하기 전에 양식 제출부터 검토까지의 전체 흐름을 테스트하세요.
선택하기 전에 따져볼 점
타입 추론은 개발 중 필드 불일치를 찾는 데 도움이 되지만, 잘못 정의된 비즈니스 범주까지 찾아 주지는 않습니다. 결과의 구조가 올바르더라도 문의가 잘못된 팀으로 전달될 수 있습니다. 검토용 샘플을 유지하고, 의도가 섞인 메시지와 철자 오류가 있는 메시지, 고객이 사용하는 언어로 작성된 메시지를 테스트하세요.
결정을 기다리느라 대화형 페이지를 무기한 열어 두지 마세요. 분류에 너무 오래 걸리면 문의를 저장하고 사용자가 계속 진행하도록 하세요. 애플리케이션은 나중에 분류를 완료할 수 있습니다.
계정 및 실행 비용
SDK는 서비스에 접근하는 방법이지 모델 호출 잔액이 포함된 상품이 아닙니다. 적절한 API 액세스 권한이 필요하며 호스팅 비용은 추론 요금과 별도로 발생합니다. 요청마다 보내는 텍스트의 양과 실제 호출 횟수를 기준으로 비용을 비교하세요. 새로 고침이나 양식 재제출 때문에 변경되지 않은 내용을 불필요하게 다시 분류해서는 안 됩니다.