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

Aktivera webbsökning i API:et

Lektion 4 av 16 Uppdaterad 2 november 2026 Utvecklare
På denna sida
  1. Ge Grok åtkomst till webben i realtid
  2. Förutsättningar: Responses API
  3. Grundläggande aktivering
  4. Aktivering med xAI SDK (Python)
  5. Aktivering med OpenAI SDK
  6. Aktivering med Vercel AI SDK
  7. Kombinera webbsökning med andra verktyg
  8. Viktiga punkter

Uppdaterat den 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, i en konversation skapad av client.chat.create; det gamla exemplet kallade client.tools.web_search() och client.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.

Svar
Krävt API
5
Filtrerbara domäner
Auto
Citat ingår
$5
/ 1 000 anrop

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"} i tools-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