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

Cumasú Cuardaigh Ghréasáin sa Ghrok API

Ceacht 1 as 14 Nuashonraithe 3 Samhain 2026 Doicnéir
Ar an leathanach seo
  1. Cúis le Grok a Nascadh leis an nGréasán Fíor-Ama
  2. An API Freagartha: An tAon Phointe Deiridh Tacaithe
  3. An Sruth Feidhmithe Cúig Chéim
  4. Úsáid le SDKanna Éagsúla
  5. Cleachtas Praicticiúil
  6. Príomhphointí

Nuashonraithe an 2 Samhain, 2026. Bunaithe ar dhoiciméadú xAI: leis an xai-sdk, gníomhaíonn cuardach gréasáin tríd an bhfeidhm web_search() a iompórtáil ó xai_sdk.tools, laistigh de chomhrá cruthaithe ag client.chat.create; ní raibh an sean-sampla ag glaoch ar client.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 gcliant xai-sdk, nach bhfuil aon tréith responses aige: leis an SDK seo, téann cuardach trí client.chat.create(..., tools=[web_search()]), agus baineann client.responses.create() leis an SDK openai atá dírithe ar https://api.x.ai/v1. D’fhág sampla Vercel AI SDK uirlisí mar eagar agus níor iompórtáil siad generateText: dearbhaíonn siad iad in oibiacht, mar atá i ndoiciméadú xAI. Fíoraíodh an cód le xai-sdk 1.21.0 agus openai 3.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.

Cuardach Gréasáin le Grok

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.

$5
in aghaidh gach 1,000 glao
5
feidhmchláir inchrithe
0
bonneagar le bainistiú
Uathoibríoch
luanna san áireamh

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:

  1. Anailís: déanann an tsamhail measúnú ar an gceist a bhfuil gá le sonraí le déanaí
  2. Cinneadh: roghnaíonn sí cuardach a dhéanamh nó freagairt lena cuid eolais inmheánaigh
  3. Feidhmiú: ritheann cuardach gréasáin taobh freastalaí (ní bhainistíonn tú aon rud)
  4. Próiseáil: déantar anailís ar na torthaí agus déantar iad a shintéisiú
  5. 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"} in tools (SDK openai, API Freagartha) nó web_search() in client.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