Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Definovanie nástrojov v JSON

Lekcia 4 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Od teórie k praxi
  2. Štruktúra požiadavky s nástrojmi
  3. Kľúčové čísla implementácie
  4. Spracovanie odpovede tool_call
  5. Vykonanie a vrátenie výsledku
  6. Definovanie viacerých nástrojov
  7. Kontrola finish_reason
  8. Kľúčové poznatky

Od teórie k praxi

Teraz už chápeš koncept volania funkcií a štruktúru schém JSON. Je čas prejsť ku konkrétnej implementácii. V tejto lekcii sa naučíš, ako zostaviť kompletnú požiadavku s definíciami nástrojov a ako spracovať odpoveď modelu.

Štruktúra požiadavky s nástrojmi

Tu je kompletná požiadavka na API Grok s definovaným nástrojom:

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.x.ai/v1"
)

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get the current weather for a city",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "City name"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "default": "celsius"
                    }
                },
                "required": ["city"]
            }
        }
    }
]

response = client.chat.completions.create(
    model="grok-4.5",
    messages=[
        {"role": "user", "content": "What's the weather like in Paris?"}
    ],
    tools=tools
)

Všimni si vnorenú štruktúru: objekt tools obsahuje pole, kde každý prvok má typ type a objekt function s podrobnosťami.

Kľúčové čísla implementácie

200
Maximálny počet nástrojov na požiadavku
6
Podporované typy JSON
3
Kompatibilné SDK
1
Požiadavka = celý tok

Spracovanie odpovede tool_call

Keď sa model rozhodne zavolať funkciu, odpoveď obsahuje pole tool_calls:

message = response.choices[0].message

if message.tool_calls:
    for tool_call in message.tool_calls:
        print(f"Function: {tool_call.function.name}")
        print(f"Arguments: {tool_call.function.arguments}")
        print(f"ID: {tool_call.id}")

Pole tool_call.function.arguments je reťazec JSON (nie Python objekt). Musíš ho analyzovať:

import json

args = json.loads(tool_call.function.arguments)
city = args["city"]
unit = args.get("unit", "celsius")

Vykonanie a vrátenie výsledku

Po vykonaní funkcie pošleš výsledok späť modelu v druhom volaní:

import json

# 1. Vykonanie funkcie
weather_data = get_weather(city="Paris", unit="celsius")

# 2. Zostavenie správ s výsledkom
messages = [
    {"role": "user", "content": "What's the weather like in Paris?"},
    message,  # Odpoveď modelu s tool_calls
    {
        "role": "tool",
        "tool_call_id": tool_call.id,
        "content": json.dumps(weather_data)
    }
]

# 3. Opätovné volanie modelu s výsledkom
final_response = client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=tools
)

print(final_response.choices[0].message.content)

Správa s rolou tool musí obsahovať:

  • tool_call_id: jedinečný identifikátor tool_call (na prepojenie s požiadavkou)
  • content: výsledok ako reťazec JSON

Definovanie viacerých nástrojov

V poli tools môžeš deklarovať ľubovoľný počet nástrojov:

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get the current weather for a city",
            "parameters": { ... }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "search_restaurants",
            "description": "Search for restaurants by city and cuisine type",
            "parameters": { ... }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "book_table",
            "description": "Book a table at a restaurant",
            "parameters": { ... }
        }
    }
]

Model automaticky vyberie relevantný nástroj (alebo nástroje) na základe požiadavky používateľa.

Kontrola finish_reason

Pole finish_reason v odpovedi indikuje, či model dokončil svoju odpoveď, alebo čaká na výsledok nástroja:

finish_reason = response.choices[0].finish_reason

if finish_reason == "tool_calls":
    # Model čaká na výsledok jedného alebo viacerých nástrojov
    handle_tool_calls(response)
elif finish_reason == "stop":
    # Model dokončil svoju odpoveď
    print(response.choices[0].message.content)

Kľúčové poznatky

  • Požiadavka obsahuje messages a tools (definície)
  • Argumenty tool_call sú reťazec JSON, ktorý treba analyzovať
  • Výsledok pošli v správe s rolou tool vrátane tool_call_id
  • Skontroluj finish_reason, aby si zistil, či model čaká na výsledok
  • Môžeš deklarovať viacero nástrojov – model vyberie automaticky