Tinkintos funkcijos (funkcijų kvietimas)
Šiame puslapyje
Prijunk Grok prie savo paslaugų
Serverio įrankiai (web_search, x_search, code_interpreter) yra patogūs, tačiau apriboti tik xAI paslaugomis. Naudodamas tinkintus function įrankius, gali prijungti Grok prie bet kurios API ar paslaugos savo infrastruktūroje.
Kaip tai veikia
Funkcijų kvietimas vyksta trijų žingsnių ciklu:
- Deklaravimas: Užklausoje aprašai savo funkcijas (pavadinimą, aprašymą, parametrus).
- Kvietimas: Modelis sugeneruoja funkcijos kvietimą su tinkamais argumentais ir sustabdo generavimą.
- Rezultatas: Tavo kodas įvykdo funkciją, tada siunti rezultatą atgal modeliui, kad jis galėtų suformuluoti atsakymą.
Deklaruok funkciją
{
"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"]
}
}]
}
Kiekvienos funkcijos ir parametro aprašymas yra kritiškai svarbus. Modelis jais remiasi spręsdamas, kada iškviesti funkciją ir kaip užpildyti argumentus.
Gauk funkcijos kvietimą
Kai modelis nusprendžia iškviesti tavo funkciją, atsakyme atsiranda function_call elementas:
{
"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"
}]
}
Laukas arguments yra JSON eilutė, kurią turi išanalizuoti (parse). Laukas call_id identifikuoja šį konkretų kvietimą.
Grąžink rezultatą
Įvykdęs funkciją savo kode, grąžink rezultatą:
import json
# 1. Pradinė užklausa
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. Patikrink, ar modelis nori iškviesti funkciją
for item in response.output:
if item.type == "function_call":
args = json.loads(item.arguments)
# 3. Įvykdyk savo funkciją
weather_data = get_weather_from_api(args["city"])
# 4. Grąžink rezultatą modeliui
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)
Geriausios aprašymų praktikos
Modelis remiasi aprašymais, kad suprastų tavo funkcijas. Būk tikslus:
{
"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"]
}
}
Naudok enum iš anksto apibrėžtoms reikšmėms, išsamų description kiekvienam parametrui ir pažymėk kaip required tik būtiniausius parametrus.
Klaidų apdorojimas
Jei tavo funkcija nepavyksta, grąžink klaidą kaip 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
)
Modelis interpretuoja klaidą ir gali performuluoti savo atsakymą arba pasirinkti kitą metodą.
Svarbiausi punktai
- Tinkintos funkcijos sujungia Grok su tavo pačių paslaugomis.
- Ciklas toks: deklaruok, gauk kvietimą, įvykdyk, grąžink rezultatą.
- Funkcijų ir parametrų aprašymai nukreipia modelio pasirinkimą.
- Laukas
argumentsyra JSON eilutė, kurią reikia išanalizuoti kliento pusėje. - Grąžink klaidas kaip rezultatus, kad modelis galėtų prisitaikyti.