Φιλτράρισμα με βάση την ημερομηνία
Σε αυτήν τη σελίδα
Ορισμός του χρονικού παραθύρου αναζήτησης
Το X Search προσφέρει μια λειτουργία που δεν διαθέτει το Web Search: το φιλτράρισμα με βάση την ημερομηνία. Μπορείτε να ορίσετε μια συγκεκριμένη περίοδο ώστε να περιορίσετε τα αποτελέσματα σε αναρτήσεις που δημοσιεύθηκαν εντός αυτού του χρονικού διαστήματος. Πρόκειται για ένα ισχυρό εργαλείο για την ανάλυση τάσεων, την παρακολούθηση γεγονότων και την στοχευμένη παρακολούθηση.
Παράμετροι ημερομηνίας
Δύο παράμετροι ελέγχουν το χρονικό παράθυρο:
from_date: Ημερομηνία έναρξης της αναζήτησης (συμπεριλαμβανόμενη)to_date: Ημερομηνία λήξης της αναζήτησης (συμπεριλαμβανόμενη)
Και οι δύο είναι προαιρετικές και ανεξάρτητες. Μπορείτε να χρησιμοποιήσετε τη μία χωρίς την άλλη:
- Μόνο
from_date: όλες οι αναρτήσεις από αυτή την ημερομηνία και μετά - Μόνο
to_date: όλες οι αναρτήσεις έως αυτή την ημερομηνία - Και οι δύο μαζί: αναρτήσεις εντός του ορισμένου παραθύρου
Μορφή ημερομηνίας
Οι ημερομηνίες ακολουθούν τη μορφή ISO 8601: YYYY-MM-DD (έτος-μήνας-ημέρα).
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What were the reactions to the Grok 4 launch?",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Αυτό το ερώτημα αναζητά αποκλειστικά αναρτήσεις που δημοσιεύθηκαν τον Μάρτιο του 2026.
Σύνταξη SDK
xAI SDK (Python)
Το Python SDK δέχεται τόσο συμβολοσειρές (strings) όσο και αντικείμενα datetime:
from xai_sdk.tools import x_search
import datetime
# Χρήση συμβολοσειρών
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Χρήση αντικειμένων datetime
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
Η χρήση αντικειμένων datetime προτιμάται σε περιβάλλον παραγωγής, καθώς σας επιτρέπει να υπολογίζετε δυναμικά τις ημερομηνίες (για παράδειγμα, «τις τελευταίες 7 ημέρες»).
OpenAI SDK (Python)
tools=[{
"type": "x_search",
"from_date": "2026-01-01",
"to_date": "2026-04-01"
}]
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch({
fromDate: "2026-01-01",
toDate: "2026-04-01"
})]
Σύμβαση camelCase: fromDate και toDate.
Συνδυασμός ημερομηνιών και handles
Ο συνδυασμός του χρονικού φιλτραρίσματος με το φιλτράρισμα handles είναι ιδιαίτερα ισχυρός:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Summarize xAI's announcements this month",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xaboratory", "xaboratorydev"],
"from_date": "2026-04-01",
"to_date": "2026-04-30"
}]
)
Αυτό το ερώτημα συνδυάζει τρία φίλτρα: μόνο αναρτήσεις από επίσημους λογαριασμούς xAI και μόνο για τον Απρίλιο του 2026.
Περιπτώσεις χρήσης
Ανάλυση γεγονότων
Παρακολουθήστε τις αντιδράσεις σε πραγματικό χρόνο κατά τη διάρκεια ενός γεγονότος (συνέδριο, κυκλοφορία προϊόντος, ανακοίνωση):
# Αντιδράσεις κατά τη διάρκεια μιας κεντρικής ομιλίας
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Αυτοματοποιημένη εβδομαδιαία παρακολούθηση
Δημιουργήστε μια αυτόματη αναφορά παρακολούθησης για την περασμένη εβδομάδα:
from datetime import datetime, timedelta
today = datetime.now()
week_ago = today - timedelta(days=7)
tools=[{
"type": "x_search",
"from_date": week_ago.strftime("%Y-%m-%d"),
"to_date": today.strftime("%Y-%m-%d")
}]
Ανάλυση τάσεων
Συγκρίνετε συζητήσεις γύρω από ένα θέμα σε διαφορετικές περιόδους, πραγματοποιώντας πολλαπλά αιτήματα με διακριτά χρονικά παράθυρα.
Βέλτιστες πρακτικές
Η εμπειρία δείχνει ότι τα μικρότερα χρονικά παράθυρα αποδίδουν καλύτερα: μια περίοδος μίας έως επτά ημερών παρέχει σημαντικά πιο ακριβή αποτελέσματα από έναν ολόκληρο μήνα, όπου σημαντικές αναρτήσεις χάνονται μέσα στον όγκο των δεδομένων. Σε περιβάλλον παραγωγής, μην κωδικοποιείτε ποτέ στατικά (hardcode) αυτές τις ημερομηνίες· υπολογίζετέ τις με το datetime σε κάθε εκτέλεση. Διαφορετικά, το παράθυρο παρακολούθησης «7 ημερών» θα αναζητά διαρκώς την ίδια εβδομάδα από την στιγμή της ανάπτυξης του κώδικα. Τέλος, το χρονικό παράθυρο ορίζει μόνο το σύνολο των αποτελεσμάτων: το prompt υπαγορεύει τι θα γίνει με αυτά. Προσδιορίστε τι αναμένετε—«σύνοψη τάσεων», «αναρτήσεις με τη μεγαλύτερη αλληλεπίδραση», «σημαντικές ανακοινώσεις»—και το μοντέλο θα φιλτράρει τα αποτελέσματα αναλόγως, αντί να επιστρέφει τα πάντα.
Βασικά σημεία
from_dateκαιto_dateσε μορφή ISO 8601 (YYYY-MM-DD)- Και οι δύο παράμετροι είναι προαιρετικές και ανεξάρτητες
- Συνδυάστε τες με φιλτράρισμα handles για εξαιρετικά στοχευμένες αναζητήσεις
- Το Python SDK δέχεται τόσο συμβολοσειρές όσο και αντικείμενα
datetime - Αποκλειστικότητα του X Search—το Web Search δεν προσφέρει φιλτράρισμα χρόνου