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

Φιλτράρισμα Τομέων

Μάθημα 5 / 16 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Έλεγχος των πηγών αναζήτησης
  2. Δύο αμοιβαία αποκλειόμενες παράμετροι
  3. Χρήση του allowed_domains (λευκή λίστα)
  4. Χρήση του excluded_domains (μαύρη λίστα)
  5. Σύνταξη SDK
  6. Όρια και βέλτιστες πρακτικές
  7. Βασικά σημεία

Έλεγχος των πηγών αναζήτησης

Εξ ορισμού, η Αναζήτηση Ιστού (Web Search) εξερευνά ολόκληρο τον ιστό. Αυτό λειτουργεί καλά για γενικά ερωτήματα, αλλά συχνά αποτυγχάνει σε επαγγελματικές περιπτώσεις χρήσης όπου χρειάζεστε αξιόπιστες και ελεγχόμενες πηγές. Το φιλτράρισμα τομέων σάς επιτρέπει να περιορίζετε ή να αποκλείετε συγκεκριμένους ιστότοπους.

Δύο αμοιβαία αποκλειόμενες παράμετροι

Η Αναζήτηση Ιστού προσφέρει δύο παραμέτρους φιλτραρίσματος:

  • allowed_domains: περιορίζει την αναζήτηση σε καθορισμένους τομείς (λευκή λίστα)
  • excluded_domains: αποκλείει συγκεκριμένους τομείς από τα αποτελέσματα (μαύρη λίστα)

Αυτές οι δύο παράμετροι είναι αμοιβαία αποκλειόμενες. Δεν μπορείτε να χρησιμοποιήσετε και τις δύο στο ίδιο αίτημα. Αν το δοκιμάσετε, το API θα επιστρέψει σφάλμα.

Κάθε παράμετρος δέχεται έναν πίνακα με έως 5 τομείς.

Χρήση του allowed_domains (λευκή λίστα)

Χρησιμοποιήστε αυτή την παράμετρο όταν γνωρίζετε ακριβώς ποιες πηγές θέλετε να συμβουλευτείτε. Για παράδειγμα, για ακαδημαϊκή έρευνα:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest publications on transformers?",
    tools=[{
        "type": "web_search",
        "allowed_domains": ["arxiv.org", "nature.com", "science.org"]
    }]
)

Το μοντέλο αναζητά μόνο σε αυτούς τους τρεις τομείς. Αυτό διασφαλίζει ότι τα αποτελέσματα προέρχονται από επαληθευμένες επιστημονικές πηγές.

Περιπτώσεις χρήσης λευκής λίστας

  • Ακαδημαϊκή έρευνα: περιορισμός σε arxiv.org, scholar.google.com, nature.com
  • Τεχνική τεκμηρίωση: περιορισμός σε επίσημους ιστότοπους τεχνολογίας
  • Ανταγωνιστική νοημοσύνη: περιορισμός σε ιστότοπους ανταγωνιστών
  • Κανονιστική συμμόρφωση: περιορισμός σε κυβερνητικές ή ρυθμιστικές πηγές

Χρήση του excluded_domains (μαύρη λίστα)

Χρησιμοποιήστε αυτή την παράμετρο όταν θέλετε μια ευρεία αναζήτηση αλλά χρειάζεται να αποκλείσετε αναξιόπιστες ή άσχετες πηγές:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the best JavaScript frameworks in 2026?",
    tools=[{
        "type": "web_search",
        "excluded_domains": ["reddit.com", "quora.com"]
    }]
)

Το μοντέλο αναζητά σε ολόκληρο τον ιστό εκτός από τους αποκλεισμένους τομείς.

Περιπτώσεις χρήσης μαύρης λίστας

  • Αποκλεισμός φόρουμ: αποφυγή μη επαληθευμένων απόψεων
  • Αποκλεισμός συσσωρευτών: αποφυγή διπλότυπου περιεχομένου
  • Αποκλεισμός ανταγωνιστών: διατήρηση του περιεχομένου τους εκτός των αποτελεσμάτων σας
  • Αποκλεισμός paywalls: αποφυγή ιστότοπων με μη προσβάσιμο περιεχόμενο

Σύνταξη SDK

xAI SDK

tools=[client.tools.web_search(
    allowed_domains=["arxiv.org", "nature.com"]
)]

OpenAI SDK

tools=[{
    "type": "web_search",
    "excluded_domains": ["reddit.com"]
}]

Vercel AI SDK

tools: [xai.tools.webSearch({
  allowedDomains: ["arxiv.org", "nature.com"]
})]

Σημειώστε τη σύμβαση camelCase (allowedDomains) στο JavaScript SDK.

Όρια και βέλτιστες πρακτικές

Το όριο των 5 τομέων μπορεί να φαίνεται περιοριστικό. Στην πράξη, σάς αναγκάζει να είστε επιλεκτικοί με τις πηγές, γεγονός που βελτιώνει την ποιότητα των αποτελεσμάτων. Αν χρειάζεστε περισσότερη ευελιξία, μπορείτε να εκτελέσετε πολλαπλά αιτήματα με διαφορετικούς τομείς και να συγκεντρώσετε τα αποτελέσματα στην πλευρά του πελάτη (client side).

Όταν χρησιμοποιείτε το allowed_domains, βεβαιωθείτε ότι οι επιλεγμένοι τομείς καλύπτουν το ζητούμενο θέμα. Ένας υπερβολικά περιοριστικός τομέας μπορεί να εμποδίσει το μοντέλο να βρει σχετικές πληροφορίες, κάτι που θα μπορούσε να το οδηγήσει σε απάντηση χωρίς επικαιροποιημένα δεδομένα.

Βασικά σημεία

  • Διαθέσιμες δύο παράμετροι: allowed_domains (λευκή λίστα) και excluded_domains (μαύρη λίστα)
  • Αμοιβαία αποκλειόμενες: δεν μπορείτε να τις συνδυάσετε στο ίδιο αίτημα
  • Μέγιστο 5 τομείς ανά παράμετρο
  • Η λευκή λίστα είναι ιδανική για ελεγχόμενες και αξιόπιστες πηγές
  • Η μαύρη λίστα λειτουργεί για ευρείες αναζητήσεις με λίγους αποκλεισμούς