Feidhmeanna saincheaptha (glaoch feidhme)
Ar an leathanach seo
Grok a nascadh le do sheirbhísí féin
Tá uirlisí freastalaí (web_search, x_search, code_interpreter) úsáideach ach teoranta do sheirbhísí xAI. Le huirlisí function saincheaptha, is féidir leat Grok a nascadh le aon API nó seirbhís i d’infreastruchtúr féin.
Conas a oibríonn sé
Leanann glaoch feidhme timthriall trí chéim:
- Dearbhú: Déanann tú cur síos ar do fheidhmeanna (ainm, cur síos, paraiméadair) sa hiarratas
- Glaoch: Gineann an tsamhail glaoch feidhme leis na hargóintí cuí agus cuireann sí stad leis an nginiúint
- Toradh: Rithfidh do chód an fheidhm, ansin seolfaidh tú an toradh ar ais chuig an tsamhail ionas gur féidir léi a freagra a fhoirmiú
Feidhm a dhearbhú
{
"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"]
}
}]
}
Tá cur síos ar gach feidhm agus paraiméadar ríthábhachtach. Úsáideann an tsamhail iad chun a chinneadh cathain a ghlaofar ar an bhfeidhm agus conas na hargóintí a líonadh.
An glaoch feidhme a fháil
Nuair a chinneann an tsamhail glaoch a chur ar d’fheidhm, beidh mír function_call sa fhreagra:
{
"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"
}]
}
Is teaghrán JSON é an réimse arguments ar chóir duit a pharsáil. Aithníonn an call_id an glaoch sonrach seo.
An toradh a thabhairt ar ais
Tar éis duit an fheidhm a rith i do chód, tabhair an toradh ar ais:
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)
Dea-chleachtais le haghaidh cur síosanna
Braitheann an tsamhail ar chur síosanna chun do fheidhmeanna a thuiscint. Bí beacht:
{
"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"]
}
}
Úsáid enum le haghaidh luachanna réamhshocraithe, description mionsonraithe do gach paraiméadar, agus marcáil ach na paraiméadair riachtanacha mar required.
Láimhseáil earráidí
Má theipeann ar d’fheidhm, tabhair an earráid ar ais mar thoradh:
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
)
Déanann an tsamhail léirmhíniú ar an earráid agus is féidir léi a freagra a athfhoirmiú nó cur chuige difriúil a thriail.
Príomhphointí
- Nascann feidhmeanna saincheaptha Grok le do sheirbhísí féin
- Is é an timthriall ná: dearbhaigh, faigh an glaoch, rith, tabhair an toradh ar ais
- Treoraíonn cur síosanna ar fheidhmeanna agus paraiméadair rogha na samhla
- Is teaghrán JSON é an réimse
argumentsle parsáil ar thaobh an chliaint - Tabhair earráidí ar ais mar thorthaí ionas gur féidir leis an tsamhail oiriúnú