Ενεργοποίηση της Αναζήτησης Ιστού στο API
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 2 Νοεμβρίου 2026. Με βάση την τεκμηρίωση της xAI: με το
xai-sdk, η αναζήτηση ιστού ενεργοποιείται μέσω της συνάρτησηςweb_search()που εισάγεται από τοxai_sdk.tools, μέσα σε μια συνομιλία που δημιουργείται από τοclient.chat.create· το παλιό παράδειγμα που καλούσε ταclient.tools.web_search()καιclient.responses.createδεν υπάρχει σε αυτό το SDK. Πηγή: Web Search.
Παρέχετε στο Grok πρόσβαση στον ιστό σε πραγματικό χρόνο
Η Αναζήτηση Ιστού είναι το πιο χρησιμοποιούμενο ενσωματωμένο εργαλείο στο API του Grok. Επιτρέπει στο μοντέλο να αναζητά ενημερωμένες πληροφορίες στον ιστό, γεφυρώνοντας το φυσικό όριο των δεδομένων εκπαίδευσής του. Η ενεργοποίηση είναι απλή, αλλά υπάρχουν βασικά σημεία που πρέπει να κατανοήσετε για να το χρησιμοποιήσετε αποτελεσματικά.
Προαπαιτούμενα: Το API Απαντήσεων (Responses API)
Η Αναζήτηση Ιστού είναι διαθέσιμη αποκλειστικά στο API Απαντήσεων (Responses API). Το παλιό API Ολοκληρώσεων Συνομιλίας (Chat Completions API) προσέφερε ένα σύστημα «Ζωντανής Αναζήτησης» που πλέον έχει καταργηθεί. Εάν χρησιμοποιείτε ακόμα το Chat Completions για αναζήτηση ιστού, πρέπει να μεταβείτε στο API Απαντήσεων.
Το API Απαντήσεων χρησιμοποιεί το client.responses.create() αντί για το client.chat.completions.create(). Η δομή του αιτήματος και της απόκρισης διαφέρει, αλλά τόσο το xAI SDK όσο και το OpenAI SDK τα υποστηρίζουν.
Βασική ενεργοποίηση
Ενεργοποιείτε την Αναζήτηση Ιστού προσθέτοντας ένα αντικείμενο {"type": "web_search"} στον πίνακα tools του αιτήματός σας:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Αυτό είναι ό,τι χρειάζεστε για βασική αναζήτηση ιστού. Το μοντέλο καθορίζει αυτόματα εάν θα πραγματοποιήσει αναζήτηση και διαμορφώνει το βέλτιστο ερώτημα αναζήτησης βάσει του μηνύματος του χρήστη.
Ενεργοποίηση με το 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 παρέχει τη συνάρτηση web_search(), η οποία δημιουργεί το αντικείμενο διαμόρφωσης του εργαλείου. Δέχεται επίσης τις παραμέτρους allowed_domains ή excluded_domains—έως πέντε τομείς, και ποτέ και τις δύο στο ίδιο αίτημα.
Ενεργοποίηση με το 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 λειτουργεί με το API του Grok απλώς αλλάζοντας το base_url. Η σύνταξη του εργαλείου παραμένει ίδια.
Ενεργοποίηση με το 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 χρησιμοποιεί το xai.tools.webSearch() ακολουθώντας τη σύμβαση camelCase της JavaScript.
Συνδυασμός αναζήτησης ιστού με άλλα εργαλεία
Μπορείτε να ενεργοποιήσετε πολλαπλά εργαλεία ταυτόχρονα. Το μοντέλο θα επιλέξει το καταλληλότερο ή θα τα χρησιμοποιήσει διαδοχικά:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
Σε αυτό το παράδειγμα, το μοντέλο μπορεί να αναζητήσει δεδομένα στον ιστό και στη συνέχεια να τα αναλύσει με την Εκτέλεση Κώδικα.
Βασικά σημεία
- Η Αναζήτηση Ιστού είναι διαθέσιμη αποκλειστικά στο API Απαντήσεων (Responses API)· το Chat Completions έχει καταργηθεί για αυτή τη λειτουργία
- Ενεργοποιήστε την με το
{"type": "web_search"}στον πίνακαtools - Το μοντέλο αποφασίζει αυτόματα πότε και πώς θα πραγματοποιήσει την αναζήτηση
- Όλα τα SDK (xAI, OpenAI, Vercel AI) υποστηρίζουν την Αναζήτηση Ιστού
- Μπορείτε να ενεργοποιήσετε πολλαπλά εργαλεία ταυτόχρονα στο ίδιο αίτημα