Local Tool Calling 101

Tool calling이 뭐야

Tool calling (function calling)은 모델이 직접 답하는 대신 외부 함수 실행을 요청하게 해. 모델은 구조화된 request를 돌려줘 — 함수 이름이랑 인자. 네 코드가 그 함수를 실행해서 결과를 다시 보내면, 모델이 거기서부터 이어서 가. 이게 LLM이 말만 안 하고 행동하게 만드는 거야.

OpenAI 스타일 JSON Schema로 정의

Ollama는 호환성 위해 OpenAI tool 형식 사용:

각 tool은 type: "function"이랑 function 객체를 들고 있어.
function 안에는 name, description, parameters (JSON Schema)가 들어가고.
description은 모델이 이 tool 호출할지 결정할 때 읽는 거 — 신중한 1줄 docstring처럼 써.

모든 모델이 tool 지원하는 거 아님

Tool calling은 모델이 그렇게 학습됐어야 해. 안정적인 family: Qwen 2.5+ / 3 / 3.5, Llama 3.1+, Mistral / Mixtral, Command R, GPT-OSS, Qwen3-Coder. ollama show MODEL로 capability 확인 — capabilities 줄에서 tools 찾아.

Code

Tool 정의하고 모델 반환값 보기·python

import httpx, json

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city. Returns temperature and condition.",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "City name, e.g. 'Tokyo'"},
                "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
            },
            "required": ["city"],
        },
    },
}]

resp = httpx.post(
    "http://localhost:11434/api/chat",
    json={
        "model": "qwen2.5:7b",
        "messages": [{"role": "user", "content": "What's the weather in Tokyo right now?"}],
        "tools": tools,
        "stream": False,
    },
    timeout=120.0,
)

msg = resp.json()["message"]
print(json.dumps(msg, indent=2))
# 기대: 빈 content, tool_calls가 get_weather(city="Tokyo")로 채워짐

보내기 전에 tool capability 확인·bash

# Tool 지원 안 하는 모델한테 토큰 낭비하지 마
ollama show qwen2.5:7b | grep -i capabilities
# 봐야 할 것: list 안에 'tools'

# 'tools' 안 보이면 모델 업그레이드하거나 tools-capable variant 사용

Tool calling이 뭐야

OpenAI 스타일 JSON Schema로 정의

모든 모델이 tool 지원하는 거 아님

Code

External links

Exercise

Progress

댓글 0