Cumasaigh Cuardach Gréasáin san API
Ar an leathanach seo
Nuashonraithe an 2 Samhain, 2026. Bunaithe ar dhoiciméadú xAI: leis an
xai-sdk, cumasaítear cuardach gréasáin tríd an bhfeidhmweb_search()a iompórtáil óxai_sdk.tools, i gcomhrá cruthaithe agclient.chat.create; ní ann don sean-sampla a ghlaonnclient.tools.web_search()agusclient.responses.createsan SDK seo. Foinse: Web Search.
Tabhair rochtain ghlan-ama ar an nGréasán do Grok
Is é Cuardach Gréasáin an uirlis chomhtháite is mó a úsáidtear in API Grok. Ligeann sé don mhúnla faisnéis nuashonraithe a chuardach ar an ngréasán, ag droicheadú teorainn nádúrtha a chuid sonraí oiliúna. Tá an gníomhachtú simplí, ach tá pointí tábhachtacha le máistreacht chun é a úsáid go héifeachtach.
Réamhriachtanais: An API Freagraí
Tá Cuardach Gréasáin ar fáil go heisiach ar an API Freagraí. Thairg an sean-API Críochnuithe Comhrá córas “Cuardach Beo” atá díobhálta anois. Má úsáideann tú Críochnuithe Comhrá fós do chuardach gréasáin, caithfidh tú aistriú go dtí an API Freagraí.
Úsáideann an API Freagraí client.responses.create() in ionad client.chat.completions.create(). Tá difríocht idir struchtúr na hiarrata agus na freagra, ach tacáíonn an t-xAI SDK agus an t-OpenAI SDK araon leo.
Gníomhachtú bunúsach
Cumasaíonn tú Cuardach Gréasáin trí oibiacht {"type": "web_search"} a chur leis an eagar tools in d’iarratas:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Sin é go léir atá uait do chuardach gréasáin bunúsach. Cinneann an múnla go huathoibríoch an ndéanfaidh sé cuardach agus déanann sé an cheist chuardaigh is fearr a fhoirmiú ó theachtaireacht an úsáideora.
Gníomhachtú leis an xAI SDK (Python)
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.20-0309-reasoning",
tools=[web_search()],
)
chat.append(user("What are the latest advancements in AI?"))
response = chat.sample()
print(response.content)
print(response.citations)
Soláthraíonn an SDK an fheidhm web_search(), a ghineann an oibiacht cumraíochta uirlise. Glacann sé freisin le allowed_domains nó excluded_domains—suas le cúig fhearann, agus riamh an dá cheann san iarratas céanna.
Gníomhachtú leis an OpenAI SDK
from openai import OpenAI
client = OpenAI(
api_key="xai-your-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest advancements in AI?",
tools=[{"type": "web_search"}]
)
Oibríonn an t-OpenAI SDK le Grok API trí base_url a athrú go simplí. Fanann comhréir na huirlise mar an gcéanna.
Gníomhachtú leis an Vercel AI SDK
import { xai } from "@ai-sdk/xai";
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "What are the latest advancements in AI?",
tools: [xai.tools.webSearch()]
});
Úsáideann an Vercel AI SDK xai.tools.webSearch() le coinbhinsiún camelCase JavaScript.
Comhcheangail cuardach gréasáin le huirlisí eile
Is féidir leat iliomad uirlisí a chumasú ag an am céanna. Roghnóidh an múnla an ceann is oiriúnaí, nó úsáidfidh sé iad go seicheamhach:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
Sa sampla seo, is féidir leis an múnla sonraí a chuardach ar an ngréasán agus ansin iad a anailísiú le Feidhmiú Cóid.
Príomhphointí
- Tá Cuardach Gréasáin ar fáil go heisiach ar an API Freagraí—tá Críochnuithe Comhrá díobhálta don ghné seo
- Cumasaigh é le
{"type": "web_search"}san eagartools - Cinneann an múnla go huathoibríoch cathain agus conas a dhéanfar cuardach
- Tacaíonn gach SDK (xAI, OpenAI, Vercel AI) le Cuardach Gréasáin
- Is féidir leat iliomad uirlisí a chumasú ag an am céanna san iarratas céanna