Aktivér websøgning i Grok API
På denne side
Opdateret 2. november 2026. Baseret på xAI-dokumentation: Med
xai-sdkaktiveres websøgning via funktionenweb_search(), der importeres fraxai_sdk.tools, inden for en samtale oprettet afclient.chat.create; det gamle eksempel kaldteclient.tools.web_search(), hvilket ikke findes i dette SDK. Kilde: Web Search.
Opdateret 3. november 2026. Det første eksempel kaldte
client.responses.create()påxai-sdk-klienten, som ikke har nogetresponses-attribut: Med dette SDK foregår søgning viaclient.chat.create(..., tools=[web_search()]), ogclient.responses.create()hører tilopenai-SDK’et, der peger påhttps://api.x.ai/v1. Eksemplet med Vercel AI SDK sendte værktøjer som et array og importerede ikkegenerateText: de erklærer dem i et objekt, som i xAI-dokumentationen. Kode verificeret medxai-sdk1.21.0 ogopenai3.42.1. Kilde: Web Search.
Hvorfor forbinde Grok til det realtidsopdaterede web
Klassiske sprogmodeller arbejder med viden, der er frosset fast på deres træningsdato. For en udvikler, der bygger applikationer, der kræver aktuelle data (aktiekurser, nyheder, sportsresultater, vejr), er denne begrænsning en dealbreaker. Værktøjet web_search i Grok API løser dette problem ved at lade modellen spørge nettet i realtid, direkte fra dit API-kald.

I modsætning til andre udbydere, der kræver integrationer fra tredjepart eller separate plugins, tilbyder xAI websøgning som et indbygget server-side værktøj. Du har ingen infrastruktur at administrere: modellen beslutter, hvornår den skal søge, udfører forespørgslen og integrerer resultaterne i sit svar.
Responses API: Det eneste understøttede endpoint
Websøgning fungerer udelukkende på Responses API. Det gamle Chat Completions-endpoint tilbød en parameter search_parameters, men den er nu forældet. Hvis du migrerer fra det gamle API, skal du tilpasse dine kald.
Aktivering sker ved at tilføje værktøjet web_search til arrayet tools i din anmodning:
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="Hvordan er vejret i Paris i dag?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Dette eksempel bruger openai-SDK’et, som er kompatibelt med xAI Responses API; det native xAI SDK, der præsenteres nedenfor, foregår via en samtale.
Det var det hele. Modellen analyserer din prompt, afgør, om den har brug for friske oplysninger, og udløser søgningen automatisk. Du behøver ikke administrere en kaldsløkke eller betinget logik.
Fem-trins eksekveringsflow
Når du sender en anmodning med web_search aktiveret, følger processen en specifik sekvens:
- Analyse: Modellen vurderer, om spørgsmålet kræver recente data.
- Beslutning: Den vælger at søge eller svare ud fra sin interne viden.
- Eksekvering: Websøgningen kører på serveren (du styrer ingenting).
- Behandling: Resultaterne analyseres og syntetiseres.
- Svar: Den endelige tekst genereres med tilhørende citater.
Denne mekanisme betyder, at modellen kan beslutte ikke at søge, hvis spørgsmålet ikke berettiger det. Hvis du for eksempel spørger om definitionen af fotosyntese, vil det sandsynligvis ikke udløse en websøgning.
Brug med forskellige SDK’er
xAI SDK’et leverer en dedikeret funktion, web_search(), som sendes ind i listen over samtaleværktøjer:
# 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("Seneste AI-nyheder i Europa"))
response = chat.sample()
print(response.content)
print(response.citations)
Med openai-SDK’et er det kaldet fra starten af lektionen: client.responses.create() med base_url="https://api.x.ai/v1" og tools=[{"type": "web_search"}].
For 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: "Seneste AI-nyheder i Europa",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Praktisk øvelse
Opret et script, der spørger Grok om en begivenhed i nutiden efter eget valg. Verificér, at svaret indeholder recente oplysninger (datoer, begivenheder, der finder sted efter modellens cut-off-dato). Prøv derefter det samme spørgsmål uden værktøjet web_search for at se forskellen.
Vigtige pointer
- Websøgning aktiveres med
{"type": "web_search"}itools(openaiSDK, Responses API) ellerweb_search()iclient.chat.create(xai-sdk) - Det fungerer kun på Responses API (ikke Chat Completions)
- Modellen beslutter selvstændigt, hvornår den har brug for at søge
- Citater inkluderes automatisk i svaret
- Omkostningen er $5 per 1.000 værktøjskald plus forbrugte tokens