강의 계획 레슨 250개 중 140번째 · 구조화된 출력과 함수/도구 호출
구조화된 출력과 함수/도구 호출

함수 -> 도구 스키마 (내부 검사)

도구 호출(함수 호출이라고도 해요)은 모델이 내 프로그램에게 함수를 실행해 달라고 할 수 있게 해요: 도구 묶음을 알리면, 모델이 도구 이름과 인자로 답하고, 내가 그것을 실행해요. 하지만 모델은 내 Python을 볼 수 없어요 -> 스키마만 봐요: 각 도구의 이름과 매개변수의 JSON 설명이에요. 모든 함수의 스키마를 손으로 쓰는 건 지루하고, 시그니처를 바꾸는 순간 어긋나요. 해결책은 내부 검사예요: 함수에서 바로 스키마를 만들어요.

Python의 inspect 모듈은 실행 중에 함수의 시그니처를 읽어요. 도구 호출 API가 기대하는 스키마는 이렇게 생겼어요:

{
  "name": "get_weather",
  "parameters": {
    "type": "object",
    "properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
    "required": ["city"]
  }
}

정확히 그것을 만드는 tool_schema(func)를 만들어요. 두 가지 생각이 일을 다 해요:

  • Python 타입을 JSON 스키마 타입에 대응시키기. 각 매개변수의 주석을 읽고 번역하세요: int -> "integer", float -> "number", str -> "string", bool -> "boolean". 그 밖의 것은 기본으로 "string"이에요.
  • 기본값에서 required 끌어내기. 기본값이 없는 매개변수는 필수이고, 기본값이 있는 매개변수는 선택이에요. inspect.Parameter.empty가 "기본값 없음"의 표지예요.
import inspect
sig = inspect.signature(func)
for name, param in sig.parameters.items():
    is_required = param.default is inspect.Parameter.empty
    json_type = ...   # from param.annotation

도구 이름에는 func.__name__을 쓰세요. 주석이 다른 두 함수가 분명히 다른 두 스키마를 만들고, int 매개변수는 "integer"로, str은 "string"으로 나오고, 기본값이 있는 매개변수는 required에서 빠지고, 기본값이 없는 것은 들어가도록 만드세요. 모든 도구 호출 통합이 기대는 계약이에요.

내 차례

inspect.signature로 함수를 내부 검사해 {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}를 돌려주는 tool_schema(func)를 쓰세요. int->"integer", float->"number", str->"string", bool->"boolean"(기본 "string")으로 대응시키고, 매개변수는 기본값이 없을 때만 required에 넣으세요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.