Aktivér websøgning i API'en
På denne side
Opdateret 2. november 2026. Baseret på xAI-dokumentation: Med
xai-sdkaktiveres websøgning via funktionenweb_search(), der importeres fraxai_sdk.tools, i en samtale oprettet afclient.chat.create; det gamle eksempel kaldteclient.tools.web_search()ogclient.responses.create, som ikke eksisterer i dette SDK. Kilde: Web Search.
Giv Grok adgang til nettet i realtid
Websøgning er det mest brugte integrerede værktøj i Grok API’en. Det lader modellen søge efter opdaterede oplysninger på nettet og overbringer dermed den naturlige begrænsning i dens træningsdata. Aktiveringen er enkel, men der er nogle centrale punkter, du skal mestre for at bruge det effektivt.
Forudsætninger: Responses API
Websøgning er udelukkende tilgængelig på Responses API. Det gamle Chat Completions API tilbød et „Live Search”-system, som nu er udfaset. Hvis du stadig bruger Chat Completions til websøgning, skal du migrere til Responses API.
Responses API bruger client.responses.create() i stedet for client.chat.completions.create(). Strukturen for anmodning og svar er anderledes, men både xAI SDK og OpenAI SDK understøtter dem.
Grundlæggende aktivering
Du aktiverer websøgning ved at tilføje et {"type": "web_search"}-objekt til tools-arrayet i din anmodning:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Det er alt, hvad du behøver til grundlæggende websøgning. Modellen afgør automatisk, om den skal udføre en søgning, og formulerer den optimale søgeforespørgsel ud fra brugerens besked.
Aktivering med 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)
SDK’et leverer funktionen web_search(), som genererer konfigurationsobjektet for værktøjet. Den accepterer også allowed_domains eller excluded_domains – op til fem domæner, og aldrig begge dele i samme anmodning.
Aktivering med 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"}]
)
OpenAI SDK fungerer med Grok API’en ved blot at ændre base_url. Syntaksen for værktøjet forbliver identisk.
Aktivering med 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()]
});
Vercel AI SDK bruger xai.tools.webSearch() med JavaScripts camelCase-konvention.
Kombinér websøgning med andre værktøjer
Du kan aktivere flere værktøjer samtidigt. Modellen vil vælge det mest passende eller bruge dem sekventielt:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
I dette eksempel kan modellen søge efter data på nettet og derefter analysere dem med Code Execution.
Vigtige pointer
- Websøgning er udelukkende tilgængelig på Responses API – Chat Completions er udfaset for denne funktion
- Aktivér det med
{"type": "web_search"}itools-arrayet - Modellen afgør automatisk, hvornår og hvordan den skal søge
- Alle SDK’er (xAI, OpenAI, Vercel AI) understøtter websøgning
- Du kan aktivere flere værktøjer samtidigt i samme anmodning