Włączanie wyszukiwania w sieci w API
Na tej stronie
Zaktualizowano 2 listopada 2026 r. Na podstawie dokumentacji xAI: przy użyciu
xai-sdkwyszukiwanie w sieci włącza się za pomocą funkcjiweb_search()importowanej zxai_sdk.tools, w konwersacji utworzonej przezclient.chat.create; stary przykład wywoływałclient.tools.web_search()iclient.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.
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 tablicytools - 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