Ενεργοποίηση της Αναζήτησης Ιστού στο Grok API
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 2 Νοεμβρίου 2026. Με βάση την τεκμηρίωση της xAI: με το
xai-sdk, η αναζήτηση ιστού ενεργοποιείται μέσω της συνάρτησηςweb_search()που εισάγεται από τοxai_sdk.tools, εντός μιας συνομιλίας που δημιουργείται από τοclient.chat.create· το παλιό παράδειγμα καλούσε τοclient.tools.web_search(), το οποίο δεν υπάρχει σε αυτό το SDK. Πηγή: Web Search.
Ενημερώθηκε στις 3 Νοεμβρίου 2026. Το πρώτο παράδειγμα καλούσε το
client.responses.create()στον πελάτηxai-sdk, ο οποίος δεν διαθέτει το χαρακτηριστικόresponses: με αυτό το SDK, η αναζήτηση γίνεται μέσω τουclient.chat.create(..., tools=[web_search()]), ενώ τοclient.responses.create()ανήκει στο SDKopenaiπου δείχνει στοhttps://api.x.ai/v1. Το παράδειγμα του Vercel AI SDK περνούσε τα εργαλεία ως πίνακα και δεν εισήγαγε τοgenerateText: τα δηλώνουν σε ένα αντικείμενο, όπως στην τεκμηρίωση της xAI. Κώδικας επαληθεύτηκε μεxai-sdk1.21.0 καιopenai3.42.1. Πηγή: Web Search.
Γιατί να Συνδέσετε το Grok με τον Ιστό σε Πραγματικό Χρόνο
Τα κλασικά γλωσσικά μοντέλα λειτουργούν με γνώσεις παγωμένες στην ημερομηνία εκπαίδευσής τους. Για έναν προγραμματιστή που κατασκευάζει εφαρμογές οι οποίες απαιτούν τρέχοντα δεδομένα (τιμές μετοχών, ειδήσεις, αθλητικά αποτελέσματα, καιρός), αυτός ο περιορισμός αποτελεί απαγορευτικό παράγοντα. Το εργαλείο web_search στο Grok API λύνει αυτό το πρόβλημα, επιτρέποντας στο μοντέλο να κάνει ερωτήματα στον ιστό σε πραγματικό χρόνο, απευθείας από την κλήση API σας.

Σε αντίθεση με άλλους παρόχους που απαιτούν ενσωματώσεις τρίτων ή ξεχωριστά πρόσθετα, η xAI προσφέρει την αναζήτηση ιστού ως ενσωματωμένο εργαλείο διακομιστή. Δεν έχετε καμία υποδομή να διαχειριστείτε: το μοντέλο αποφασίζει πότε θα κάνει αναζήτηση, εκτελεί το ερώτημα και ενσωματώνει τα αποτελέσματα στην απάντησή του.
Το Responses API: Το Μοναδικό Υποστηριζόμενο Σημείο Τερματισμού
Η αναζήτηση ιστού λειτουργεί αποκλειστικά στο Responses API. Το παλιό σημείο τερματισμού Chat Completions προσέφερε την παράμετρο search_parameters, αλλά πλέον έχει καταργηθεί. Εάν μεταβαίνετε από το παλιό API, θα χρειαστεί να προσαρμόσετε τις κλήσεις σας.
Η ενεργοποίηση γίνεται προσθέτοντας το εργαλείο web_search στον πίνακα tools στο αίτημά σας:
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.5",
input="What is the weather like in Paris today?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Αυτό το παράδειγμα χρησιμοποιεί το SDK openai, το οποίο είναι συμβατό με το Responses API της xAI· το εγγενές SDK της xAI, που παρουσιάζεται παρακάτω, λειτουργεί μέσω συνομιλίας.
Αυτό είναι όλο. Το μοντέλο αναλύει την εντολή σας, καθορίζει εάν χρειάζεται νέες πληροφορίες και ενεργοποιεί την αναζήτηση αυτόματα. Δεν χρειάζεται να διαχειριστείτε βρόχο κλήσεων ή λογική υπό όρους.
Η Ροή Εκτέλεσης Πέντε Βημάτων
Όταν στέλνετε ένα αίτημα με ενεργοποιημένο το web_search, η διαδικασία ακολουθεί μια συγκεκριμένη ακολουθία:
- Ανάλυση: το μοντέλο αξιολογεί εάν η ερώτηση απαιτεί πρόσφατα δεδομένα
- Απόφαση: επιλέγει να κάνει αναζήτηση ή να απαντήσει με τις εσωτερικές του γνώσεις
- Εκτέλεση: η αναζήτηση ιστού εκτελείται στον διακομιστή (δεν διαχειρίζεστε τίποτα)
- Επεξεργασία: τα αποτελέσματα αναλύονται και συντίθενται
- Απάντηση: το τελικό κείμενο δημιουργείται με τις αντίστοιχες παραπομπές
Αυτός ο μηχανισμός σημαίνει ότι το μοντέλο μπορεί να αποφασίσει να μην κάνει αναζήτηση εάν η ερώτηση δεν το δικαιολογεί. Για παράδειγμα, η αίτηση για τον ορισμό της φωτοσύνθεσης πιθανότατα δεν θα ενεργοποιήσει αναζήτηση ιστού.
Χρήση με Διαφορετικά SDK
Το SDK της xAI παρέχει μια αφιερωμένη συνάρτηση, την web_search(), για να περαστεί στη λίστα εργαλείων συνομιλίας:
# Εγγενές SDK xAI
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.5", tools=[web_search()])
chat.append(user("Latest AI news in Europe"))
response = chat.sample()
print(response.content)
print(response.citations)
Με το SDK openai, πρόκειται για την κλήση από την αρχή του μαθήματος: client.responses.create() με base_url="https://api.x.ai/v1" και tools=[{"type": "web_search"}].
Για το Vercel AI SDK σε JavaScript:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Latest AI news in Europe",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Πρακτική Εξάσκηση
Δημιουργήστε ένα σενάριο που κάνει ερώτημα στο Grok για ένα τρέχον γεγονός της επιλογής σας. Επαληθεύστε ότι η απάντηση περιέχει πρόσφατες πληροφορίες (ημερομηνίες, γεγονότα που συνέβησαν μετά την ημερομηνία λήξης των γνώσεων του μοντέλου). Στη συνέχεια, δοκιμάστε την ίδια ερώτηση χωρίς το εργαλείο web_search για να δείτε τη διαφορά.
Βασικά σημεία
- Η αναζήτηση ιστού ενεργοποιείται με
{"type": "web_search"}στοtools(SDKopenai, Responses API) ήweb_search()στοclient.chat.create(xai-sdk) - Λειτουργεί μόνο στο Responses API (όχι στο Chat Completions)
- Το μοντέλο αποφασίζει αυτόνομα πότε χρειάζεται να κάνει αναζήτηση
- Οι παραπομπές περιλαμβάνονται αυτόματα στην απάντηση
- Το κόστος είναι 5$ ανά 1.000 κλήσεις εργαλείου, συν τα consumed tokens