Decisions

POST /v1/systemone은 하나의 state를 명명된 질문들에 대해 평가하고 질문당 하나의 타입이 지정된 답변을 반환합니다. 응답은 동기식 JSON 형식입니다: 코드에서 비교하고 분기할 수 있는 확률, 옵션 이름 또는 점수를 포함합니다. 생성된 텍스트는 반환하지 않습니다.

Decisions와 Chat 비교Copy Anchor Link

Decision 엔드포인트는 messages, tools, stream 또는 기타 채팅 제어 기능을 허용하지 않으며, Batch에서는 사용할 수 없습니다. 메인 채팅 모델은 별도로 구성하십시오.

모델 선택Copy Anchor Link

curl "https://api.tokenlab.sh/v1/models?recommended_for=decision" \
  -H "Authorization: Bearer sk-your-api-key"

category=decision으로 필터링할 수도 있습니다. 요청을 보내기 전에 선택한 모델에 대해 GET /v1/models/{model}을 읽고, 모델 ID를 명시적으로 보내십시오. 이 페이지의 예제는 jev-1.13을 사용합니다.

요청 형태Copy Anchor Link

instructions와 각 기준(criterion)은 문자열, JSON 객체 또는 JSON 배열도 허용합니다. 요청 시 알 수 없는 필드는 거부됩니다.

티켓 평가Copy Anchor Link

curl https://api.tokenlab.sh/v1/systemone \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "I was charged twice. Please refund the duplicate payment.",
    "questions": {
      "refund_requested": {"type": "noul", "instructions": "Is a refund requested?"},
      "department": {
        "type": "choice", "instructions": "Which team should handle this?",
        "criteria": {"refunds": "Charges and refunds", "technical": "Software bugs"}
      },
      "urgency": {
        "type": "score", "instructions": "Rate urgency",
        "criteria": ["Routine enquiry", "Money affected", "Safety emergency"]
      }
    }
  }'

응답은 질문 이름을 answers 아래에 유지합니다. 아래 값은 예시입니다:

{
  "model": "jev-1.13",
  "answers": {
    "refund_requested": {"type": "noul", "noul": 0.97},
    "department": {"type": "choice", "choice": "refunds"},
    "urgency": {"type": "score", "score": 1}
  },
  "usage": {"input_tokens": 96, "output_tokens": 12}
}

답변 사용Copy Anchor Link

• 모든 질문은 동일한 이름 아래 동일한 type의 답변을 받습니다.
• noul 답변은 Boolean이 아닌 확률입니다. 각 작업에 대해 고유한 임계값을 선택하십시오.
• choice 답변은 항상 전송한 옵션 이름 중 하나입니다.
• score 답변은 criteria 배열을 인덱싱합니다: 위 예시에서 1은 'Money affected'를 의미합니다.
• 환불, 에스컬레이션 또는 기타 작업을 수행하기 전에 자체 레이블이 지정된 케이스를 대상으로 Decision을 테스트하십시오.

MCP에서 사용Copy Anchor Link

TokenLab MCP server는 core 및 full 프로필에서 evaluate_decisions를 노출합니다. 먼저 {"category":"decision"}과 함께 list_models를 호출하고 get_model을 호출한 다음, 동일한 model, state, questions를 도구 인수로 전달하십시오. 결과에서 structuredContent.answers와 structuredContent.usage를 읽으십시오. 이 도구는 동기식 결과를 반환하며 비동기 작업 폴링을 사용하지 않습니다.

SDK에서 사용Copy Anchor Link

TokenLab JavaScript SDK 0.1.2+는 evaluateDecisions(body)를 제공하며, Python SDK 0.1.2+는 evaluate_decisions(body)를 제공합니다. 본문(body)은 HTTP 요청과 동일한 JSON입니다. 두 SDK 모두 타입이 지정된 답변과 사용량을 유지하며 실패한 요청을 자동으로 재시도하지 않습니다. SDKs를 참조하십시오.

비용 및 재시도Copy Anchor Link

• Decision은 응답의 usage.input_tokens 및 usage.output_tokens를 기준으로 모델의 현재 토큰 가격에 따라 과금됩니다.
• 가격은 변경될 수 있습니다. 가격을 하드코딩하는 대신 모델의 가격 세부 정보나 Pricing API를 확인하십시오.
• 모델은 출력 가격이 0인 경우에도 출력 토큰을 보고할 수 있습니다.
• 요청은 귀하의 배송 옵션을 따릅니다. 청구 및 가격 책정을 참조하십시오.
• 타임아웃 발생 시 결과가 불확실할 수 있습니다. 유료 요청을 다시 보내기 전에 로그나 콘솔에서 요청 상태를 확인하십시오.

일반적인 오류Copy Anchor Link

API 참조Copy Anchor Link