함수 -> 도구 스키마 (내부 검사)
도구 호출(함수 호출이라고도 해요)은 모델이 내 프로그램에게 함수를 실행해 달라고 할 수 있게 해요: 도구 묶음을 알리면, 모델이 도구 이름과 인자로 답하고, 내가 그것을 실행해요. 하지만 모델은 내 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에 넣으세요.
이 연습은 곧 열려요
앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.
이 브라우저가 learn.floati.life의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.