Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Prilagođene funkcije (pozivanje funkcija)

Lekcija 11 od 16 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Poveži Grok sa svojim uslugama
  2. Kako to funkcionira
  3. Deklariraj funkciju
  4. Primi poziv funkcije
  5. Vrati rezultat
  6. Najbolje prakse za opise
  7. Rukovanje greškama
  8. Ključne točke

Poveži Grok sa svojim uslugama

Poslužiteljski alati (web_search, x_search, code_interpreter) su korisni, ali ograničeni na xAI usluge. Uz prilagođene alate tipa function, možeš povezati Grok s bilo kojim API-jem ili uslugom u svojoj infrastrukturi.

Kako to funkcionira

Pozivanje funkcija prati ciklus od tri koraka:

  1. Deklaracija: U zahtjevu opisuješ svoje funkcije (naziv, opis, parametri)
  2. Poziv: Model generira poziv funkcije s odgovarajućim argumentima i pauzira generiranje
  3. Rezultat: Tvoj kod izvršava funkciju, zatim šalješ rezultat natrag modelu kako bi on mogao formulirati svoj odgovor

Deklariraj funkciju

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Book me a table for 2 people tonight at 8 PM.",
  "tools": [{
    "type": "function",
    "name": "book_restaurant",
    "description": "Books a table at a restaurant",
    "parameters": {
      "type": "object",
      "properties": {
        "restaurant_name": {
          "type": "string",
          "description": "Restaurant name"
        },
        "date": {
          "type": "string",
          "description": "Date in YYYY-MM-DD format"
        },
        "time": {
          "type": "string",
          "description": "Time in HH:MM format"
        },
        "guests": {
          "type": "integer",
          "description": "Number of guests"
        }
      },
      "required": ["date", "time", "guests"]
    }
  }]
}

Opis svake funkcije i parametra ključan je. Model ih koristi za odluku kada pozvati funkciju i kako popuniti argumente.

Primi poziv funkcije

Kada model odluči pozvati tvoju funkciju, odgovor sadrži stavku function_call:

{
  "id": "resp-xyz789",
  "status": "completed",
  "output": [{
    "type": "function_call",
    "name": "book_restaurant",
    "arguments": "{\"date\": \"2026-04-03\", \"time\": \"20:00\", \"guests\": 2}",
    "call_id": "call-abc123"
  }]
}

Polje arguments je JSON niz koji moraš parsirati. call_id identificira ovaj specifični poziv.

Vrati rezultat

Nakon izvršavanja funkcije u svom kodu, vrati rezultat:

import json

# 1. Initial request
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What's the weather like in Paris?",
    tools=[{
        "type": "function",
        "name": "get_weather",
        "description": "Retrieves current weather",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string"}
            },
            "required": ["city"]
        }
    }]
)

# 2. Check if the model wants to call a function
for item in response.output:
    if item.type == "function_call":
        args = json.loads(item.arguments)

        # 3. Execute your function
        weather_data = get_weather_from_api(args["city"])

        # 4. Return the result to the model
        final = client.responses.create(
            model="grok-4.20-0309-reasoning",
            input=[{
                "type": "function_call_output",
                "call_id": item.call_id,
                "output": json.dumps(weather_data)
            }],
            previous_response_id=response.id
        )
        print(final.output[0].content[0].text)

Najbolje prakse za opise

Model se oslanja na opise kako bi razumio tvoje funkcije. Budi precizan:

{
  "name": "search_products",
  "description": "Searches for products in the e-commerce catalog. Returns the top 10 results sorted by relevance. Supports search by name, category, or price range.",
  "parameters": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Search terms (product name, brand, keyword)"
      },
      "category": {
        "type": "string",
        "enum": ["electronics", "clothing", "home", "sports"],
        "description": "Product category to filter"
      },
      "max_price": {
        "type": "number",
        "description": "Maximum price in euros"
      }
    },
    "required": ["query"]
  }
}

Koristi enum za unaprijed definirane vrijednosti, detaljan description za svaki parametar i označi samo bitne parametre kao required.

Rukovanje greškama

Ako tvoja funkcija ne uspije, vrati grešku kao rezultat:

try:
    result = call_external_api(args)
    output = json.dumps(result)
except Exception as e:
    output = json.dumps({"error": str(e)})

final = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input=[{
        "type": "function_call_output",
        "call_id": call_id,
        "output": output
    }],
    previous_response_id=response.id
)

Model interpretira grešku i može preformulirati svoj odgovor ili pokušati drugačiji pristup.

Ključne točke

  • Prilagođene funkcije povezuju Grok s tvojim vlastitim uslugama
  • Ciklus je: deklariraj, primi poziv, izvrši, vrati rezultat
  • Opisi funkcija i parametara usmjeravaju izbor modela
  • Polje arguments je JSON niz koji treba parsirati na strani klijenta
  • Vrati greške kao rezultate kako bi se model mogao prilagoditi