Aktivera webbsökning i API:et
På denna sida
Uppdaterat den 2 november 2026. Baserat på xAI:s dokumentation: med
xai-sdkaktiveras webbsökning via funktionenweb_search()som importeras frånxai_sdk.tools, i en konversation skapad avclient.chat.create; det gamla exemplet kalladeclient.tools.web_search()ochclient.responses.create, vilka inte finns i denna SDK. Källa: Web Search.
Ge Grok åtkomst till webben i realtid
Webbsökning är det mest använda integrerade verktyget i Grok API. Det låter modellen söka efter aktuell information på webben och överbryggar därmed den naturliga begränsningen hos dess träningsdata. Aktiveringen är enkel, men det finns viktiga punkter att behärska för att använda det effektivt.
Förutsättningar: Responses API
Webbsökning är endast tillgängligt via Responses API. Det gamla Chat Completions API:et erbjöd ett system för «Live Search» som nu är avskrivet. Om du fortfarande använder Chat Completions för webbsökning måste du migrera till Responses API.
Responses API använder client.responses.create() istället för client.chat.completions.create(). Strukturen för begäran och svar skiljer sig åt, men både xAI SDK och OpenAI SDK stöder dem.
Grundläggande aktivering
Du aktiverar webbsökning genom att lägga till ett {"type": "web_search"}-objekt i tools-arrayen i din begäran:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Det är allt du behöver för grundläggande webbsökning. Modellen avgör automatiskt om en sökning ska utföras och formulerar den optimala sökfrågan baserat på användarens meddelande.
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:t tillhandahåller funktionen web_search(), som genererar konfigurationsobjektet för verktyget. Den accepterar även allowed_domains eller excluded_domains – upp till fem domäner, och aldrig båda i samma begäran.
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 fungerar med Grok API genom att helt enkelt ändra base_url. Syntaxen för verktyget förblir 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 använder xai.tools.webSearch() med konventionen camelCase för JavaScript.
Kombinera webbsökning med andra verktyg
Du kan aktivera flera verktyg samtidigt. Modellen väljer det mest lämpliga eller använder dem sekventiellt:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
I detta exempel kan modellen söka efter data på webben och sedan analysera dem med kodexekvering.
Viktiga punkter
- Webbsökning är endast tillgängligt via Responses API – Chat Completions är avskrivet för denna funktion
- Aktivera det med
{"type": "web_search"}itools-arrayen - Modellen avgör automatiskt när och hur sökningen ska utföras
- Alla SDK:n (xAI, OpenAI, Vercel AI) stöder webbsökning
- Du kan aktivera flera verktyg samtidigt i samma begäran