Jev 실전 가이드

01 / 소프트웨어 내부의 작은 의사결정

고객 지원 메일함을 생각해 보세요. 소프트웨어는 가용한 팀을 알고 있지만, 고객의 메시지를 이해해야 합니다. Jev는 팀을 선택하거나, 긴급도를 평가하거나, 정의한 척도에 따라 메시지 점수를 매길 수 있습니다. 그 후 코드가 라우팅 규칙을 적용합니다. 모델은 판단을 제공할 뿐, 행동을 직접 실행하지는 않습니다.

Jev는 현재 JSON 및 텍스트 배열을 포함한 텍스트를 입력받습니다. 이미지를 보거나, 오디오를 듣거나, 산문을 생성하거나, 코드를 작성하지 않습니다. 이미지 기반 데모를 위해서는 먼저 이미지를 사용 가능한 텍스트나 구조화된 관찰 결과로 변환하는 다른 구성 요소가 필요합니다.

공식 출처 읽기

02 / 왜 다른 종류의 모델을 만드는가?

TYPESAFE의 목표는 좁은 범위의 AI 판단을 일반 소프트웨어의 유용한 구성 요소처럼 작동하게 만드는 것입니다. RLCD 학습 방식은 의사결정과 보정된 불확실성에 초점을 맞춥니다. 자유 형식의 텍스트 생성을 포기함으로써 다른 인터페이스가 가능해졌습니다. 즉, 애플리케이션이 답변 공간을 정의하고 결과를 결합하는 방식입니다.

유효한 출력 형태가 답변이 사실임을 증명하는 것은 아닙니다. 자신의 예시를 통해 오류를 평가하고, 중요한 작업은 명시적인 애플리케이션 규칙 뒤에 배치하십시오.

공식 출처 읽기

03 / 세 가지 질문 방식

Choice

청구, 기술 지원, 영업 등 제공한 세트에서 하나의 옵션을 선택합니다. 응답에는 선택된 옵션과 옵션별 분포가 포함됩니다.

Score

차분함, 좌절함, 매우 좌절함과 같이 순서가 있고 설명 가능한 수준에 관찰 결과를 배치합니다. 반환된 점수는 수준 사이의 값을 가질 수 있으며, 일반적인 정확도 확률은 아닙니다.

Noul

진술이 참인지 묻습니다. Noul은 0에서 1 사이의 '예'에 대한 확률을 반환합니다. 동시에 참일 수 있는 레이블에 대해서는 별도의 질문을 하십시오.

공식 출처 읽기

행동하기 전에 신뢰도를 읽어보세요

Choice와 Score는 확률과 분포에서 파생된 별도의 신뢰도 값을 반환합니다. 선택된 옵션의 확률과 신뢰도는 서로 다른 숫자입니다. Noul은 확률만 있으며 별도의 신뢰도 필드는 없습니다.

교육용 예시 · 고정 신뢰도 0.72

0.72confidence추가 정보를 모으거나 검토 요청

임계값

0.80

임계값을 움직이면 코드의 처리 경로가 바뀝니다. 고정된 교육용 예시이며 실제 Jev 예측이나 권장 기준값이 아닙니다. 잘못 판단했을 때의 영향을 고려해 기준을 검증하세요. 기준을 넘더라도 별도의 권한 확인은 필요합니다.

신뢰도 이해하기

04 / Jev와 LLM은 서로 다른 역할을 합니다

이는 인터페이스의 차이일 뿐, 특정 모델이 모든 작업에서 우월하다는 주장이 아닙니다. LLM의 성능과 지연 시간은 모델, 설정, 도구 및 입력에 따라 다릅니다.

공식 출처 읽기

05 / 상호작용에 충분히 빠른 속도

TYPESAFE의 9월 15일 출시 게시물은 의사결정 형태의 호출에 대해 이 범위를 보고합니다. 또한 게시된 평가는 일반적으로 미국 서부 해안에서 실행되었음을 명시합니다. 이는 벤더가 보고한 스냅샷이며, JEVLAB 벤치마크나 귀하의 위치에 대한 지연 시간 보장이 아닙니다.

공식 출처 읽기

동일한 상태에 대해 독립적인 질문을 함께 하십시오. Jev는 이를 병렬로 평가합니다. 이는 별도의 호출 체인을 피할 수 있게 하지만, 질문이 많아지면 입력 토큰이 늘어나며 요청 제한을 준수해야 합니다. 질문이 이전 답변에 의존하는 경우에는 나중에 호출해야 합니다.

공식 출처 읽기

TYPESAFE의 워크플로우 평가는 전체 워크플로우를 비교합니다. 참조 레이블은 사람이 정한 정답 세트가 아니라 모델이 생성한 합의 레이블입니다. 속도나 정확도 주장을 채택하기 전에 방법을 읽고 자신의 사례를 테스트하십시오.

공식 출처 읽기

06 / 첫 번째 호출 만들기

1. 로그인 없이 Decision Lab에서 요청 예시를 살펴보세요. 실제 모델 호출을 실행하려면 TypeSafe의 Playground를 열고 로그인한 뒤, 짧은 상태 정보와 명확한 질문으로 시작하세요.
2. TypeSafe 콘솔에서 API 키를 생성하세요. API 키는 서버나 로컬 환경 변수에 보관해야 하며, 브라우저 코드나 공개 저장소에 절대 노출해서는 안 됩니다.
3. API를 직접 호출하거나 공식 JavaScript 또는 Python SDK를 사용하세요. 아래 예시는 설명을 위한 요청이며, 이 페이지에서 직접 요청을 수행하지는 않습니다.
4. 대표적인 예시를 수집하고, 모델 버전을 기록하며, 오류와 종단 간 지연 시간을 측정하세요. 또한 조치를 취하거나 검토를 요청할 시점을 결정하세요. 확률 또는 신뢰도 Score는 승인을 의미하지 않습니다.

공식 웹사이트Playground 및 API 키API 참조공식 SDK

POST https://api.typesafe.ai/v1/systemone
Authorization: Bearer $TYPESAFE_API_KEY
Content-Type: application/json

{
  "state": {
    "message": "I cannot sign in to my account."
  },
  "model": "jev-latest",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should handle this message?",
      "criteria": {
        "billing": "Payments or invoices",
        "support": "Account access or technical problems",
        "sales": "Pricing or product questions"
      }
    }
  }
}

공식 출처 읽기

Decision Lab / 요청을 직접 만들어 보세요

작업을 선택하고 텍스트를 수정하세요. 브라우저에서 요청이 즉시 변경됩니다. 이는 교육용 템플릿이며 실제 모델 결과가 아닙니다. API 키나 로그인이 필요하지 않습니다.

{
  "model": "jev-latest",
  "state": "I need help signing in after changing my phone.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Choose the team that can best help with the message in state. Use other when none fits.",
      "criteria": {
        "accounts": "Sign-in or account access",
        "billing": "Charges, invoices or subscriptions",
        "other": "Another issue, or not enough information"
      }
    }
  }
}

다음 단계: 서버에 보관한 API 키로 이 본문을 POST /v1/systemone에 보내면 됩니다. 실제 호출에는 TypeSafe 계정이 필요합니다. 이 실습 페이지는 키를 받거나 입력 내용을 모델에 전송하지 않습니다.

API 참조

배포 전 / 반드시 확인해야 할 4가지

형식이 올바른 답도 판단은 틀릴 수 있습니다. 데모의 성공 사례와 함께 공식 문서의 한계도 확인하세요.

공식 문서의 Jev 1.13 한계와 실패 사례 읽기

다음에 확장해 볼 패턴

• 의도 라우팅

  요청 의도에 맞는 처리기로 연결하고, 범위를 벗어나면 대체 경로로 보냅니다.

• 병렬 질문

  동일한 상태에 대해 독립적인 질문을 함께 수행하고, 의존성은 나중에 처리하세요.

• 복합 점수 매기기

  별도의 차원을 판단한 다음, 코드에서 제어하는 가중치를 사용하여 값을 결합하세요.

• 신뢰도 라우팅

  테스트된 임계값을 사용하여 진행할지, 더 많은 맥락을 수집할지, 검토를 요청할지 결정하세요.

07 / 시작을 위한 자료

이 참조 자료들을 가까이 두세요. 공식 문서가 API를 정의하며, 커뮤니티 프로젝트는 가능한 응용 사례를 보여줄 뿐 보증을 제공하지는 않습니다.

• 빠른 시작
• System One 모델 및 Jev 소개
• TypeSafe 선언문
• 신뢰도 이해하기
• 모델, 현재 가격 및 제한 사항
• 워크플로우 평가 및 방법론

JEVLAB 컬렉션에서

• JEVLAB ART
  typesafe-sdk-cpppewriebontal
• JEVLAB ART
  go-jevmattn
• JEVLAB ART
  jev-cookbookparamjeetn
• JEVLAB ART
  typesafe-sdk-rustzchee
• JEVLAB ART
  system-oneasynq-io
• JEVLAB ART
  jev-netbrightshore

함께 살펴볼 자료 모음

• Made with Jev

  개념 설명과 실제 구현 사례를 함께 볼 수 있습니다. 글 생성, 판단, 실행을 나누는 방법도 안내합니다.

• Jevable

  커뮤니티의 데모를 시각적으로 탐색할 수 있습니다. 원본을 보고 Jev에 실제로 어떤 입력을 보내는지 확인해 보세요.

• Awesome Jev

  공식 자료, 커뮤니티 SDK와 프로젝트를 구분한 폭넓은 목록입니다. 도구를 도입하기 전 원본 저장소를 확인하세요.

서로 독립적으로 운영되는 자료 모음입니다. 목록에 실렸다는 사실만으로 JEVLAB이 품질을 검증하거나 보증한 것은 아닙니다.

자주 궁금해하는 것들

모델, 현재 가격 및 제한 사항Jev는 챗봇인가요, 코딩 에이전트인가요?

08 / JEVLAB 사용 방법

JEVLAB은 원문 출처를 연결하는 독립적인 큐레이션 사이트입니다. TypeSafe AI가 운영하거나 공식 제휴한 사이트는 아닙니다. 첫 화면에서 실제 사례를 발견하고, 이 가이드에서 Jev의 개념과 활용 방법을 익힐 수 있습니다.

연구실 둘러보기에서 자료를 찾고 프로젝트·제작자·주제로 검색한 뒤 용도와 플랫폼으로 좁힐 수 있습니다. 데스크톱 사이드바는 따로 스크롤됩니다. Popular는 새 방문 시 자료를 섞고 Latest는 새로 추가된 자료부터 표시합니다. 두 모드 모두 개별 후원자 카드는 현재 90일 기간 안에서 확인된 순후원금이 양수인 프로젝트 전체에서 그 금액에 비례하는 확률로 뽑습니다. $0인 프로젝트는 뽑지 않습니다. 모든 대상이 한 번씩 뽑히기 전에는 같은 프로젝트를 다시 뽑지 않으며, 모두 뽑힌 뒤 새 라운드를 시작합니다.

GitHub 및 웹사이트 카드는 미리보기를 상단에 표시하며, 그 아래에 별도의 텍스트 레이아웃이 배치됩니다. 동영상은 더 넓은 프레젠테이션 형식을 유지합니다. 소스에서 지원되는 공개 지표를 제공하는 경우, 눈 아이콘은 조회수를, 별 아이콘은 수집 시점의 GitHub 스타 수를 의미하며, 둘 다 JEVLAB 클릭 수는 아닙니다. 지표가 없는 경우 공란으로 둡니다.

카드를 열면 자료 설명, 원문 링크, 저장 버튼이 나옵니다. 번역은 읽기를 돕는 자료이므로 맥락과 최신 사용법, 성능 수치는 작성자의 원문에서 확인해 주세요.

후원자는 모든 언어에서 하나의 보드를 공유합니다. 스트립은 상위 10개, 사이드바는 상위 5개를 표시합니다. 자료 사이 개별 카드는 11위 이하와 $1 후원자를 포함한 현재 90일 기간 안에서 확인된 순후원금이 양수인 프로젝트 전체에서 그 금액에 비례해 뽑으며 한 라운드 안에서는 반복하지 않습니다. 후원자 명예의 전당에서 각 프로젝트의 현재 90일 합계를 확인하세요. 만료된 프로젝트는 $0으로 하단에 남고 후원 표시·추첨 대상에서 제외되며, 같은 URL에 새 후원이 확인되면 새 기간과 합계를 $0부터 시작합니다. 프로젝트 URL을 조회하고 메시지를 복사한 뒤 Buy Me a Coffee로 계속 버튼을 눌러 결제 화면의 메시지란에 붙여 넣고 후원할 수 있습니다. 후원금은 보드 순위와 앞쪽 카드에 뽑힐 가능성을 정하며 편집 품질을 뜻하지 않습니다. 노출은 보장하지 않습니다.

Live는 최근 활동 중인 방문자 추정치입니다. Total Visits는 모든 언어의 일별 방문 수 합계이며, 전체 기간의 고유 방문자 수가 아닙니다. 공개 방문·외부 클릭 수에는 운영자가 제공한 초기값과 이후 실제 집계가 포함됩니다.

연구실로 돌아가기Supporters