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

Filtrar Domínios na Pesquisa Web

Aula 2 de 14 Atualizada a 30 de julho de 2026 Iniciante
Nesta página
  1. Controlar Fontes para Resultados Fiáveis
  2. Os Dois Modos de Filtragem
  3. A Regra de Exclusividade Mútua
  4. Limite de Cinco Domínios
  5. Casos de Uso Práticos
  6. Estratégia de Filtragem Dinâmica
  7. Prática Guiada
  8. Pontos-chave

Controlar Fontes para Resultados Fiáveis

Quando integra a pesquisa web numa aplicação empresarial, não quer que o modelo recolha informações de qualquer lugar. Um chatbot jurídico precisa de consultar fontes oficiais, um assistente médico deve limitar-se a publicações científicas e uma ferramenta de monitorização tecnológica deve visar sites de referência.

A API do Grok oferece dois parâmetros de filtragem para controlar as fontes: allowed_domains e excluded_domains. Estes parâmetros conferem-lhe um controlo granular sobre o âmbito da pesquisa.

Os Dois Modos de Filtragem

Lista de Permissões: allowed_domains

Este parâmetro restringe a pesquisa apenas aos domínios que especificar. O modelo não consultará nenhum outro site:

response = client.responses.create(
    model="grok-4.5",
    input="What are the latest advancements in AI?",
    tools=[{
        "type": "web_search",
        "allowed_domains": ["arxiv.org", "nature.com", "science.org"]
    }]
)

Lista de Exclusão: excluded_domains

Este parâmetro permite todas as fontes exceto as que listar. Útil para excluir sites pouco fiáveis ou concorrentes:

response = client.responses.create(
    model="grok-4.5",
    input="SaaS market analysis in France",
    tools=[{
        "type": "web_search",
        "excluded_domains": ["reddit.com", "quora.com"]
    }]
)

A Regra de Exclusividade Mútua

Os parâmetros allowed_domains e excluded_domains são mutuamente exclusivos. Não pode utilizar ambos simultaneamente numa única chamada. Se tentar combiná-los, a API devolverá um erro.

Escolha a sua estratégia com base no caso de uso:

  • Lista de permissões (allowed_domains): quando sabe exatamente quais as fontes fiáveis e todo o resto é suspeito
  • Lista de exclusão (excluded_domains): quando a maioria das fontes é aceitável, mas algumas colocam problemas

Limite de Cinco Domínios

Cada parâmetro aceita um máximo de 5 domínios. Esta restrição obriga-o a priorizar as suas fontes. Se precisar de abranger mais sites, considere fazer várias chamadas com listas diferentes ou utilize a lista de exclusão para bloquear os poucos domínios problemáticos.

Sintaxe do Domínio

Especifique os domínios sem protocolo nem barra final:

# Correto
"allowed_domains": ["arxiv.org", "nature.com"]

# Incorreto
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]

Casos de Uso Práticos

Assistente de Investigação Científica

tools=[{
    "type": "web_search",
    "allowed_domains": [
        "arxiv.org",
        "pubmed.ncbi.nlm.nih.gov",
        "scholar.google.com",
        "nature.com",
        "science.org"
    ]
}]

Monitorização Regulamentar Europeia

tools=[{
    "type": "web_search",
    "allowed_domains": [
        "eur-lex.europa.eu",
        "legifrance.gouv.fr",
        "cnil.fr",
        "ec.europa.eu"
    ]
}]

Chatbot Empresarial Sem Redes Sociais

tools=[{
    "type": "web_search",
    "excluded_domains": [
        "twitter.com",
        "facebook.com",
        "reddit.com",
        "tiktok.com"
    ]
}]

Estratégia de Filtragem Dinâmica

Numa aplicação real, pode adaptar a filtragem com base no contexto do pedido do utilizador:

def get_search_config(category):
    configs = {
        "legal": {
            "allowed_domains": ["legifrance.gouv.fr", "eur-lex.europa.eu"]
        },
        "tech": {
            "excluded_domains": ["pinterest.com", "quora.com"]
        },
        "general": {}
    }
    return configs.get(category, {})

search_params = get_search_config(user_category)
tools = [{"type": "web_search", **search_params}]

Prática Guiada

Crie um assistente especializado num domínio à sua escolha (jurídico, científico, tecnológico). Configure a filtragem de domínios adequada e teste-a com várias perguntas. Compare os resultados obtidos com e sem filtragem para medir o impacto na relevância da resposta.

Pontos-chave

  • allowed_domains restringe a pesquisa a uma lista de sites permitidos
  • excluded_domains exclui sites específicos da pesquisa
  • Ambos os parâmetros são mutuamente exclusivos: apenas um por chamada
  • Máximo de 5 domínios por parâmetro
  • Especifique os domínios sem protocolo (arxiv.org, e não https://arxiv.org)
  • Adapte a estratégia ao caso de uso: lista de permissões para domínios sensíveis, lista de exclusão para filtragem ligeira