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

Cumasaigh Cuardach Gréasáin san API

Ceacht 4 as 16 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Tabhair rochtain ghlan-ama ar an nGréasán do Grok
  2. Réamhriachtanais: An API Freagraí
  3. Gníomhachtú bunúsach
  4. Gníomhachtú leis an xAI SDK (Python)
  5. Gníomhachtú leis an OpenAI SDK
  6. Gníomhachtú leis an Vercel AI SDK
  7. Comhcheangail cuardach gréasáin le huirlisí eile
  8. Príomhphointí

Nuashonraithe an 2 Samhain, 2026. Bunaithe ar dhoiciméadú xAI: leis an xai-sdk, cumasaítear cuardach gréasáin tríd an bhfeidhm web_search() a iompórtáil ó xai_sdk.tools, i gcomhrá cruthaithe ag client.chat.create; ní ann don sean-sampla a ghlaonn client.tools.web_search() agus client.responses.create san 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.

Freagraí
API Riachtanach
5
Fearainn in-scagtha
Uathoibríoch
Luaanna san áireamh
$5
/ 1,000 glao

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 eagar tools
  • 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