Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Ενεργοποίηση της Αναζήτησης Ιστού στο API

Μάθημα 4 / 16 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Παρέχετε στο Grok πρόσβαση στον ιστό σε πραγματικό χρόνο
  2. Προαπαιτούμενα: Το API Απαντήσεων (Responses API)
  3. Βασική ενεργοποίηση
  4. Ενεργοποίηση με το xAI SDK (Python)
  5. Ενεργοποίηση με το OpenAI SDK
  6. Ενεργοποίηση με το Vercel AI SDK
  7. Συνδυασμός αναζήτησης ιστού με άλλα εργαλεία
  8. Βασικά σημεία

Ενημερώθηκε στις 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
5
Φιλτραρισμένοι τομείς
Αυτόματο
Παραπομπές συμπεριλαμβάνονται
$5
/ 1.000 κλήσεις

Προαπαιτούμενα: Το 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) υποστηρίζουν την Αναζήτηση Ιστού
  • Μπορείτε να ενεργοποιήσετε πολλαπλά εργαλεία ταυτόχρονα στο ίδιο αίτημα