Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Aktivér websøgning i API'en

Lektion 4 af 16 Opdateret 2. november 2026 Udvikler
På denne side
  1. Giv Grok adgang til nettet i realtid
  2. Forudsætninger: Responses API
  3. Grundlæggende aktivering
  4. Aktivering med xAI SDK (Python)
  5. Aktivering med OpenAI SDK
  6. Aktivering med Vercel AI SDK
  7. Kombinér websøgning med andre værktøjer
  8. Vigtige pointer

Opdateret 2. november 2026. Baseret på xAI-dokumentation: Med xai-sdk aktiveres websøgning via funktionen web_search(), der importeres fra xai_sdk.tools, i en samtale oprettet af client.chat.create; det gamle eksempel kaldte client.tools.web_search() og client.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.

Responses
Påkrævet API
5
Filtrerbare domæner
Auto
Citeringer inkluderet
$5
/ 1.000 kald

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