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

Combinação da Web e do X: Estratégias Avançadas

Aula 13 de 14 Atualizada a 30 de julho de 2026 Iniciante
Nesta página
  1. Orquestração dos dois motores de busca
  2. Estratégia 1: Complementaridade facto/reação
  3. Estratégia 2: Validação cruzada
  4. Estratégia 3: Pipeline sequencial
  5. Gestão de custos
  6. Gestão dos limites da API
  7. Prática hands-on
  8. Pontos-chave

Orquestração dos dois motores de busca

Agora que domina individualmente o web_search e o x_search, o verdadeiro poder da API Grok surge quando os combina estrategicamente. Esta lição mostra-lhe como orquestrar ambas as ferramentas para criar pipelines de informação sofisticados, mantendo simultaneamente os custos e limites sob controlo.

$5
/ 1,000 tool calls
2x
tools per request
Multi
invocations possible
Auto
selection by the model

Estratégia 1: Complementaridade facto/reação

A combinação mais natural utiliza a Web para factos e o X para reações. O modelo escolhe a ferramenta adequada com base na natureza da informação procurada:

response = client.responses.create(
    model="grok-4.5",
    input="""Analyze the recent announcement of the European AI Act.

    PART 1 (web search):
    - Exact content of the new regulation
    - Effective dates and obligations
    - Companies and sectors affected

    PART 2 (X search):
    - Reactions from tech companies
    - Expert criticism and support
    - Perceived community impact

    SYNTHESIS: convergences and divergences
    between official facts and public perception.""",
    tools=[
        {"type": "web_search"},
        {"type": "x_search"}
    ]
)

Estratégia 2: Validação cruzada

Utilize ambas as fontes para validar informações. Se a Web e o X convergirem, a confiança aumenta:

response = client.responses.create(
    model="grok-4.5",
    input="""I'm hearing that [Company X] is preparing
    massive layoffs.

    Verify this information:
    1. Web search: press articles, press releases
    2. X search: employee posts, insiders

    Assess credibility (1-10) by cross-referencing sources.
    Explicitly state whether both channels converge.""",
    tools=[
        {"type": "web_search"},
        {"type": "x_search"}
    ]
)

Estratégia 3: Pipeline sequencial

Por vezes, fazer duas chamadas separadas é mais eficiente do que uma única chamada combinada. Isto dá-lhe mais controlo sobre os parâmetros de cada pesquisa:

# Step 1: web collection with strict filtering
web_result = client.responses.create(
    model="grok-4.5",
    input="Latest advances in quantum computing",
    tools=[{
        "type": "web_search",
        "allowed_domains": ["arxiv.org", "nature.com", "science.org"]
    }]
)

# Step 2: X reactions filtered by handles
x_result = client.responses.create(
    model="grok-4.5",
    input=f"""Taking these advances into account:
    {web_result.output_text[:500]}

    What are researchers' reactions on X?""",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "PeterShor_MIT",
            "ScottAaronson"
        ]
    }]
)

Gestão de custos

Cada invocação de ferramenta custa $0.005, independentemente do número de resultados. Quando o modelo utiliza ambas as ferramentas na mesma chamada, o custo duplica. Se o modelo chamar uma ferramenta várias vezes (por exemplo, duas pesquisas na Web sucessivas para refinar), cada chamada é faturada:

# Minimum cost: 1 tool x 1 invocation = $0.005
tools=[{"type": "web_search"}]

# Potential cost: 2 tools = $0.01 minimum
# But the model may invoke each tool
# multiple times if needed
tools=[
    {"type": "web_search"},
    {"type": "x_search"}
]

Otimização da relação qualidade/custo

  • Combine apenas quando necessário: se a pergunta for puramente factual, o web_search isolado é suficiente
  • Filtre a montante: os parâmetros de domínio e de utilizador reduzem o ruído e melhoram a relevância sem custo adicional
  • Utilize o pipeline sequencial para análises complexas: o primeiro passo informa o segundo, reduzindo pesquisas desnecessárias

Gestão dos limites da API

Limites de parâmetros

Cada ferramenta tem as suas próprias restrições. Não as misture:

  • web_search: allowed_domains OU excluded_domains (máximo de 5 para cada)
  • x_search: allowed_x_handles OU excluded_x_handles (máximo de 10 para cada) + from_date/to_date

Comportamento não determinístico

O modelo decide autonomamente quando e quantas vezes utilizar cada ferramenta. Dois pedidos idênticos podem gerar padrões de pesquisa diferentes. Se a reprodutibilidade for crítica, utilize o pipeline sequencial com pedidos direcionados.

Latência

Os pedidos com duas ferramentas são mais lentos. Preveja tempos limite adequados nas suas aplicações, especialmente se a análise de imagem ou vídeo estiver ativada.

Prática hands-on

Implemente as três estratégias (complementaridade, validação cruzada, pipeline sequencial) sobre o mesmo tema de atualidade. Compare a qualidade dos resultados, o tempo de resposta e o custo total de cada abordagem. Identifique qual a estratégia que melhor se adequa ao seu caso de uso.

Pontos-chave

  • Duas ferramentas na mesma chamada: o modelo escolhe automaticamente qual utilizar
  • A estratégia complementar (Web = factos, X = reações) é a mais comum
  • A validação cruzada reforça a confiança na informação
  • O pipeline sequencial oferece mais controlo sobre os parâmetros
  • Cada invocação de ferramenta custa $0.005, independentemente do número de resultados
  • Otimize os custos combinando apenas quando ambas as fontes trouxerem valor distinto