Филтриране по дата
На тази страница
Дефиниране на времеви прозорец за търсене
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 приема както низове, така и обекти 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)
Комбинирането на филтриране по време с филтриране по потребителски имена е особено ефективно:
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")
}]
Анализ на тенденции
Сравнете дискусиите около дадена тема в различни периоди, като направите множество заявки с различни времеви прозорци.
Най-добри практики
Опитът показва, че по-късите прозорци работят най-добре: период от един до седем дни дава значително по-точни резултати от цял месец, където важните публикации се губят в обема. В производствена среда никога не фиксирайте тези дати в кода – изчислявайте ги с datetime при всяко изпълнение. В противен случай вашият прозорец за „7-дневен мониторинг“ ще заявява една и съща седмица завинаги след внедряването. Накрая, времевият прозорец само дефинира набора от резултати: подканването (prompt) диктува какво да се прави с него. Посочете какво очаквате – „обобщение на тенденциите“, „най-ангажиращи публикации“, „основни обявления“ – и моделът ще филтрира резултатите съответно, вместо да връща всичко.
Ключови изводи
from_dateиto_dateвъв формат ISO 8601 (YYYY-MM-DD)- И двата параметъра са по избор и независими
- Комбинирайте с филтриране по потребителски имена за силно целеви търсения
- Python SDK приема както низове, така и обекти
datetime - Ексклузивно за X Search – Web Search не предлага филтриране по време