Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Aktivera webbsökning i Grok API

Lektion 1 av 14 Uppdaterad 3 november 2026 Nybörjare
På denna sida
  1. Varför koppla Grok till det realtidsuppdaterade webbet
  2. Responses API: Den enda supported endpointen
  3. Flödet för exekvering i fem steg
  4. Användning med olika SDK:n
  5. Praktisk övning
  6. Viktiga punkter

Uppdaterat 2 november 2026. Baserat på xAI:s dokumentation: med xai-sdk aktiveras webbsökning via funktionen web_search() som importeras från xai_sdk.tools, inom en konversation skapad av client.chat.create; det gamla exemplet anropade client.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 attributet responses: med denna SDK går sökningen via client.chat.create(..., tools=[web_search()]), och client.responses.create() tillhör openai-SDK:n som pekar mot https://api.x.ai/v1. Exemplet för Vercel AI SDK skickade verktyg som en array och importerade inte generateText: de deklarerar dem i ett objekt, enligt xAI:s dokumentation. Koden verifierades med xai-sdk 1.21.0 och openai 3.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.

Webbsökning med Grok

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.

$5
per 1 000 anrop
5
filtrerbara domäner
0
infrastruktur att hantera
Auto
citat inkluderade

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:

  1. Analys: modellen utvärderar om frågan kräver aktuella data
  2. Beslut: den väljer att söka eller svara med sin interna kunskap
  3. Exekvering: webbsökningen körs på serversidan (du hanterar ingenting)
  4. Bearbetning: resultaten analyseras och sammanfattas
  5. 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"} i tools (openai-SDK, Responses API) eller web_search() i client.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