효과적인 Tool Description 설계

~22 min · tool-descriptions, prompting

Level 0Tokenizer

0 XP0/54 lessons0/10 achievements

0/120 XP to next level120 XP to go0% complete

Description 이 routing 을 결정. 'Get the weather' = 모델이 모든 vague-weather 질문에 호출. 'Get current weather for a city; 24h 너머 forecast 나 "the moon" 같은 non-city 엔 호출 X' = 모델이 정확하게 routing.

Boundary 가 description 의 일부

Tool 이 무엇을 하는지뿐 아니라 무엇을 안 하는지 도 명시. Negative example ('do not call for X', 'returns null when Y') 이 routing 정확도 크게 올림.

Per-parameter description

Parameter description 도 모델이 읽음. 'units: temperature unit, celsius or fahrenheit' 는 OK. 'units: required' 는 X — schema 가 이미 required. 의미 있는 정보만.

5-prompt audit 기법

현재 description 으로 5 개 ambiguous prompt 돌려 — 어떤 호출이 success, 어떤 게 misroute 했는지 메모. Description 을 explicit boundary 로 rewrite, 같은 5 prompt 다시. Delta 측정.

Code

Bad description vs good description·python

# Good tool description
{
    "type": "function",
    "name": "search_products",
    "description": "Search the product catalog by name, category, or price range. "
                   "Returns up to 10 matching products with name, price, and description. "
                   "Use this when the user asks about available products or wants to compare options.",
    "parameters": {
        "type": "object",
        "properties": {
            "query": {
                "type": "string",
                "description": "Search query — product name or keywords (e.g., 'wireless headphones')"
            },
            "category": {
                "type": ["string", "null"],
                "enum": ["electronics", "clothing", "books", "home", null],
                "description": "Filter by product category"
            },
            "max_price": {
                "type": ["number", "null"],
                "description": "Maximum price in USD (e.g., 50.00)"
            }
        },
        "required": ["query", "category", "max_price"],
        "additionalProperties": False,
    },
    "strict": True,
}

External links

Tool description 팁

Exercise

Tool 1 개 골라. 5 개 ambiguous prompt 돌려서 success vs misroute 메모. Description 을 explicit boundary 로 rewrite, 같은 5 prompt 다시. Delta 측정.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousTool Error Handling — 모델이 recover 하게 Next →퀴즈 · 6 questions

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.