Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Filtrar por identificadores e datas no X

Aula 6 de 14 Atualizada a 30 de julho de 2026 Iniciante
Nesta página
  1. Direcione as suas pesquisas no X com precisão
  2. Filtrar por identificadores: allowed_x_handles e excluded_x_handles
  3. Filtrar por datas: from_date e to_date
  4. Combinar filtros
  5. Construir um sistema de monitorização dinâmico
  6. Prática
  7. Pontos-chave

Direcione as suas pesquisas no X com precisão

A Pesquisa no X oferece verdadeiro valor assim que dominar os seus parâmetros de filtragem. Em vez de obter um feed bruto de publicações, pode direcionar contas específicas, definir janelas temporais precisas e excluir fontes de ruído. Estes filtros transformam uma ferramenta de pesquisa genérica num instrumento de monitorização de precisão.

Filtrar por identificadores: allowed_x_handles e excluded_x_handles

Monitorizar contas específicas

O parâmetro allowed_x_handles restringe a pesquisa às publicações das contas que listar. Pode direcionar até 10 identificadores simultaneamente:

response = client.responses.create(
    model="grok-4.5",
    input="Summary of recent announcements from these tech accounts",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "elonmusk",
            "sama",
            "demishassabis",
            "ylecun"
        ]
    }]
)

Excluir contas ruidosas

O parâmetro excluded_x_handles funciona de forma inversa. Permite todas as contas exceto as que especificar. Útil para eliminar bots ou contas com conteúdo irrelevante:

response = client.responses.create(
    model="grok-4.5",
    input="Serious discussions on AI regulation",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_spam_1", "compte_parodie"]
    }]
)

Regra de exclusividade mútua

Tal como os domínios web, allowed_x_handles e excluded_x_handles são mutuamente exclusivos. Não pode combiná-los numa única chamada. O limite é de 10 identificadores por parâmetro, o dobro do limite para domínios web.

Filtrar por datas: from_date e to_date

Os parâmetros de tempo permitem definir uma janela de pesquisa precisa no formato ISO 8601 (AAAA-MM-DD):

response = client.responses.create(
    model="grok-4.5",
    input="Reactions to the Grok 4.5 announcement",
    tools=[{
        "type": "x_search",
        "from_date": "2026-03-01",
        "to_date": "2026-03-15"
    }]
)

Estes filtros são particularmente úteis para:

  • Analisar o impacto de um evento: definir o período em torno do evento
  • Comparar o sentimento antes/depois: executar duas consultas com janelas diferentes
  • Evitar ruído antigo: focar em discussões recentes

Utilização com o SDK nativo de Python

O SDK xAI aceita objetos Python datetime além de cadeias ISO:

from xai_sdk.tools import x_search
from datetime import datetime

response = client.chat.create(
    model="grok-4.5",
    tools=[x_search(
        from_date=datetime(2026, 3, 1),
        to_date=datetime(2026, 3, 31)
    )]
)

Convenção camelCase em JavaScript

O SDK Vercel AI utiliza a convenção camelCase para os nomes dos parâmetros:

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk"],
  fromDate: "2026-03-01",
  toDate: "2026-03-31"
})]

Combinar filtros

Pode combinar identificadores e datas numa única chamada para máxima precisão:

response = client.responses.create(
    model="grok-4.5",
    input="What did Sam Altman say about GPT-5 in March 2026?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["sama"],
        "from_date": "2026-03-01",
        "to_date": "2026-03-31"
    }]
)

Construir um sistema de monitorização dinâmico

Ao combinar estes filtros programaticamente, pode construir uma ferramenta de monitorização configurável:

def create_x_monitor(handles, days_back=7):
    from datetime import datetime, timedelta
    today = datetime.now()
    start = (today - timedelta(days=days_back)).strftime("%Y-%m-%d")

    return {
        "type": "x_search",
        "allowed_x_handles": handles,
        "from_date": start,
        "to_date": today.strftime("%Y-%m-%d")
    }

# Monitorizar líderes de IA durante a semana
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Prática

Configure uma pesquisa direcionada no X para 3 a 5 contas influentes no seu setor. Defina uma janela temporal de uma semana e compare os resultados com uma pesquisa sem filtros de identificador. Meça a diferença de relevância.

Pontos-chave

  • allowed_x_handles e excluded_x_handles filtram por conta (máximo de 10 cada)
  • Ambos os parâmetros de identificador são mutuamente exclusivos
  • from_date e to_date definem a janela temporal no formato AAAA-MM-DD
  • As datas podem ser combinadas com filtros de identificador
  • O SDK de Python aceita objetos datetime, o SDK de JavaScript usa camelCase
  • Estes filtros transformam a Pesquisa no X de uma ferramenta genérica num instrumento de monitorização direcionado