State + Questions — 실제 코드로 호출하기

입력은 단 두 가지, state와 questions

• state — 판단의 대상이 되는 문맥입니다. 텍스트, 구조화 데이터, 메시지 무엇이든 됩니다
• questions — 그 상태에 대해 묻고 싶은 질문들. 각 질문에 타입(noul/choice/score)과 instructions를 답니다
• 응답은 질문 키마다 타입이 정해진 값이 채워져 돌아옵니다 — 파싱·검증 불필요

💡 "무엇을 볼지(state)"와 "무엇을 물을지(questions)"를 분리한 게 전부입니다. 나머지는 JEV가 알아서 병렬로 채웁니다.

지원 티켓에 "긴급한가?"를 묻는다

고객 메시지 원문을 state에 그대로 넣고, "긴급한가?"를 noul 질문 하나로 던집니다. 아래가 그 실제 요청(JSON)과 응답입니다.

// 상태 하나 + noul 질문 하나
{
  "state": "Hi, I've been trying to
     connect my Stripe account
     for 3 days...",
  "questions": {
    "is_urgent": {
      "type": "noul",
      "instructions": "The message conveys
        urgency or time-sensitivity"
    }
  }
}

{
  "is_urgent": { "noul": 0.999 }
}

• state에 고객 메시지 원문을 그대로 넣고, is_urgent라는 이름의 noul 질문 하나를 던졌습니다
• 응답의 noul: 0.999는 "긴급함이 참일 확률 99.9%"라는 뜻 — 코드는 이 숫자 하나로 분기하면 됩니다
• 키 이름(is_urgent)이 그대로 응답 키가 되므로, 여러 질문을 넣어도 어느 답이 어느 질문인지 명확합니다

파이썬 코드에서 한 줄로 부른다

아래 코드는 앞의 JSON 호출을 파이썬 객체로 옮긴 것입니다 — 분류기를 만들고, state와 questions를 넘기고, 답을 꺼내는 세 단계가 전부입니다.

from langchain_typesafe import Noul, TypeSafeClassifier

classifier = TypeSafeClassifier()

response = classifier.invoke({
    "state": "The deploy failed twice and customers are seeing 500s...",
    "questions": {
        "urgent": Noul(instructions="Does this need attention now?")
    }
})

urgency = response.nouls["urgent"].noul   # → 0~1 사이 확률

• TypeSafeClassifier를 만들고 invoke()에 state와 questions를 넘기면 끝입니다
• 질문은 Noul(instructions=...) 객체로 선언 — instructions에 "무엇이 참이면 되는지"를 자연어로 적습니다
• 결과는 response.nouls["urgent"].noul로 꺼내 씁니다. 타입이 정해진 파이썬 값이라 바로 로직에 넣습니다

질문을 늘려도 지연은 거의 그대로

Choice·Score·Noul을 한 요청에 섞어 넣으면 모두 같은 상태를 공유하며 병렬로 평가됩니다. 그래서 질문을 1개에서 여러 개로 늘려도 응답 시간은 거의 변하지 않고, 추가 비용은 토큰뿐입니다.

병렬 평가라 막대가 거의 늘지 않습니다. LLM으로 질문을 순차 처리하면 개수에 비례해 폭증합니다.

# 응답의 confidence로 곧장 분기
if response.nouls["urgent"].noul > 0.9:
    route_to_oncall()      # 확신 높으면 자동 처리

3-2강 한 장 요약

• ✓
  입력은 state(문맥) + questions(질문들) 두 가지뿐, 응답은 타입 있는 값으로 채워짐
• ✓
  JSON은 {"type":"noul","instructions":...} → {"noul":0.999} · LangChain은 Noul(...) → .nouls[k].noul
• ✓
  여러 질문을 mix하면 병렬 평가 → 지연 거의 불변, 추가 비용은 토큰뿐. confidence로 바로 분기