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

Uirlisí Freastalaí agus Glaoch Feidhme

Ceacht 10 as 12 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Baitis a Shaibhriú le hUirlisí
  2. Uirlisí Taobh an Fhreastalaí
  3. Glaoch Feidhme Taobh an Chliaint
  4. Uirlisí a Chomhcheangal
  5. Teorainneacha Uirlisí Baitse
  6. Príomhphointí

An cúrsa nuashonraithe an 2 Samhain, 2026 bunaithe ar dhoiciméadú xAI: tá lascaine 20% ar mhúnlaí téacs incháilithe (ní 50%), leanann na samplaí an REST API agus an xai-sdk oifigiúil (client.batch.*; ní úsáideann Batch API xAI formáid OpenAI, ní bhaineann an OpenAI SDK leis), agus tá an Responses API chun tosaigh ar Chat Completions, pointe deiridh seanbhunaithe ag xAI. Foinse: Batch API · REST Reference · Batch Pricing.

Baitis a Shaibhriú le hUirlisí

Níl iarratais bhaitis teoranta do théacs amh. Feidhmíonn uirlisí freastalaí agus glaoch feidhme i mód neamhshioncrónach freisin, le difríocht lárnach: ritheann an chéad cheann le linn próiseála ag xAI, ach tugann an dara ceann an smacht ar ais chugat.

Uirlisí Taobh an Fhreastalaí

Ritheann uirlisí freastalaí le linn próiseála an bhaitis, díreach mar a dhéanann siad i bhfíor-am: déanann Grok glaoch ar an uirlis, faigheann sé an toradh, cuimsíonn sé é ina réasúnaíocht, agus filleann an baisc an freagra deiridh. Oibríonn siad leis an Responses API.

Cuardach Gréasáin

{"custom_id": "news-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What are the latest developments in quantum computing?"}], "tools": [{"type": "web_search"}]}}

I mód baisce, feidhmíonn cuardach gréasáin chun sonraí a shaibhriú: faisnéis a fhíorú, fíricí le déanaí a bhailiú, próifílí a chur i gcomparáid le foinsí ar líne.

Cuardach X

Déanann an uirlis x_search ceist ar phoist ar X, rud atá úsáideach chun mothúcháin faoi ábhar nó branda a rianú:

{"custom_id": "x-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What is the dominant sentiment on X regarding this product launch?"}], "tools": [{"type": "x_search"}]}}

Feidhmiú Cóid

Is féidir le Grok cód Python a scríobh agus a fheidhmiú i dtimpeallacht aonraithe. San Responses API, tugtar code_interpreter ar an uirlis (tugann an xAI SDK code_execution uirthi):

{"custom_id": "calc-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Calculate the 3-point moving average for this data: [12, 15, 18, 14, 22, 19, 25, 28, 30, 27]"}], "tools": [{"type": "code_interpreter"}]}}

Tá feidhmiú cóid ábhartha le haghaidh ríomhaireachtaí cruinne, staitisticí, agus claochluithe sonraí nach láimhseálfadh an múnla chomh hiontaofa ón gcuimhne.

Freastalaithe MCP Cianda

Ceanglaíonn an uirlis mcp Grok le freastalaí MCP cianda, arna shonrú san iarratas féin: ní gá aon chumraíocht chuntais roimh ré. Tá server_url agus server_label éigeantach; teorannaíonn allowed_tools na huirlisí nochttha, agus seolann authorization comhartha chuig an bhfreastalaí. Ní ghlactar ach le hiompar Streamable HTTP agus SSE.

{"custom_id": "mcp-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What does the xai-sdk-python repository do?"}], "tools": [{"type": "mcp", "server_label": "deepwiki", "server_url": "https://mcp.deepwiki.com/mcp"}]}}

Gan allowed_tools, instealltar gach sainmhíniú uirlise ón bhfreastalaí i gcomhthéacs an mhúnla agus gearrtar táille orthu mar chomharthaí ionchuir ar gach iarratas baisce: ar 50,000 iarratas, íocann sé as féin go tapa an liosta a theorannú.

Glaoch Feidhme Taobh an Chliaint

Is uirlis taobh an chliaint é glaoch feidhme: cruthaíonn Grok glaoch feidhme struchtúrtha, ach is é do chód féin a fheidhmíonn é. Sa bhaisc, filleann an múnla na glaonna seo ina thorthaí, le haghaidh próiseála as líne.

Sainmhínithe Feidhme

San Responses API, dearbhaigh an fheidhm go cothrom, le name, description, agus parameters ag an leibhéal barr. Cuireann tool_choice: "required" iallach ar an múnla glaoch a dhéanamh ar uirlis amháin ar a laghad, rud atá oiriúnach d’eachtarthú:

{"custom_id": "extract-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Extract the contact: Jean Dupont, 01 23 45 67 89, [email protected]"}], "tools": [{"type": "function", "name": "save_contact", "description": "Saves a contact extracted from text", "parameters": {"type": "object", "properties": {"name": {"type": "string"}, "phone": {"type": "string"}, "email": {"type": "string"}}, "required": ["name"]}}], "tool_choice": "required"}}

Torthaí a Phróiseáil

Leis an SDK, léigh glaonna feidhme i tool_calls gach tortha rathúil:

import json

for r in page.succeeded:
    for call in r.response.tool_calls:
        if call.function.name == "save_contact":
            contact = json.loads(call.function.arguments)
            save_to_database(r.batch_request_id, contact)

Tá glaoch feidhme baisce idéalach d’eachtarthú struchtúrtha: sainíonn tú an scéima sonraí, léann Grok na doiciméid agus cruthaíonn sé na glaonna, ansin próiseálann tú iad i mbaisc.

Uirlisí a Chomhcheangal

Is féidir leat iliomad uirlisí freastalaí a chomhcheangal in iarratas amháin:

{"custom_id": "multi-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Find the Bitcoin closing price for the last seven days and calculate its change"}], "tools": [{"type": "web_search"}, {"type": "code_interpreter"}]}}

Úsáideann Grok na huirlisí san ord a mheasann sé a bheith ábhartha: anseo, cuardach gréasáin chun na sonraí a fháil, ansin feidhmiú cóid chun an ríomh a dhéanamh.

Teorainneacha Uirlisí Baitse

  • Cuireann uirlisí freastalaí le ham próiseála gach iarratais, agus mar sin leis an mbaisc
  • Braitheann iarratais le cuardach ar na foinsí a fhoilsíonn ag am na próiseála, ní ag am na cur isteach
  • Ní dhéanann glaoch feidhme ach turas amháin in aghaidh an iarratais: chun leanúint ar aghaidh, cuir iarratas baisce nua isteach ina bhfuil an comhrá agus do thorthaí feidhme
  • Déanann sainmhínithe uirlise MCP gan scagadh gach iarratas ró-mhór

Príomhphointí

  • Ritheann uirlisí freastalaí (gréasán, X, cód, MCP) ag xAI le linn próiseála, tríd an Responses API
  • Déan cur síos ar fhreastalaí MCP san iarratas (server_url, server_label), gan aon chumraíocht roimh ré
  • Filleann glaoch feidhme glaonna struchtúrtha a fheidhmíonn tú taobh an chliaint
  • Éilíonn malartú il-chasadh iarratas baisce nua in aghaidh gach casadh
  • Teorannaigh na huirlisí nochttha chun íoc as a sainmhínithe ar gach iarratas a sheachaint