글이 아니라 판단.

결은 한국어 문장을 읽고 유형이 정해진 질문에 답합니다. 선택지 중 하나를 고르거나, 참/거짓을 말하거나, 순서가 있는 척도 위에 놓습니다. 모든 답에는 허용된 선택지 각각의 확률이 붙습니다. 자유 텍스트를 쓰지 않으므로 파싱할 것도, 지어낼 것도 없습니다.

한 요청은 state(판단할 문장) 하나와 질문 최대 32개를 담습니다. 문장은 한 번만 읽고 질문은 함께 답합니다. 질문 네 개가 서버에서 약 85ms입니다.

빠른 시작

1. /console에서 Google로 로그인하고 키를 만듭니다(무료: 하루 1,000 결정). 2. 요청을 보냅니다.

curl -X POST https://gyeol.pltt.dev/v1/systemone \
  -H "Authorization: Bearer gk_..." -H "Content-Type: application/json" \
  -d '{
  "state": "배송이 3일째 물류센터에 멈춰 있어요. 오늘 안에 출발 안 되면 취소하고 환불받을게요.",
  "questions": {
    "team":    {"type": "choice", "instructions": "이 문의를 처리할 팀은?",
                "criteria": {"배송": "배송 지연·추적", "환불": "취소·환불 처리", "기타": null}},
    "cancel":  {"type": "noul",   "instructions": "고객이 취소 의사를 밝혔는가?"},
    "urgency": {"type": "score",  "instructions": "긴급도를 평가하라.",
                "criteria": ["기한 없음", "며칠 내", "명확한 기한 있음", "오늘 안에 처리 필요"]}
  }}'

# pip install requests · SDK 파일: https://gyeol.pltt.dev/sdk/gyeol.py
from gyeol import Gyeol
g = Gyeol("gk_...")
r = g.decide("배송이 3일째 물류센터에 멈춰 있어요. 오늘 안에 출발 안 되면 취소하고 환불받을게요.", {
    "team":    g.choice("이 문의를 처리할 팀은?", {"배송": "배송 지연·추적", "환불": "취소·환불 처리", "기타": None}),
    "cancel":  g.noul("고객이 취소 의사를 밝혔는가?"),
    "urgency": g.score("긴급도를 평가하라.", ["기한 없음", "며칠 내", "명확한 기한 있음", "오늘 안에 처리 필요"]),
})
print(r["team"].choice, r["team"].probabilities)   # 배송 {'배송': 0.99, '환불': 0.01, '기타': 0.0}
print(r["cancel"].noul)                             # 0.99
print(r["urgency"].score, r["urgency"].confidence)  # 2.6 0.55

import { Gyeol } from "https://gyeol.pltt.dev/sdk/gyeol.js";   // Node 18+ / browser
const g = new Gyeol({ apiKey: "gk_..." });
const r = await g.decide("배송이 3일째 물류센터에 멈춰 있어요. 오늘 안에 출발 안 되면 취소하고 환불받을게요.", {
  team:    Gyeol.choice("이 문의를 처리할 팀은?", { "배송": "배송 지연·추적", "환불": "취소·환불 처리", "기타": null }),
  cancel:  Gyeol.noul("고객이 취소 의사를 밝혔는가?"),
  urgency: Gyeol.score("긴급도를 평가하라.", ["기한 없음", "며칠 내", "명확한 기한 있음", "오늘 안에 처리 필요"]),
});
r.team.choice; r.cancel.noul; r.urgency.score; r.urgency.probabilities;

세 가지 질문 유형

질문은 서로 독립적으로 채점됩니다. 한 답이 다른 답을 볼 수 없습니다. 어떤 선택지도 맞지 않을 수 있다면 “해당 없음” 선택지를 넣으세요.

응답 형식

{
  "model": "gyeol-ax-v2b",
  "answers": {
    "team":    {"type": "choice", "choice": "배송", "probabilities": {"배송": 0.993, "환불": 0.006, "기타": 0.001}, "confidence": 0.99},
    "cancel":  {"type": "noul",   "noul": 0.998, "probabilities": {"true": 0.998, "false": 0.002}, "confidence": 0.996},
    "urgency": {"type": "score",  "score": 2.55, "probabilities": {"0": 0.009, "1": 0.089, "2": 0.242, "3": 0.659},
                "legend": {"0": "기한 없음", "1": "며칠 내", "2": "명확한 기한 있음", "3": "오늘 안에 처리 필요"}, "confidence": 0.545}
  },
  "usage":  {"input_tokens": 1522, "shared_prefix_tokens": 501, "output_tokens": 3},
  "timing": {"total_ms": 84.1, "per_question_ms": 21.0}
}

확신도와 임계값

K개 선택지에서 confidence는 (K·p_max − 1)/(K − 1)입니다. 확실하면 1.0, 선택지가 팽팽하면 0. 저희 보류 세트에서 확신도 상위 절반만 남기면 일치율이 0.87에서 0.97로 올랐습니다. 임계값은 반드시 자기 데이터로 재고 쓰세요.

SDK

빌드 없이 파일 하나짜리 SDK 둘: gyeol.py(requests 필요)와 gyeol.js(ESM, Node 18+ 또는 브라우저, 타입은 gyeol.d.ts). 둘 다 choice / noul / score 빌더, decide(), 사용량용 me()를 제공합니다. 키 없이 쓰면 놀이터 엔드포인트(주소당 하루 300)로 갑니다.

한도와 요금

요청당 질문 32개, 선택형 선택지 26개, 척도 단계 2~10개, 12,288 토큰. 한도를 넘으면 429와 안내 문구를 돌려주며, 조용히 잘라내는 일은 없습니다.

좋은 질문 쓰기

• 선택지 이름만이 아니라 언제 그 선택지가 맞는지를 쓰세요. 모델은 그 설명을 읽습니다.
• 척도 단계는 낮은 것부터 높은 것으로, 각 단계 기준을 구체적으로(“오늘 안에”, “이번 주”).
• state는 데이터로만 취급됩니다. state 안의 지시문은 따르지 않습니다.
• 날짜와 계산: 합계가 아니라 비교를 주세요. 모델은 읽지, 계산하지 않습니다.

법적 안내

결의 출력은 확률이 붙은 라벨이지 생성 콘텐츠가 아니므로 인공지능기본법의 생성물 표시 의무는 적용되지 않습니다. 채용·대출심사·공공서비스 이용 결정 등 고영향 영역에 쓰면 이용자에 대한 사전 고지 의무가 있습니다. 기반 모델은 SKT A.X-4.0-Light입니다.