Pielāgotas funkcijas (funkciju izsaukšana)
Šajā lapā
Savieno Grok ar saviem servisiem
Servera rīki (web_search, x_search, code_interpreter) ir noderīgi, taču aprobežojas tikai ar xAI servisiem. Izmantojot pielāgotus function rīkus, tu vari savienot Grok ar jebkuru API vai servisu savā infrastruktūrā.
Kā tas darbojas
Funkciju izsaukšana seko trīs soļu ciklam:
- Deklarēšana: Pieprasījumā tu apraksti savas funkcijas (nosaukums, apraksts, parametri).
- Izsaukšana: Modelis ģenerē funkcijas izsaukumu ar atbilstošiem argumentiem un aptur ģenerēšanu.
- Rezultāts: Tavs kods izpilda funkciju, pēc tam tu nosūti rezultātu atpakaļ modelim, lai tas varētu formulēt savu atbildi.
Deklarē 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"]
}
}]
}
Katras funkcijas un parametra apraksts ir kritiski svarīgs. Modelis tos izmanto, lai izlemtu, kad izsaukt funkciju un kā aizpildīt argumentus.
Saņem funkcijas izsaukumu
Kad modelis nolemj izsaukt tavu funkciju, atbilde satur function_call vienumu:
{
"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"
}]
}
Lauks arguments ir JSON virkne, kas tev jāparsē. Lauks call_id identificē šo konkrēto izsaukumu.
Atgriez rezultātu
Pēc funkcijas izpildes savā kodā atgriez rezultātu:
import json
# 1. Sākotnējais pieprasījums
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. Pārbaudi, vai modelis vēlas izsaukt funkciju
for item in response.output:
if item.type == "function_call":
args = json.loads(item.arguments)
# 3. Izpildi savu funkciju
weather_data = get_weather_from_api(args["city"])
# 4. Atgriez rezultātu modelim
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)
Labākā prakse aprakstiem
Modelis paļaujas uz aprakstiem, lai saprastu tavas funkcijas. Esi precīzs:
{
"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"]
}
}
Izmanto enum iepriekš definētām vērtībām, detalizētu description katram parametram un atzīmē kā required tikai būtiskos parametrus.
Kļūdu apstrāde
Ja tava funkcija neizdodas, atgriez kļūdu kā rezultātu:
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 interpretē kļūdu un var pārformulēt savu atbildi vai mēģināt citu pieeju.
Galvenās atziņas
- Pielāgotas funkcijas savieno Grok ar taviem pašu servisiem.
- Cikls ir: deklarē, saņem izsaukumu, izpildi, atgriez rezultātu.
- Funkciju un parametru apraksti virza modeļa izvēli.
- Lauks
argumentsir JSON virkne, kas jāparsē klienta pusē. - Atgriez kļūdas kā rezultātus, lai modelis varētu pielāgoties.