Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Funkcije po meri (klicanje funkcij)

Lekcija 11 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Poveži Grok s svojimi storitvami
  2. Kako deluje
  3. Deklariraj funkcijo
  4. Prejmi klic funkcije
  5. Vrni rezultat
  6. Najboljše prakse za opise
  7. Obravnava napak
  8. Ključne ugotovitve

Poveži Grok s svojimi storitvami

Strežniška orodja (web_search, x_search, code_interpreter) so uporabna, a omejena na storitve xAI. S funkcijami po meri (function) lahko povežeš Grok s poljubnim API-jem ali storitvijo v svoji infrastrukturi.

Kako deluje

Klicanje funkcij sledi tristemnemu ciklu:

  1. Deklaracija: V zahtevku opišeš svoje funkcije (ime, opis, parametri).
  2. Klic: Model ustvari klic funkcije z ustreznimi argumenti in začasno ustavi generiranje.
  3. Rezultat: Tvoja koda izvrši funkcijo, nato pa modelu pošlješ rezultat, da lahko oblikuje svoj odgovor.

Deklariraj funkcijo

{
  "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 vsake funkcije in parametra je ključen. Model jih uporabi za odločitev, kdaj poklicati funkcijo in kako izpolniti argumente.

Prejmi klic funkcije

Ko se model odloči poklicati tvojo funkcijo, odgovor vsebuje element 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 niz JSON, ki ga moraš razčleniti. call_id identificira ta specifični klic.

Vrni rezultat

Po izvršitvi funkcije v svoji kodi vrni 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)

Najboljše prakse za opise

Model se pri razumevanju tvojih funkcij zanaša na opise. Bodite natančni:

{
  "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"]
  }
}

Uporabi enum za vnaprej določene vrednosti, podroben description za vsak parameter in kot required označi le bistvene parametre.

Obravnava napak

Če tvoja funkcija odpove, vrni napako kot 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 napako interpretira in lahko preoblikuje svoj odgovor ali poskusi drugačen pristop.

Ključne ugotovitve

  • Funkcije po meri povežejo Grok s tvojimi storitvami.
  • Cikel je: deklariraj, prejmi klic, izvrši, vrni rezultat.
  • Opisi funkcij in parametrov usmerjajo izbiro modela.
  • Polje arguments je niz JSON, ki ga je treba razčleniti na strani odjemalca.
  • Napake vrni kot rezultate, da se model lahko prilagodi.