Przejdź do głównej treści
Polski— Wybierz język
Menu

Włączanie wyszukiwania w sieci w API

Lekcja 4 z 16 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Zapewnij Grokowi dostęp do sieci w czasie rzeczywistym
  2. Wymagania wstępne: Responses API
  3. Podstawowa aktywacja
  4. Aktywacja z użyciem xAI SDK (Python)
  5. Aktywacja z użyciem OpenAI SDK
  6. Aktywacja z użyciem Vercel AI SDK
  7. Łączenie wyszukiwania w sieci z innymi narzędziami
  8. Kluczowe wnioski

Zaktualizowano 2 listopada 2026 r. Na podstawie dokumentacji xAI: przy użyciu xai-sdk wyszukiwanie w sieci włącza się za pomocą funkcji web_search() importowanej z xai_sdk.tools, w konwersacji utworzonej przez client.chat.create; stary przykład wywoływał client.tools.web_search() i client.responses.create, które nie istnieją w tym SDK. Źródło: Web Search.

Zapewnij Grokowi dostęp do sieci w czasie rzeczywistym

Wyszukiwanie w sieci to najczęściej używane narzędzie zintegrowane w API Grok. Pozwala modelowi szukać aktualnych informacji w internecie, przełamując naturalne ograniczenia jego danych treningowych. Aktywacja jest prosta, ale istnieje kilka kluczowych punktów, które musisz opanować, aby używać go skutecznie.

Responses
Wymagane API
5
Filtrowalne domeny
Auto
Cytaty dołączone
$5
/ 1000 wywołań

Wymagania wstępne: Responses API

Wyszukiwanie w sieci jest dostępne wyłącznie w Responses API. Stare API Chat Completions oferowało system „Live Search“, który jest obecnie przestarzały. Jeśli nadal używasz Chat Completions do wyszukiwania w sieci, musisz przeprowadzić migrację do Responses API.

Responses API używa client.responses.create() zamiast client.chat.completions.create(). Struktura żądania i odpowiedzi różni się, ale zarówno xAI SDK, jak i OpenAI SDK obsługują obie metody.

Podstawowa aktywacja

Włączasz wyszukiwanie w sieci, dodając obiekt {"type": "web_search"} do tablicy tools w swoim żądaniu:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What are the latest advancements in artificial intelligence?",
  "tools": [
    {"type": "web_search"}
  ]
}

To wszystko, czego potrzebujesz do podstawowego wyszukiwania w sieci. Model automatycznie decyduje, czy przeprowadzić wyszukiwanie, i formułuje optymalne zapytanie na podstawie wiadomości użytkownika.

Aktywacja z użyciem 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 udostępnia funkcję web_search(), która generuje obiekt konfiguracji narzędzia. Przyjmuje ona również parametry allowed_domains lub excluded_domains – do pięciu domen, ale nigdy obu jednocześnie w tym samym żądaniu.

Aktywacja z użyciem 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 współpracuje z API Grok po prostu poprzez zmianę base_url. Składnia narzędzia pozostaje identyczna.

Aktywacja z użyciem 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 używa xai.tools.webSearch() zgodnie z konwencją camelCase w JavaScript.

Łączenie wyszukiwania w sieci z innymi narzędziami

Możesz włączyć wiele narzędzi jednocześnie. Model wybierze najbardziej odpowiednie z nich lub użyje ich sekwencyjnie:

{
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

W tym przykładzie model może wyszukać dane w sieci, a następnie przeanalizować je za pomocą wykonania kodu.

Kluczowe wnioski

  • Wyszukiwanie w sieci jest dostępne wyłącznie w Responses API – Chat Completions jest przestarzałe dla tej funkcji
  • Włącz je, dodając {"type": "web_search"} do tablicy tools
  • Model automatycznie decyduje, kiedy i jak przeprowadzić wyszukiwanie
  • Wszystkie SDK (xAI, OpenAI, Vercel AI) obsługują wyszukiwanie w sieci
  • Możesz włączyć wiele narzędzi jednocześnie w tym samym żądaniu