Week 2 · Day 12/30

Tool Calling Mastery

Schema design, error recovery, validation, dynamic tool discovery

📅 2026-03-15 ⏱️ 6-7 hodín 📊 Agent Systems
Celkový progres 40%

🎯 Cieľ dňa

Navrhnúť robustné tool schemas s Pydantic validáciou, error recovery pipeline, a dynamic tool discovery pre scale.

core practice

📚 Study Resources

🔵

Anthropic — Tool Use with Claude

Oficiálna dokumentácia: definuj operácie a return types; Claude rozhodne kedy a ako volať.

docs
🟢

OpenAI — Function Calling

Referencia: strict mode, JSON Schema, SDK integrácia s Pydantic/Zod.

docs
📖

OpenAI Tool JSON Schema Explained

Detail: parameter types, descriptions, enums, nested objects, common mistakes.

article
📋

MCP Tools Specification (Nov 2025)

MCP spec pre tool definície. Interoperabilné agenty v 2025-2026.

spec

💡 Key Concepts

Schema Design — JSON Schema s additionalProperties: false, strict: true. Required vs optional. Enum constraints.
Structured Outputs — Pydantic modely (Python), Zod (TypeScript) pre garantovaný schema-compliant JSON
Error Recovery Pipeline — Validate → Execute → Handle errors → Feed back to LLM → Retry s adjusted params
Tool Description Quality — LLM rozhoduje podľa mena a description. Zle popísané tools sa zneužívajú alebo ignorujú.
Dynamic Tool Discovery — Pri 50+ tools nemôžeš všetko do promptu. MCP alebo vector-based tool registry.

🔧 Praktické cvičenie

Navrhni tool suite pre customer support agenta.

  1. Vytvor 5-6 tools: lookup_order, check_inventory, initiate_refund, escalate_to_human, search_knowledge_base
  2. Napíš JSON Schema pre každý tool
  3. Implementuj validáciu s Pydantic
  4. Pridaj error handling — errors feedbackuj do LLM
  5. Testuj edge cases: invalid IDs, missing params, API timeouts