Cumasú Cuardaigh Ghréasáin sa Ghrok API
Ar an leathanach seo
Nuashonraithe an 2 Samhain, 2026. Bunaithe ar dhoiciméadú xAI: leis an
xai-sdk, gníomhaíonn cuardach gréasáin tríd an bhfeidhmweb_search()a iompórtáil óxai_sdk.tools, laistigh de chomhrá cruthaithe agclient.chat.create; ní raibh an sean-sampla ag glaoch arclient.tools.web_search(), rud nach bhfuil ann sa SDK seo. Foinse: Cuardach Gréasáin.
Nuashonraithe an 3 Samhain, 2026. Ghlaodh an chéad sampla ar
client.responses.create()ar an gcliantxai-sdk, nach bhfuil aon tréithresponsesaige: leis an SDK seo, téann cuardach tríclient.chat.create(..., tools=[web_search()]), agus baineannclient.responses.create()leis an SDKopenaiatá dírithe arhttps://api.x.ai/v1. D’fhág sampla Vercel AI SDK uirlisí mar eagar agus níor iompórtáil siadgenerateText: dearbhaíonn siad iad in oibiacht, mar atá i ndoiciméadú xAI. Fíoraíodh an cód lexai-sdk1.21.0 agusopenai3.42.1. Foinse: Cuardach Gréasáin.
Cúis le Grok a Nascadh leis an nGréasán Fíor-Ama
Oibríonn samhlacha teanga clasaiceacha le heolas reoite ón dáta oiliúna. Do fhorbróir atá ag tógáil feidhmchlár a éilíonn sonraí reatha (praghsanna stoc, nuacht, torthaí spóirt, aimsir), is bac mór an teorainn seo. Réitíonn an uirlis web_search sa Ghrok API an fhadhb seo trí ligean don tsamhail an gréasán a fhiosrú i bhfíor-am, go díreach ó do ghlaoch API.

Murab ionann agus soláthraithe eile a éilíonn comhtháthú tríú páirtí nó breiseáin ar leith, cuireann xAI cuardach gréasáin ar fáil mar uirlis ionsuite taobh freastalaí. Níl aon bhonneagar le bainistiú agat: cinneann an tsamhail cathán is gá cuardach a dhéanamh, déanann sí an t-iarratas, agus comhtháthaíonn sí na torthaí ina freagra.
An API Freagartha: An tAon Phointe Deiridh Tacaithe
Oibríonn cuardach gréasáin go heisiach ar an API Freagartha (Responses API). Thairg an seanphointe deiridh Críochnú Comhrá (Chat Completions) paraiméadar search_parameters, ach tá sé as feidhm anois. Má tá tú ag imirce ón sean-API, beidh ort do ghlaochanna a oiriúnú.
Tarlaíonn an gníomhachtú trí an uirlis web_search a chur leis an eagar tools in d’iarratas:
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.5",
input="Conas atá an aimsir i bPáras inniu?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Úsáideann an sampla seo an SDK openai, atá comhoiriúnach le xAI Responses API; téann an SDK dúchasach xAI, a chuirtear i láthair thíos, trí chomhrá.
Sin é. Déanann an tsamhail anailís ar do leid, cinneann sí an bhfuil gá le faisnéis úr, agus spreagann sí an cuardach go huathoibríoch. Ní gá duit lúb glaotha ná loighic choinníollach a bhainistiú.
An Sruth Feidhmithe Cúig Chéim
Nuair a sheolann tú iarratas le web_search cumasaithe, leanann an próiseas seicheamh sonrach:
- Anailís: déanann an tsamhail measúnú ar an gceist a bhfuil gá le sonraí le déanaí
- Cinneadh: roghnaíonn sí cuardach a dhéanamh nó freagairt lena cuid eolais inmheánaigh
- Feidhmiú: ritheann cuardach gréasáin taobh freastalaí (ní bhainistíonn tú aon rud)
- Próiseáil: déantar anailís ar na torthaí agus déantar iad a shintéisiú
- Freagra: gintear an téacs deiridh le luanna gaolmhara
Ciallaíonn an mheicníocht seo gur féidir leis an tsamhail cinneadh gan cuardach a dhéanamh mura bhfuil údar leis an gceist. Mar shampla, is dócha nach spreagfaidh ceist faoi shainmhíniú na fótaisintéise cuardach gréasáin.
Úsáid le SDKanna Éagsúla
Soláthraíonn an xAI SDK feidhm tiomnaithe, web_search(), le cur isteach i liosta uirlisí an chomhrá:
# SDK Dúchasach xAI
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import web_search
client = Client()
chat = client.chat.create(model="grok-4.5", tools=[web_search()])
chat.append(user("Nuacht is déanaí ar IA san Eoraip"))
response = chat.sample()
print(response.content)
print(response.citations)
Leis an SDK openai, is é an glaoch ó thús na ceachta é: client.responses.create() le base_url="https://api.x.ai/v1" agus tools=[{"type": "web_search"}].
Don Vercel AI SDK i JavaScript:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Nuacht is déanaí ar IA san Eoraip",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Cleachtas Praicticiúil
Cruthaigh script a chuireann ceist ar Ghrok faoi imeacht reatha de do rogha. Fíoraigh go bhfuil faisnéis le déanaí sa fhreagra (dátaí, imeachtaí a tharla tar éis dáta gearrtha na samhla). Ansin, bain triail as an gceist chéanna gan an uirlis web_search chun an difríocht a fheiceáil.
Príomhphointí
- Gníomhaíonn cuardach gréasáin le
{"type": "web_search"}intools(SDKopenai, API Freagartha) nóweb_search()inclient.chat.create(xai-sdk) - Ní oibríonn sé ach ar an API Freagartha (ní ar Chríochnú Comhrá)
- Cinneann an tsamhail go huathrialach cathán is gá di cuardach a dhéanamh
- Cuirtear luanna san áireamh go huathoibríoch sa fhreagra
- Is é $5 an costas in aghaidh gach 1,000 glaoch uirlise, móide na tokenaí a úsáideadh