Funkcije po meri (klicanje funkcij)
Na tej strani
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:
- Deklaracija: V zahtevku opišeš svoje funkcije (ime, opis, parametri).
- Klic: Model ustvari klic funkcije z ustreznimi argumenti in začasno ustavi generiranje.
- 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
argumentsje niz JSON, ki ga je treba razčleniti na strani odjemalca. - Napake vrni kot rezultate, da se model lahko prilagodi.