Премини към основното съдържание
Български— Изберете език
Меню

Филтриране по дата

Урок 10 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Дефиниране на времеви прозорец за търсене
  2. Параметри за дата
  3. Формат на датата
  4. Синтаксис на SDK
  5. Комбиниране на дати и потребителски имена (handles)
  6. Варианти на употреба
  7. Най-добри практики
  8. Ключови изводи

Дефиниране на времеви прозорец за търсене

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 не предлага филтриране по време