Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

A webes keresés engedélyezése az API-ban

4. lecke 16 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Valós idejű webes hozzáférés biztosítása Grok számára
  2. Előfeltételek: A Responses API
  3. Alapvető aktiválás
  4. Aktiválás az xAI SDK-val (Python)
  5. Aktiválás az OpenAI SDK-val
  6. Aktiválás a Vercel AI SDK-val
  7. A webes keresés kombinálása egyéb eszközökkel
  8. Főbb megállapítások

Frissítve: 2026. november 2. Az xAI dokumentációja alapján: az xai-sdk használatával a webes keresés a client.chat.create által létrehozott beszélgetésben a xai_sdk.tools modulból importált web_search() függvénnyel engedélyezhető; a régi példa a client.tools.web_search() és a client.responses.create hívásokat tartalmazta, amelyek ebben az SDK-ban nem léteznek. Forrás: Web Search.

Valós idejű webes hozzáférés biztosítása Grok számára

A Webes keresés a Grok API leggyakrabban használt integrált eszköze. Lehetővé teszi a modell számára, hogy naprakész információkat keressen a weben, áthidalva ezzel a tanítási adatainak természetes korlátait. Az aktiválás egyszerű, de van néhány kulcsfontosságú szempont, amelyet elsajátítasz a hatékony használathoz.

Responses
Szükséges API
5
Szűrhető domainek
Automatikus
Idézetek benne
$5
/ 1000 hívás

Előfeltételek: A Responses API

A Webes keresés kizárólag a Responses API-n érhető el. A régi Chat Completions API egy „Live Search“ rendszert kínált, amely mára elavult. Ha még mindig a Chat Completionst használod webes keresésre, át kell térned a Responses API-ra.

A Responses API a client.chat.completions.create() helyett a client.responses.create() metódust használja. A kérés és a válasz szerkezete eltér, de mind az xAI SDK, mind az OpenAI SDK támogatja őket.

Alapvető aktiválás

A Webes keresést úgy engedélyezed, hogy hozzáadsz egy {"type": "web_search"} objektumot a kérésed tools tömbjéhez:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What are the latest advancements in artificial intelligence?",
  "tools": [
    {"type": "web_search"}
  ]
}

Ennyi szükséges az alapvető webes kereséshez. A modell automatikusan eldönti, hogy végezzen-e keresést, és a felhasználói üzenet alapján megfogalmazza az optimális keresési lekérdezést.

Aktiválás az xAI SDK-val (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)

Az SDK biztosítja a web_search() függvényt, amely generálja az eszköz konfigurációs objektumát. Elfogadja az allowed_domains vagy az excluded_domains paramétereket is – legfeljebb öt domainet, és soha nem mindkettőt ugyanabban a kérésben.

Aktiválás az OpenAI SDK-val

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"}]
)

Az OpenAI SDK a Grok API-val úgy működik, hogy egyszerűen megváltoztatod a base_url értéket. Az eszköz szintaxisa változatlan marad.

Aktiválás a Vercel AI SDK-val

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()]
});

A Vercel AI SDK az xai.tools.webSearch() függvényt használja, követve a JavaScript camelCase konvencióját.

A webes keresés kombinálása egyéb eszközökkel

Több eszközt is engedélyezhetsz egyszerre. A modell kiválasztja a legmegfelelőbbet, vagy sorrendben használja őket:

{
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

Ebben a példában a modell képes adatokat keresni a weben, majd elemezni azokat a Kódfuttatás segítségével.

Főbb megállapítások

  • A Webes keresés kizárólag a Responses API-n érhető el – a Chat Completions elavult ehhez a funkcióhoz
  • Engedélyezd a {"type": "web_search"} hozzáadásával a tools tömbhöz
  • A modell automatikusan eldönti, mikor és hogyan keressen
  • Minden SDK (xAI, OpenAI, Vercel AI) támogatja a Webes keresést
  • Ugyanabban a kérésben több eszközt is engedélyezhetsz egyszerre