Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Sainigh Uirlisí i JSON

Ceacht 4 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Ón teoiric go dtí an cleachtas
  2. Struchtúr iarratais le huirlisí
  3. Fíricí lárnacha cur i bhfeidhme
  4. Láimhseáil an fhreagra tool_call
  5. Feidhmiú agus toradh a thabhairt ar ais
  6. Sainigh uirlisí iolracha
  7. Seiceáil finish_reason
  8. Príomhphointí

Ó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

200
Uasmhéid uirlisí in aghaidh an iarratais
6
Cineálacha JSON a dtacaítear leo
3
SDKanna comhoiriúnacha
1
Iarratas = an sruth iomlán

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 messages agus tools (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 tool lena n-áirítear an tool_call_id
  • Seiceáil finish_reason chun 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