Aktivera webbsökning i Grok API
På denna sida
Uppdaterat 2 november 2026. Baserat på xAI:s dokumentation: med
xai-sdkaktiveras webbsökning via funktionenweb_search()som importeras frånxai_sdk.tools, inom en konversation skapad avclient.chat.create; det gamla exemplet anropadeclient.tools.web_search(), vilket inte finns i denna SDK. Källa: Web Search.
Uppdaterat 3 november 2026. Det första exemplet anropade
client.responses.create()påxai-sdk-klienten, vilken saknar attributetresponses: med denna SDK går sökningen viaclient.chat.create(..., tools=[web_search()]), ochclient.responses.create()tillhöropenai-SDK:n som pekar mothttps://api.x.ai/v1. Exemplet för Vercel AI SDK skickade verktyg som en array och importerade integenerateText: de deklarerar dem i ett objekt, enligt xAI:s dokumentation. Koden verifierades medxai-sdk1.21.0 ochopenai3.42.1. Källa: Web Search.
Varför koppla Grok till det realtidsuppdaterade webbet
Klassiska språkmodeller arbetar med kunskap som frös vid deras träningsdatum. För dig som utvecklare som bygger applikationer som kräver aktuella data (aktiekurser, nyheter, sportresultat, väder) är denna begränsning ett avgörande hinder. Verktyget web_search i Grok API löser detta problem genom att låta modellen fråga webben i realtid, direkt från ditt API-anrop.

Till skillnad från andra leverantörer som kräver tredjepartsintegrationer eller separata plugin-program, erbjuder xAI webbsökning som ett inbyggt server-side-verktyg. Du behöver inte hantera någon infrastruktur: modellen avgör när den ska söka, kör frågan och integrerar resultaten i sitt svar.
Responses API: Den enda supported endpointen
Webbsökning fungerar uteslutande på Responses API. Den gamla endpointen för Chat Completions erbjöd en parameter search_parameters, men den är nu avskriven. Om du migrerar från det gamla API:t måste du anpassa dina anrop.
Aktiveringen sker genom att lägga till verktyget web_search i arrayen tools i din begäran:
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="What is the weather like in Paris today?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Detta exempel använder openai-SDK:n, som är kompatibel med xAI:s Responses API; den natives xAI-SDK:n, som presenteras nedan, arbetar via en konversation.
Det var allt. Modellen analyserar din prompt, avgör om den behöver färsk information och utlöser sökningen automatiskt. Du behöver inte hantera någon anropsslinga eller villkorslogik.
Flödet för exekvering i fem steg
När du skickar en begäran med web_search aktiverat följer processen en specifik sekvens:
- Analys: modellen utvärderar om frågan kräver aktuella data
- Beslut: den väljer att söka eller svara med sin interna kunskap
- Exekvering: webbsökningen körs på serversidan (du hanterar ingenting)
- Bearbetning: resultaten analyseras och sammanfattas
- Svar: den slutgiltiga texten genereras med tillhörande citat
Denna mekanism innebär att modellen kan besluta att inte söka om frågan inte motiverar det. Att exempelvis fråga efter definitionen av fotosyntes kommer sannolikt inte att utlösa en webbsökning.
Användning med olika SDK:n
xAI SDK tillhandahåller en dedikerad funktion, web_search(), att skicka in i konversationens verktygslista:
# Native xAI SDK
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("Latest AI news in Europe"))
response = chat.sample()
print(response.content)
print(response.citations)
Med openai-SDK:n är det anropet från början av lektionen: client.responses.create() med base_url="https://api.x.ai/v1" och tools=[{"type": "web_search"}].
För 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: "Latest AI news in Europe",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Praktisk övning
Skapa ett skript som frågar Grok om en aktuell händelse du väljer själv. Kontrollera att svaret innehåller aktuell information (datum, händelser som inträffat efter modellens cutoff-datum). Försök sedan med samma fråga utan verktyget web_search för att se skillnaden.
Viktiga punkter
- Webbsökning aktiveras med
{"type": "web_search"}itools(openai-SDK, Responses API) ellerweb_search()iclient.chat.create(xai-sdk) - Det fungerar endast på Responses API (inte Chat Completions)
- Modellen beslutar självständigt när den behöver söka
- Citat inkluderas automatiskt i svaret
- Kostnaden är $5 per 1 000 verktygsanrop, plus förbrukade tokens