Sainigh Uirlisí i JSON
Ar an leathanach seo
Ón teoiric go dtí an cleachtas
Tá tuiscint agat anois ar an gcoincheap glaonna feidhme agus ar struchtúr scéimí JSON. Tá sé in am bogadh chuig an gcur i bhfeidhm concreideach. Sa cheacht seo, foghlaimeoidh tú conas iarratas iomlán a thógáil le sainmhínithe uirlisí agus conas freagra an mhúnla a láimhseáil.
Struchtúr iarratais le huirlisí
Seo iarratas iomlán chuig API Grok le huirlis shainithe:
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.x.ai/v1"
)
tools = [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get the current weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "City name"
},
"unit": {
"type": "string",
"enum": ["celsius", "fahrenheit"],
"default": "celsius"
}
},
"required": ["city"]
}
}
}
]
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "user", "content": "What's the weather like in Paris?"}
],
tools=tools
)
Tabhair faoi deara an struchtúr neadaithe: tá eagar san oibiacht tools, agus tá type agus oibiacht function leis na sonraí i ngach eilimint.
Fíricí lárnacha cur i bhfeidhme
Láimhseáil an fhreagra tool_call
Nuair a chinneann an múnla feidhm a ghlaowh, bíonn eagar tool_calls sa fhreagra:
message = response.choices[0].message
if message.tool_calls:
for tool_call in message.tool_calls:
print(f"Function: {tool_call.function.name}")
print(f"Arguments: {tool_call.function.arguments}")
print(f"ID: {tool_call.id}")
Is teaghrán JSON é an réimse tool_call.function.arguments (ní oibiacht Python é). Caithfidh tú é a pharsáil:
import json
args = json.loads(tool_call.function.arguments)
city = args["city"]
unit = args.get("unit", "celsius")
Feidhmiú agus toradh a thabhairt ar ais
Nuair a fheidhmítear an fheidhm, seolann tú an toradh ar ais chuig an múnla i dara glao:
import json
# 1. Feidhmigh an fheidhm
weather_data = get_weather(city="Paris", unit="celsius")
# 2. Tóg na teachtaireachtaí leis an toradh
messages = [
{"role": "user", "content": "What's the weather like in Paris?"},
message, # Freagra an mhúnla le tool_calls
{
"role": "tool",
"tool_call_id": tool_call.id,
"content": json.dumps(weather_data)
}
]
# 3. Glaoigh ar an múnla arís leis an toradh
final_response = client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools
)
print(final_response.choices[0].message.content)
Caithfidh an teachtaireacht leis an ról tool na nithe seo a leanas a bheith inti:
tool_call_id: an t-aithneoir uathúil don tool_call (chun é a nascadh leis an iarratas)content: an toradh mar theaghrán JSON
Sainigh uirlisí iolracha
Is féidir leat an oiread uirlisí agus is gá a dhearbhú san eagar tools:
tools = [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get the current weather for a city",
"parameters": { ... }
}
},
{
"type": "function",
"function": {
"name": "search_restaurants",
"description": "Search for restaurants by city and cuisine type",
"parameters": { ... }
}
},
{
"type": "function",
"function": {
"name": "book_table",
"description": "Book a table at a restaurant",
"parameters": { ... }
}
}
]
Roghnaíonn an múnla go huathoibríoch an uirlis nó na huirlisí ábhartha bunaithe ar an iarratas ón úsáideoir.
Seiceáil finish_reason
Léiríonn an réimse finish_reason sa fhreagra an bhfuil an múnla tar éis a fhreagra a chríochnú nó an bhfuil sé ag fanacht le toradh uirlise:
finish_reason = response.choices[0].finish_reason
if finish_reason == "tool_calls":
# Tá an múnla ag fanacht le toradh ó uirlis amháin nó níos mó
handle_tool_calls(response)
elif finish_reason == "stop":
# Tá an múnla tar éis a fhreagra a chríochnú
print(response.choices[0].message.content)
Príomhphointí
- Bíonn
messagesagustools(sainmhínithe) san iarratas - Is teaghrán JSON atá le parsáil iad argóintí tool_call
- Seol an toradh i dteachtaireacht leis an ról
toollena n-áirítear antool_call_id - Seiceáil
finish_reasonchun a fháil amach an bhfuil an múnla ag fanacht le toradh - Is féidir leat uirlisí iolracha a dhearbhú – roghnaíonn an múnla go huathoibríoch